specification: API Commons Rate Limits
specificationVersion: '0.1'
schema: https://raw.githubusercontent.com/api-evangelist/interface-research/main/schema/api-commons.yml#/$defs/RateLimits
provider: Patreon
providerId: patreon
created: '2026-05-08'
# Provenance stamped 2026-08-11: this artifact was written by the API Evangelist
# bulk sweep dated 2026-05-08, not harvested from the provider. See roadmap#35.
method: generated
modified: '2026-05-08'
reconciled: true
tags:
- Creator Economy
- Membership
- Rate Limiting
- Quotas
- Throttling
description: Documented Patreon API rate limits per client and per access token.
notes: >-
  Patreon enforces both client-level and token-level limits, plus an edge-tier protection
  that blocks clients producing many 4xx errors. Exceeded limits return HTTP 429 with an
  optional retry_after_seconds field.
sources:
- https://docs.patreon.com/
responseCodes:
  throttled: 429
limits:
- name: Client requests
  scope: client
  metric: requests
  limit: 100
  window: 2 seconds
  notes: Per registered OAuth client.
- name: Token requests
  scope: token
  metric: requests
  limit: 100
  window: 1 minute
  notes: Per access token.
- name: Edge 4xx protection
  scope: client
  metric: 4xx_errors
  limit: 2000
  window: 10 minutes
  notes: Triggers a 30-minute block at the edge.
policies:
- name: Backoff Strategy
  description: Honor Retry-After / retry_after_seconds and apply exponential backoff with jitter.
- name: Reduce 4xx Errors
  description: >-
    Validate inputs before calling the API and avoid hammering 404s or 401s to prevent
    edge-level blocks.
maintainers:
- FN: Kin Lane
  email: kin@apievangelist.com