Requests website screenshot

Requests

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+.

Requests publishes 1 API on the APIs.io network. Tagged areas include Clients, HTTP Client, HTTP Library, Open Source, and Python.

The Requests catalog on APIs.io includes 1 JSON-LD context and 1 Spectral governance ruleset.

Requests’ developer surface includes documentation, code examples, changelog, and 10 more developer resources.

🌐 Visit website 📡 Source on GitHub
35.1/100 thin ▬ flat Agent 5/100 human only Full breakdown ↓
scored 2026-08-05 · rubric v0.9.1
AccessFreemium
1 APIs
ClientsHTTP ClientHTTP LibraryOpen SourcePythonPython Software Foundation

Kin Score

Kin Score Kin Score How this is scored →
scored 2026-08-05 · rubric v0.9.1
Composite quality — 35.1/100 · thin
Contract Quality 4.4 / 25
Developer Ergonomics 1.7 / 20
Commercial Clarity 7.9 / 20
Operational Transparency 6.8 / 13
Governance 8.3 / 12
Discoverability 5.9 / 10
Agent readiness — 5/100 · human only
Machine-Readable Contract 0 / 18
Agentic Access Contract 0 / 10
MCP Server 0 / 12
Machine-Readable Auth 0 / 10
Idempotency 0 / 9
Stable Error Semantics 0 / 8
Request/Response Examples 7 / 7
Rate-Limit Signaling 7 / 7
Typed Event Surface 0 / 6
Agent Skills 0 / 5
Well-Known Catalog 0 / 4
Consent & Bot Identity 0 / 3
A2A Agent Card 0 / 8
Dry-Run / Simulate Mode 0 / 4
Improve this rating by publishing the missing artifacts — every area above can be raised, and the full rubric is at apis.io/rating/. This rating is computed from github.com/api-evangelist/requests: open an issue to ask a question, or submit a pull request to add artifacts. Want it done for you? Prioritized profiling — $2,500 →

APIs 1

Individual APIs this provider publishes, each with its own machine-readable definition.

Requests

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...

Pricing Plans 1

Published pricing tiers and plan structures.

Requests Plans Pricing

3 plans

PLANS

Rate Limits 1

Documented rate limits and quota policies.

Requests Rate Limits

5 limits

RATE LIMITS

FinOps 1

Cost, billing, and metering signals for API financial operations.

Requests Finops

FINOPS

Semantic Vocabularies 1

JSON-LD contexts and semantic vocabularies used across these APIs.

Requests Context

13 classes · 12 properties

JSON-LD

Spectral Rules 1

Spectral governance rulesets for linting and validating these APIs.

Requests API Rules

5 rules · 4 warnings 1 info

SPECTRAL

JSON Schema 2

Standalone JSON Schema definitions for this provider's data models.

Requests Request

15 properties

JSON SCHEMA

Requests Response

13 properties

JSON SCHEMA

JSON Structure 1

JSON Structure definitions describing this provider's data shapes.

Requests Response Structure

0 properties

JSON STRUCTURE

Examples 2

Example request and response payloads for these APIs.

Requests Get Example

3 fields

EXAMPLE

Requests Post Example

3 fields

EXAMPLE

Security Posture 1

Authentication, domain security, vulnerability disclosure, and trust-center signals.

Requests Domain Security

TLSv1.3 · HSTS

SECURITY

Resources

Documentation 3

Reference material describing how the API behaves

Documentation
Documentation
 JSONSchema
JSONSchema
 JSONSchema
JSONSchema

Design & Contract 3

Pagination, idempotency, versioning, errors, and events

JSONStructure
JSONStructure
 JSONLDContext
JSONLDContext
 Vocabulary
Vocabulary

Build 3

SDKs, sample code, and the tooling you integrate with

GitHubOrganization
GitHubOrganization
 Examples
Examples
 Examples
Examples

Access & Security 1

Authentication, authorization, and security posture

DomainSecurity
DomainSecurity

Operate 1

Status, limits, changes, and where to get help

ChangeLog
ChangeLog

Company 1

The organization behind the API

Website
Website

Other 1

Properties that don't map to a standard resource type

PyPI
PyPI

Source (apis.yml)

apis.yml Raw ↑ 
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
accessModel:
  pricing: freemium
  onboarding: unknown
  trial: false
  try_now: false
  public: false
  label: Freemium
  confidence: medium
  source:
  - plans
  generated: '2026-07-22'
  method: derived
position: Consuming
access: 3rd-Party
image: https://kinlane-images.s3.amazonaws.com/shared/apis-json/icons/requests.png
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