    Skip to content

      Navigation Menu

            Sign in Appearance settings
                * Platform
                        + AI CODE CREATION
                            o GitHub Copilot Write better code with AI
                            o GitHub Copilot app Direct agents from issue to merge
                            o MCP Registry Integrate external tools
                        + DEVELOPER WORKFLOWS
                            o Actions Automate any workflow
                            o Codespaces Instant dev environments
                            o Issues Plan and track work
                            o Code Review Manage code changes
                            o Code Quality Enforce quality at merge
                        + APPLICATION SECURITY
                            o GitHub Advanced Security Find and fix vulnerabilities
                            o Code security Secure your code as you build
                            o Secret protection Stop leaks before they start
                        + EXPLORE
                            o Why GitHub
                            o Documentation
                            o Blog
                            o Changelog
                            o Marketplace
                      View all features
                * Solutions
                        + BY COMPANY SIZE
                            o Enterprises
                            o Small and medium teams
                            o Startups
                            o Nonprofits
                        + BY USE CASE
                            o App Modernization
                            o DevSecOps
                            o DevOps
                            o CI/CD
                            o View all use cases
                        + BY INDUSTRY
                            o Healthcare
                            o Financial services
                            o Manufacturing
                            o Government
                            o View all industries
                      View all solutions
                * Resources
                        + EXPLORE BY TOPIC
                            o AI
                            o Software Development
                            o DevOps
                            o Security
                            o View all topics
                        + EXPLORE BY TYPE
                            o Customer stories
                            o Events & webinars
                            o Ebooks & reports
                            o Business insights
                            o GitHub Skills
                        + SUPPORT & SERVICES
                            o Documentation
                            o Customer support
                            o Community forum
                            o Trust center
                            o Partners
                      View all resources
                * Open Source
                        + COMMUNITY
                            o GitHub Sponsors Fund open source developers
                        + PROGRAMS
                            o Security Lab
                            o Maintainer Community
                            o Accelerator
                            o GitHub Stars
                            o Archive Program
                        + REPOSITORIES
                            o Topics
                            o Trending
                            o Collections
                * Enterprise
                        + ENTERPRISE SOLUTIONS
                            o Enterprise platform AI-powered developer platform
                        + AVAILABLE ADD-ONS
                            o GitHub Advanced Security Enterprise-grade security features
                            o Copilot for Business Enterprise-grade AI features
                            o Premium Support Enterprise-grade 24/7 support
              * Pricing
                Type / to search
                Sign in
              Sign up Appearance settings
      You signed in with another tab or window. Reload to refresh your session. You signed out in another tab or window. Reload to refresh your session. You switched accounts on another tab or window. Reload to refresh your session. Dismiss alert

              Uh oh!

              There was an error while loading. Please reload this page.

              psf / requests Public

                      * Uh oh!

                        There was an error while loading. Please reload this page.

              * Notifications You must be signed in to change notification settings
              * Fork 10.1k
                * Star 54.3k
          * Code
          * Issues 147
          * Pull requests 86
          * Actions
          * Wiki
          * Security and quality 4
          * Insights
          Additional navigation options
                  * Code
                  * Issues
                  * Pull requests
                  * Actions
                  * Wiki
                  * Security and quality
                  * Insights
                                              main
                                          Branches Tags
                                            Go to file
                                        Code
                                          Open more actions menu

                                        Folders and files

                                          Name                             Name                               Last commit message    Last commit date
                                            Latest commit                
                                                                         
                                                History                  
                                                                         
                                                6,489 Commits            
                                                  6,489 Commits          
                                                  .github                          .github                                                           
                                                  docs                             docs                                                              
                                                  ext                              ext                                                               
                                                  src/ requests                    src/ requests                                                     
                                                  tests                            tests                                                             
                                                  .coveragerc                      .coveragerc                                                       
                                                  .git-blame-ignore-revs           .git-blame-ignore-revs                                            
                                                  .gitignore                       .gitignore                                                        
                                                  .pre-commit-config.yaml          .pre-commit-config.yaml                                           
                                                  .readthedocs.yaml                .readthedocs.yaml                                                 
                                                  AUTHORS.rst                      AUTHORS.rst                                                       
                                                  HISTORY.md                       HISTORY.md                                                        
                                                  LICENSE                          LICENSE                                                           
                                                  MANIFEST.in                      MANIFEST.in                                                       
                                                  Makefile                         Makefile                                                          
                                                  NOTICE                           NOTICE                                                            
                                                  README.md                        README.md                                                         
                                                  pyproject.toml                   pyproject.toml                                                    
                                                  requirements-dev.txt             requirements-dev.txt                                              
                                                  setup.py                         setup.py                                                          
                                                  tox.ini                          tox.ini                                                           
                                            View all files               
                                          

                                              Repository files navigation

                                                * 
                                                * README
                                                * Code of conduct
                                                * Contributing
                                                * Apache-2.0 license
                                                * Security
                                                More items

                                                Requests

                                              Requests is a simple, yet elegant, HTTP library.

                                                >>> import requests
                                                >>> r = requests.get('https://httpbin.org/basic-auth/user/pass', auth=('user', 'pass'))
                                                >>> r.status_code
                                                200
                                                >>> r.headers['content-type']
                                                'application/json; charset=utf8'
                                                >>> r.encoding
                                                'utf-8'
                                                >>> r.text
                                                '{"authenticated": true, ...'
                                                >>> r.json()
                                                {'authenticated': True, ...}

                                              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 packages today, pulling in around 300M downloads / week — according to GitHub, Requests is currently depended upon by 4,000,000+ repositories.

                                                Installing Requests and Supported Versions

                                              Requests is available on PyPI:

                                                $ python -m pip install requests

                                              Requests officially supports Python 3.10+.

                                                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

                                                Cloning the repository

                                              When cloning the Requests repository, you may need to add the -c fetch.fsck.badTimezone=ignore flag to avoid an error about a bad commit timestamp (see this issue for more background):

                                                git clone -c fetch.fsck.badTimezone=ignore https://github.com/psf/requests.git

                                              You can also apply this setting to your global Git config:

                                                git config --global fetch.fsck.badTimezone ignore

                                        About

                                        A simple, yet elegant, HTTP library.

                                          requests.readthedocs.io/en/latest/

                                        Topics

                                          clientcookiesforhumanshttphumanspythonpython-requestsrequests

                                        Resources

                                          Readme
                                          Apache-2.0 license

                                        Code of conduct

                                          Code of conduct

                                        Contributing

                                          Contributing

                                        Security policy

                                          Security policy
                                          Activity
                                          Custom properties

                                        Stars

                                          54.3k stars

                                        Watchers

                                          1.3k watching

                                        Forks

                                          10.1k forks
                                          Report repository

                                        Releases

                                        Sponsor this project

                                        Used by

                                        Contributors

                                        Languages

    Footer

        © 2026 GitHub, Inc.

      Footer navigation

        * Terms
        * Privacy
        * Security
        * Status
        * Community
        * Docs
        * Contact
        * Manage cookies
        * Do not share my personal information
      You can’t perform that action at this time.