Requests (software)

Requests

Original author(s)	Kenneth Reitz
Developer(s)	Kenneth Reitz, Cory Benfield, Ian Stapleton Cordasco, Nate Prewitt
Initial release	(help)
Stable release	2.23.0 / 19 February 2020 (2020-02-19)
Repository	github.com/psf/requests
Written in	Python
Operating system	Cross-platform
Platform	Cross-platform
License	Apache License 2.0
Website	requests.readthedocs.io

Requests is a Python HTTP library, released under the Apache License 2.0. The goal of the project is to make HTTP requests simpler and more human-friendly. The current version is 2.23.0

Requests is an Apache2 Licensed HTTP library, written in Python, for human beings.

Python’s standard urllib2 module provides most of the HTTP capabilities you need, but the API is thoroughly broken. It was built for a different time — and a different web. It requires an enormous amount of work (even method overrides) to perform the simplest of tasks.

Things shouldn’t be this way. Not in Python.

— Project homepage

Example code

>>> import requests
>>> r = requests.get('https://api.github.com/user', auth=('user', 'pass'))
>>> r.status_code
200
>>> r.headers['content-type']
'application/json; charset=utf8'
>>> r.encoding
'utf-8'
>>> r.text # doctest: +ELLIPSIS
u'{"type":"User"...'
>>> r.json() # doctest: +ELLIPSIS
{u'private_gists': 419, u'total_private_repos': 77, ...}

External links

• Official website
• requests on GitHub