Clone this repo:
  1. 083aa67 Merge pull request #5723 from bbodenmiller/patch-2 by Ian Stapleton Cordasco · 2 years, 4 months ago master
  2. f6072f1 Format c_rehash by Ben Bodenmiller · 2 years, 4 months ago
  3. c2b307d v2.25.1 by Nate Prewitt · 2 years, 5 months ago v2.25.1
  4. 6de4f10 Change docs title to requests.sessions by Shouro · 2 years, 6 months ago
  5. b223291 Merge pull request #5688 from dan-blanchard/patch-1 by Nate Prewitt · 2 years, 6 months ago


Requests is a simple, yet elegant HTTP library.

>>> import requests
>>> r = requests.get('', auth=('user', 'pass'))
>>> r.status_code
>>> r.headers['content-type']
'application/json; charset=utf8'
>>> r.encoding
>>> r.text
>>> r.json()
{'disk_usage': 368627, 'private_gists': 484, ...}

Requests allows you to send HTTP/1.1 requests extremely easily. There’s no need to manually add query strings to your URLs, or to form-encode your PUT & POST data — but nowadays, just use the json method!

Requests is one of the most downloaded Python package today, pulling in around 14M downloads / week— according to GitHub, Requests is currently depended upon by 500,000+ repositories. You may certainly put your trust in this code.

Downloads Supported Versions Contributors

Installing Requests and Supported Versions

Requests is available on PyPI:

$ python -m pip install requests

Requests officially supports Python 2.7 & 3.5+.

Supported Features & Best–Practices

Requests is ready for the demands of building robust and reliable HTTP–speaking applications, for the needs of today.

  • Keep-Alive & Connection Pooling
  • International Domains and URLs
  • Sessions with Cookie Persistence
  • Browser-style TLS/SSL Verification
  • Basic & Digest Authentication
  • Familiar dict–like Cookies
  • Automatic Content Decompression and Decoding
  • Multi-part File Uploads
  • SOCKS Proxy Support
  • Connection Timeouts
  • Streaming Downloads
  • Automatic honoring of .netrc
  • Chunked HTTP Requests

API Reference and User Guide available on Read the Docs

Read the Docs

Kenneth Reitz Python Software Foundation