reqwest 0.3.0

higher level HTTP client library


The reqwest crate provides a convenient, higher-level HTTP Client.

It handles many of the things that most people just expect an HTTP client to do for them.

  • Uses system-native TLS
  • Plain bodies, JSON, urlencoded, (TODO: multipart)
  • Customizable redirect policy
  • (TODO: Cookies)

The reqwest::Client is synchronous, making it a great fit for applications that only require a few HTTP requests, and wish to handle them synchronously. When hyper releases with asynchronous support, reqwest will be updated to use it internally, but still provide a synchronous Client, for convenience. A reqwest::async::Client will also be added.

Making a GET request

For a single request, you can use the get shortcut method.

let resp = reqwest::get("").unwrap();

If you plan to perform multiple requests, it is best to create a Client and reuse it, taking advantage of keep-alive connection pooling.

Making POST requests (or setting request bodies)

There are several ways you can set the body of a request. The basic one is by using the body() method of a RequestBuilder. This lets you set the exact raw bytes of what the body should be. It accepts various types, including String, Vec<u8>, and File. If you wish to pass a custom Reader, you can use the reqwest::Body::new() constructor.

let client = reqwest::Client::new().unwrap();
let res ="")
    .body("the exact body that is sent")


It's very common to want to send form data in a request body. This can be done with any type that can be serialized into form data.

This can be an array of tuples, or a HashMap, or a custom type that implements Serialize.

// This will POST a body of `foo=bar&baz=quux`
let params = [("foo", "bar"), ("baz", "quux")];
let client = reqwest::Client::new().unwrap();
let res ="")


There is also a json method helper on the RequestBuilder that works in a similar fashion the form method. It can take any value that can be serialized into JSON.

# use std::collections::HashMap;
// This will POST a body of `{"lang":"rust","body":"json"}`
let mut map = HashMap::new();
map.insert("lang", "rust");
map.insert("body", "json");

let client = reqwest::Client::new().unwrap();
let res ="")