Skip to main content
  1. Posts/

Note on Using requests package

··382 words·2 mins·
Table of Contents

How to check request header and body?

When making requests, we may want to see exactly what are being requested. With requests, it is easy do access the request header and request body:

import requests

url = ""
payload = {"apple": 10, "pear": [20, 30], "img": ""}
r =, json=payload)

print(f"request headers: {r.request.headers}")
print(f"request body: {r.request.body}")

A sample output is:

request headers: {'User-Agent': 'python-requests/2.19.1', 'Accept-Encoding':
'gzip, deflate', 'Accept': '*/*', 'Connection': 'keep-alive', 'Content-Length':
'69', 'Content-Type': 'application/json'}
request body: b'{"apple": 10, "pear": [20, 30], "img": ""}'


How to encode JSON when using application/x-www-form-urlencoded?

When making requests using json data in, data=json_dict), the Content-Type is application/x-www-form-urlencoded. How is JSON encoded by requests?

In requests, this is handled by class RequestEncodingMixin, it provides _encode_params() method to convert provided into url-encoded string (JSON is converted to query string and some characters are escaped). Under the hood, it is using urllib.parse.urlencode() to encode the json data.

url = ""
payload = {"apple": 10, "pear": [20, 30], "img": ""}
r =, data=payload)

print(f"request body: {r.request.body}")

The request body is:


We can also encode JSON directly using urllib:

import urllib

payload = {"apple": 10, "pear": [20, 30], "img": ""}
print(urllib.parse.urlencode(payload, doseq=True))

The encoded string is the same.


Set up max retries

When we use requests to request a URL, we may sometimes get “max retried exceed” errors due to various causes such as unstable network or frequent request.

We can add retry features using requests to increase the chance of successful request:

from requests.adapters HTTPAdapter

from requests.packages.urllib3.util.retry import Retry

session = requests.Session()

retry_strategy = Retry(total=2)
adapter = HTTPAdapter(max_retries=retry_strategy)
session.mount("http://", adapter)
session.mount("https://", adapter)

r = session.get(url)

In the above code, we first set the parameter max_retries for HTTPAdapter, which can be a simple number or a Retry object from the urllib3 package.

Then we change the original adapter used by session by using the mount() method. The first parameter is the URL prefix for a certain adapter: when the URL matches the prefix, the corresponding adapter will be used by requests session.



Post Nested Data Structure to the Server Using Requests
··394 words·2 mins
Downloading Images Faster with requests Sessions
··457 words·3 mins
How to Download Image from URL using Python
··328 words·2 mins