Need help with requests?
Click the “chat” button below for chat support from the developer who created it, or find similar developers for support.

About the developer

psf
43.8K Stars 8.0K Forks Apache License 2.0 6.0K Commits 305 Opened issues

Description

A simple, yet elegant HTTP library.

Services available

!
?

Need anything else?

Contributors list

Requests

Requests is a simple, yet elegant HTTP library.

>>> 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
'{"type":"User"...'
>>> 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

We use cookies. If you continue to browse the site, you agree to the use of cookies. For more information on our use of cookies please see our Privacy Policy.