Requests

aid: requests
name: Requests
description: 'Requests is a simple and elegant HTTP library for Python, designed for human beings. Published under the Apache2
  license by the Python Software Foundation (PSF), it is one of the most downloaded Python packages with approximately 300
  million weekly downloads and over 4 million dependent repositories. Requests abstracts urllib3 to provide idiomatic HTTP
  method functions (get, post, put, patch, delete, head, options), persistent Sessions with connection pooling, automatic
  content decompression, TLS/SSL verification, Basic and Digest authentication, cookie persistence, streaming downloads, multipart
  file uploads, SOCKS proxy support, and configurable timeouts. Current stable version: 2.33.1 (March 2026). Supports Python
  3.10+.'
type: Index
position: Consuming
access: 3rd-Party
image: https://kinlane-images.s3.amazonaws.com/shared/apis-json/apis-json-logo.jpg
url: https://raw.githubusercontent.com/api-evangelist/requests/refs/heads/main/apis.yml
tags:
- Clients
- HTTP Client
- HTTP Library
- Open Source
- Python
- Python Software Foundation
created: '2026-03-27'
modified: '2026-05-02'
specificationVersion: '0.19'
apis:
- aid: requests:requests
  name: Requests
  description: Requests is a simple and elegant HTTP library for Python, designed for human beings. It provides a clean, human-friendly
    API for all standard HTTP methods with automatic content handling, authentication, session management, and TLS verification.
  humanURL: https://requests.readthedocs.io
  tags:
  - Clients
  - HTTP Client
  - HTTP Library
  - Open Source
  - Python
  properties:
  - type: Documentation
    url: https://requests.readthedocs.io/en/latest/
  - type: APIReference
    url: https://requests.readthedocs.io/en/latest/api/
  - type: GettingStarted
    url: https://requests.readthedocs.io/en/latest/user/quickstart/
  - type: AdvancedUsage
    url: https://requests.readthedocs.io/en/latest/user/advanced/
  - type: GitHub
    url: https://github.com/psf/requests
  - type: PyPI
    url: https://pypi.org/project/requests/
common:
- type: DomainSecurity
  url: security/requests-domain-security.yml
- type: Website
  url: https://requests.readthedocs.io
- type: Documentation
  url: https://requests.readthedocs.io/en/latest/
- type: GitHubOrganization
  url: https://github.com/psf/requests
- type: PyPI
  name: Requests on PyPI
  description: Python Package Index listing for the requests package.
  url: https://pypi.org/project/requests/
- type: JSONSchema
  name: Requests Request Schema
  description: JSON Schema describing the parameters of a Requests HTTP request call.
  url: https://raw.githubusercontent.com/api-evangelist/requests/refs/heads/main/json-schema/requests-request-schema.json
- type: JSONSchema
  name: Requests Response Schema
  description: JSON Schema describing the attributes of a requests.Response object.
  url: https://raw.githubusercontent.com/api-evangelist/requests/refs/heads/main/json-schema/requests-response-schema.json
- type: JSONStructure
  name: Requests Response Structure
  description: Field-level structure documentation for the requests.Response object.
  url: https://raw.githubusercontent.com/api-evangelist/requests/refs/heads/main/json-structure/requests-response-structure.json
- type: JSONLDContext
  name: Requests JSON-LD Context
  description: JSON-LD context mapping Requests HTTP concepts to Hydra and schema.org.
  url: https://raw.githubusercontent.com/api-evangelist/requests/refs/heads/main/json-ld/requests-context.jsonld
- type: Examples
  name: GET Request Example
  description: Example of a GET request to the GitHub API using requests.get().
  url: https://raw.githubusercontent.com/api-evangelist/requests/refs/heads/main/examples/requests-get-example.json
- type: Examples
  name: POST Request Example
  description: Example of a POST request with JSON body using requests.post().
  url: https://raw.githubusercontent.com/api-evangelist/requests/refs/heads/main/examples/requests-post-example.json
- type: Vocabulary
  name: Requests Vocabulary
  description: Domain vocabulary for the Requests library programming model, features, and ecosystem.
  url: https://raw.githubusercontent.com/api-evangelist/requests/refs/heads/main/vocabulary/requests-vocabulary.yml
- type: ChangeLog
  name: Requests Changelog
  description: Release history and changelog for the Requests library.
  url: https://requests.readthedocs.io/en/latest/community/updates/
maintainers:
- FN: Kin Lane
  email: kin@apievangelist.com