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

# 2,867
requests
beautiful...
python-li...
pypi
requests 43.8K requests top 1
# 12,702
Python
Ruby
requests 43.8K linter top 10
# 17,935
Node.js
PowerShel...
TypeScrip...
Less
requests 43.8K Node.js top 1000
# 23,822
HTML
requests 43.8K Python top 10
# 19,152
Scala
Rust
Python
HTML
requests 43.8K Scala top 1000
# 35,448
Lua
requests 43.8K http-client top 10
# 1,015
The Julia...
nteract
notebook
notebooks
requests 43.8K The Julia Language top 1
# 30,947
Perl
Lua
PHP
requests 43.8K Java top 10
# 493
JSON Web ...
jinja2
rust-libr...
template-...
requests 43.8K JSON Web Tokens top 100
# 55,231
requests 43.8K JavaScript top 10
# 12,998
Python
Perl
PowerShel...
C#
requests 43.8K
# 29,950
C
PHP
requests 43.8K http-client top 10
# 65,773
requests 43.8K JavaScript top 10
# 26,497
requests 43.8K React top 10
# 8,395
distribut...
distribut...
wasm
Go
requests 43.8K distributed-computing top 100
# 75,667
requests 43.8K http-client top 10
# 3,737
R
Python
Sass
Jupyter N...
requests 43.8K R top 1000
# 4,592
x64
3d-game-e...
sdl
cpp17
requests 43.8K x64 top 100
# 87,909
MATLAB
requests 43.8K reinforcement-learning top 10
# 26,672
Objective...
Swift
requests 43.8K Python top 10

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.