60 releases

0.10.8 Aug 25, 2020
0.10.7 Jul 24, 2020
0.10.6 May 29, 2020
0.10.4 Mar 4, 2020
0.1.0 Nov 10, 2016

#6 in HTTP client

Download history 112045/week @ 2020-05-30 116918/week @ 2020-06-06 113946/week @ 2020-06-13 109106/week @ 2020-06-20 105855/week @ 2020-06-27 112714/week @ 2020-07-04 105460/week @ 2020-07-11 108751/week @ 2020-07-18 114234/week @ 2020-07-25 115756/week @ 2020-08-01 112609/week @ 2020-08-08 115157/week @ 2020-08-15 123213/week @ 2020-08-22 118565/week @ 2020-08-29 111888/week @ 2020-09-05 112245/week @ 2020-09-12

476,945 downloads per month
Used in 2,174 crates (1,763 directly)

MIT/Apache

400KB
8K SLoC

reqwest

crates.io Documentation MIT/Apache-2 licensed CI

An ergonomic, batteries-included HTTP Client for Rust.

  • Plain bodies, JSON, urlencoded, multipart
  • Customizable redirect policy
  • HTTP Proxies
  • HTTPS via system-native TLS (or optionally, rustls)
  • Cookie Store
  • WASM
  • Changelog

Example

This asynchronous example uses Tokio and enables some optional features, so your Cargo.toml could look like this:

[dependencies]
reqwest = { version = "0.10", features = ["json"] }
tokio = { version = "0.2", features = ["full"] }

And then the code:

use std::collections::HashMap;

#[tokio::main]
async fn main() -> Result<(), Box<dyn std::error::Error>> {
    let resp = reqwest::get("https://httpbin.org/ip")
        .await?
        .json::<HashMap<String, String>>()
        .await?;
    println!("{:#?}", resp);
    Ok(())
}

Blocking Client

There is an optional "blocking" client API that can be enabled:

[dependencies]
reqwest = { version = "0.10", features = ["blocking", "json"] }
use std::collections::HashMap;

fn main() -> Result<(), Box<dyn std::error::Error>> {
    let resp = reqwest::blocking::get("https://httpbin.org/ip")?
        .json::<HashMap<String, String>>()?;
    println!("{:#?}", resp);
    Ok(())
}

Requirements

On Linux:

On Windows and macOS:

  • Nothing.

Reqwest uses rust-native-tls, which will use the operating system TLS framework if available, meaning Windows and macOS. On Linux, it will use OpenSSL 1.1.

License

Licensed under either of

Contribution

Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in the work by you, as defined in the Apache-2.0 license, shall be dual licensed as above, without any additional terms or conditions.

Dependencies

~2–10MB
~248K SLoC