requests  2.24.0
About: Requests is an HTTP library, written in Python, with the goal to make HTTP requests simpler and more human-friendly.
  Fossies Dox: requests-2.24.0.tar.gz  ("unofficial" and yet experimental doxygen-generated source code documentation)  

requests Documentation

Some Fossies usage hints in advance:

  1. To see the Doxygen generated documentation please click on one of the items in the steelblue colored "quick index" bar above or use the side panel at the left which displays a hierarchical tree-like index structure and is adjustable in width.
  2. If you want to search for something by keyword rather than browse for it you can use the client side search facility (using Javascript and DHTML) that provides live searching, i.e. the search results are presented and adapted as you type in the Search input field at the top right.
  3. Doxygen doesn't incorporate all member files but just a definable subset (basically the main project source code files that are written in a supported language). So to search and browse all member files you may visit the Fossies
  4. requests-2.24.0.tar.gz contents page and use the Fossies standard member browsing features (also with source code highlighting and additionally with optional code folding).

Python 3.7.4 (default, Sep 7 2019, 18:27:02) >>> import requests >>> r = requests.get('') >>> r.json()["description"] 'A simple, yet elegant HTTP library.'

This software has been designed for you, with much joy, by Kenneth Reitz & is protected by The Python Software Foundation.



Requests is an elegant and simple HTTP library for Python, built with ♥.


>>> 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 image image


Supported Features & Best–Practices

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

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

                            &, of course, rock–solid stability!

✨ 🍰 ✨            


Requests Module Installation

The recommended way to install the requests module is to simply use pipenv (or pip, of course):

$ pipenv install requests
Adding requests to Pipfile's [packages]…
✔ Installation Succeeded

Requests officially supports Python 2.7 & 3.5+.

P.S. — Documentation is available at