Login With Github

Requests User Guide

Requests is the only Non-GMO HTTP library for Python, safe for human consumption.

Note: The use of Python 3 is highly preferred over Python 2. Consider upgrading your applications and infrastructure if you find yourself still using Python 2 in production today. If you are using Python 3, congratulations — you are indeed a person of excellent taste. —Kenneth Reitz

Behold, the power of Requests:

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

See similar code, sans Requests.

Requests allows you to send organic, grass-fed HTTP/1.1 requests, without the need for manual labor. There's no need to manually add query strings to your URLs, or to form-encode your POST data. Keep-alive and HTTP connection pooling are 100% automatic, thanks to urllib3.

User Testimonials

Nike, Twitter, Spotify, Microsoft, Amazon, Lyft, BuzzFeed, Reddit, The NSA, Her Majesty's Government, Google, Twilio, Runscope, Mozilla, Heroku, PayPal, NPR, Obama for America, Transifex, Native Instruments, The Washington Post, SoundCloud, Kippt, Sony, and Federal U.S. Institutions that prefer to be unnamed claim to use Requests internally.

Armin Ronacher, creator of Flask—

Requests is the perfect example how beautiful an API can be with the right level of abstraction.

Matt DeBoard

I'm going to get Kenneth Reitz's Python requests module tattooed on my body, somehow. The whole thing.

Daniel Greenfeld

Nuked a 1200 LOC spaghetti code library with 10 lines of code thanks to Kenneth Reitz's Requests library. Today has been AWESOME.

Kenny Meyers

Python HTTP: When in doubt, or when not in doubt, use Requests. Beautiful, simple, Pythonic.

Requests is one of the most downloaded Python packages of all time, pulling in over 400,000 downloads each day. Join the party!

If your organization uses Requests internally, consider supporting the development of 3.0. Your generosity will be greatly appreciated, and help drive the project forward into the future.

Beloved Features

Requests is ready for today's web.

  • Keep-Alive & Connection Pooling
  • International Domains and URLs
  • Sessions with Cookie Persistence
  • Browser-style SSL Verification
  • Automatic Content Decoding
  • Basic/Digest Authentication
  • Elegant Key/Value Cookies
  • Automatic Decompression
  • Unicode Response Bodies
  • HTTP(S) Proxy Support
  • Multipart File Uploads
  • Streaming Downloads
  • Connection Timeouts
  • Chunked Requests
  • .netrc Support

Requests officially supports Python 2.7 & 3.4–3.7, and runs great on PyPy.

The User Guide

This part of the documentation, which is mostly prose, begins with some background information about Requests, then focuses on step-by-step instructions for getting the most out of Requests.

  • Introduction
    • Philosophy
    • Apache2 License
    • Requests License
  • Installation of Requests
    • $ pipenv install requests
    • Get the Source Code
  • Quickstart
    • Make a Request
    • Passing Parameters In URLs
    • Response Content
    • Binary Response Content
    • JSON Response Content
    • Raw Response Content
    • Custom Headers
    • More complicated POST requests
    • POST a Multipart-Encoded File
    • Response Status Codes
    • Response Headers
    • Cookies
    • Redirection and History
    • Timeouts
    • Errors and Exceptions
  • Advanced Usage
    • Session Objects
    • Request and Response Objects
    • Prepared Requests
    • SSL Cert Verification
    • Client Side Certificates
    • CA Certificates
    • Body Content Workflow
    • Keep-Alive
    • Streaming Uploads
    • Chunk-Encoded Requests
    • POST Multiple Multipart-Encoded Files
    • Event Hooks
    • Custom Authentication
    • Streaming Requests
    • Proxies
    • Compliance
    • HTTP Verbs
    • Custom Verbs
    • Link Headers
    • Transport Adapters
    • Blocking Or Non-Blocking?
    • Header Ordering
    • Timeouts
  • Authentication
    • Basic Authentication
    • Digest Authentication
    • OAuth 1 Authentication
    • OAuth 2 and OpenID Connect Authentication
    • Other Authentication
    • New Forms of Authentication

0 Comment