Reddit API — Docs, OpenAPI & Kin Score

Reddit is a social news aggregation, discussion, and community platform where users submit, vote, and comment on content organized into topic-based communities called subreddits. Reddit provides developer APIs for accessing platform data, managing communities, running advertising campaigns, and embedding content. The Reddit Data API provides access to posts, comments, subreddits, user profiles, and moderation tools via OAuth 2.0. The Reddit Ads API enables programmatic management of advertising campaigns, audiences, and conversion tracking. All API access requires OAuth 2.0 authentication via the oauth.reddit.com server at 60 requests per minute.

Reddit publishes 39 API contracts indexed on the APIs.io network, including Account API, Flair API, Links & Comments API, and 36 more. Tagged areas include Reddit, Advertising, Community, Content, and Social Media.

The Reddit catalog on APIs.io includes 1 event-driven AsyncAPI specification, 1 JSON-LD context, and 2 Spectral governance rulesets.

Reddit’s developer surface includes CLI, changelog, authentication, API reference, documentation, getting-started guide, engineering blog, and 70 more developer resources.

🌐 Visit website 📡 Profile data on GitHub

63.0/100 strong ▲ 19.7 Agent 39/100 agent ready Heartbeat 0/100 dormant saas Full breakdown ↓
scored 2026-11-06 · rubric v0.27.0 · Show this score on your site →

AccessFreeSelf serve⚡ Free to try

3 published contracts 1 MCP Servers 6 Agent Skills

Reddit Advertising Community Content Social MediaSocial NewsSocial

What this lets a business do 1

Business capabilities this provider's published APIs can perform, derived from its own contracts. Browse all capabilities →

Content Compliance & Standards Management

BC-3780

Moderation

GET /r/{subreddit}/about/modqueue GET /r/{subreddit}/about/reports POST /api/remove GET /r/{subreddit}/about/banned

Kin Score

Kin Score How this is scored →
scored 2026-11-06 · rubric v0.27.0

Composite quality — 63.0/100 · strong

Contract Quality 12.7 / 19

Developer Ergonomics 9.9 / 15

Access Clarity 6.7 / 15

Operational Transparency 9.0 / 10

Contract Governance 2.0 / 9

Discoverability 5.1 / 8

Regulatory Posture 5.4 / 15

Create-or-Update Ergonomics 0.0 / 10

Agent readiness — 39/100 · agent ready

Machine-Readable Contract 18 / 18

Agentic Access Contract 10 / 10

Documented Reversibility 0 / 6

MCP Server 12 / 12

Machine-Readable Auth 10 / 10

Idempotency 0 / 9

Stable Error Semantics 8 / 8

Request/Response Examples 7 / 7

Rate-Limit Signaling 7 / 7

Typed Event Surface 6 / 6

Agent Skills 5 / 5

Well-Known Catalog 0 / 4

Consent & Bot Identity 0 / 3

A2A Agent Card 0 / 8

Dry-Run / Simulate Mode 0 / 4

Delegated User Identity 6 / 6

Protected Resource Metadata 0 / 5

Registration Without a Human 0 / 6

Agentic Commerce Well-Known Document 0 / 5

Pagination 0 / 5

Distinct Operations 3 / 3

MCP Tool Quality 6 / 6

Regulatory Posture applies to this provider. Its tags matched the Horizontal (data, software, accessibility, platform) regime, so Regulatory Posture carries 15 points of the composite. If this regime is wrong for your business, say so on your provider repo — the applicability map is public and we will correct it.

Create-or-Update Ergonomics applies to this provider. This API accepts writes, so it carries 10 points of the composite. It is scored from the published contracts themselves: whether a caller can create-or-update in one call, whether the write accepts a key the caller already holds, and whether the response says which branch ran. Without that, every write needs a search-and-branch in front of it, and the first time that check is skipped a duplicate record is created. Scored against the observed mean rather than raw — a provider at the catalog average is unchanged by this facet, not penalised by it.

The six quality facets above are damped to 75 points between them, because the conditional facet above carries the other 25. That is why each facet's contribution is shown against a damped maximum: raising a quality facet moves the composite by 75% of its nominal weight, not 100%. The full arithmetic is at apis.io/rating/.

Show this score on your site.

It updates itself when the score changes. Paste this where you link to your API docs:

<a href="https://apis.io/providers/reddit/"><img src="https://apis.io/badge/reddit/card.svg" alt="Reddit on APIs.io — Kin Score by API Evangelist"></a>

Other styles, a README pill and a shields.io endpoint are on the badge page.

Raise your score.

Agent readiness — checks not met, largest first (exact, from this profile):

Idempotency +9 pts — OpenAPI mutating operations declare an idempotency key — a header, a request-body property, or a named de-duplication token whose own description says so (verified); else common[].type matches /idempoten/i (documented)
A2A Agent Card +8 pts — a2a/-a2a.yml manifest, graded on conformance.grade against A2A 1.0.0
Registration Without a Human +6 pts — a `registration_endpoint` in the served RFC 8414 / OIDC discovery document
Documented Reversibility +6 pts — a reversal operation in the contract, graded up when a window is documented too
Pagination +5 pts — share of collection GETs (an array, or one wrapped in data/items/results ...) that declare a page/limit/offset/cursor parameter, a Link header or a next/cursor field; na with no collection GETs
Protected Resource Metadata +5 pts — a served /.well-known/oauth-protected-resource carrying `resource` (documented), and naming its authorization_servers (verified)

4 more unmet checks in the Agent Readiness table above.

Kin Score — facets with the most composite points still available (weight × headroom):

Access Clarity scores 44.7 — up to +11.1 composite points
Contract Governance scores 22.0 — up to +9.4 composite points
Contract Quality scores 67.5 — up to +8.1 composite points

Each check links to what satisfies it. Publish the artifact, or tell us where it already lives, and the score moves on the next scoring run.

Improve this rating by publishing the missing artifacts — every area above can be raised, and the full rubric is at apis.io/rating/. Every facet and dimension name above is a link: it opens that measurement's own page — what it means, the exact checks that feed it, how the whole catalog distributes on it, and the providers at the top of it. This rating is computed from the provider profile at artifacts.apis.io/reddit/apis.yml: open an issue on github.com/api-evangelist/reddit to ask a question or point us at an artifact you publish. Submit an artifact on GitHub — free → Manage your own listing — the Influence plan, $499/mo →

Reddit is an area vendor: providers adopt it to run part of their developer surface. This is the Kin Score checks its features can move for a provider that adopts it, what each one really earns, and what it earns nothing for.

communitycapability map1 features checked 2026-09-25 · rubric v0.22.0

A subreddit is the weakest community pointer on the Kin Score. Declared as Community it earns half of support_channel (1 of 2 points) only because that type is never probed. Declared as Support it is probed, and www.reddit.com answers every subreddit path, real or invented, with the same 8.4 KB page (checked 2026-09-25 with both a browser and a bot user agent), so it grades soft-404 and earns nothing, as the one Reddit support pointer in the catalog already does. Subreddits are also created and moderated by redditors, so a provider may not own the community it points at.

Developer Ergonomics1.0 of 42 pts

Check	Earns	Through
Support channelconditional Developer ErgonomicsOnly while Community pointers stay unprobed. Declared as Support, or once the probe reads Community, www.reddit.com returns an identical ~8.4 KB 200 for a real and a nonexistent subreddit, the pointer grades soft-404 and the credit is 0. The one Reddit supp…	1.0 of 2	Subreddit (community)

Across 8977 providers that publish a contract, adopting Reddit would move 0. Median lift: composite +0.0 (90th percentile +0.0), agent readiness +0.0 (+0.0). Conditional rows excluded.

A model, not a score. Adopting this vendor changes a provider's Kin Score only when the provider publishes the resulting artifacts on its own surface; nothing here writes a score, and no sponsorship or partnership can. The rating is not for sale → · Full vendor facets artifact

Markets this provider is in provisional

The Kin Score Market layer reads a provider inside its market: its position, and how deep its integrations go. Depth is only comparable within a position. Provisional and unweighted: not part of the Kin Score or agent readiness.

Market	Position	Depth	Registered MCP server	Declares compatibility
Social and Fediverse	mixed	18.8	-	1
IFTTT Services (service publishers)	mixed	18.8	-	1

Registered MCP server and declares compatibility are report only — not weighted. Undeclared means we found nothing we can read, so there is no number: we never infer integrations.

Standards implemented 3

Standards this provider implements or carries. De facto ones are profiled and measured by the API Commons; formal ones come from the standards directory and are linked by the provider's own tags. The evidence column says how each claim was established — not that it was made.

Model Context Protocol (MCP)

measured — observed by APIs.io (documented)

OpenAPI

measured — observed by APIs.io (published)

OAuth 2.0

measured — observed by APIs.io (declared)

APIs 39

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

Reddit OAuth 2.0 Authorization

Reddit's OAuth 2.0 authorization system provides authentication for all Reddit API access. Developers register applications at reddit.com/prefs/apps to obtain client credentials...

Reddit Account API

Endpoints related to the authenticated user account, including identity, preferences, karma, trophies, and friend management.

Reddit Flair API

Endpoints for managing user and link flair within subreddits, including flair templates, assignments, and configuration.

Reddit Links & Comments API

Endpoints for interacting with submissions (links) and comments, including voting, saving, hiding, reporting, and submitting content.

Reddit Listings API

Endpoints for retrieving sorted listings of content from subreddits, including hot, new, rising, top, and controversial posts.

Reddit Messages API

Endpoints for managing private messages, including inbox, sent, unread messages, composing, and message actions.

Reddit Moderation API

Endpoints for subreddit moderation tasks, including approving and removing content, managing bans, moderation logs, and modqueue.

Reddit Search API

Endpoints for searching Reddit content including submissions, subreddits, and users across the platform.

Reddit Subreddits API

Endpoints for managing and retrieving information about subreddits, including subscription, creation, rules, and settings.

Reddit Users API

Endpoints for retrieving information about Reddit users, including profiles, post history, comment history, and trophies.

Reddit Wiki API

Endpoints for managing subreddit wikis, including reading and editing wiki pages, revision history, and permissions.

Reddit Ads API

The Reddit Advertising API (v3) lets advertisers and partners programmatically manage ad accounts, businesses, campaigns, ad groups, ads, creative assets, custom and saved audie...

Reddit Devvit Reddit API Plugin (gRPC)

Protocol Buffer service definitions for the Reddit API as exposed to Devvit apps (Reddit's Developer Platform): Flair, GraphQL, LinksAndComments, Listings, Moderation, ModNote, ...

Reddit Ad Account History API

Information about ad account history.

Reddit Ad Accounts API

Information about ad accounts.

Reddit Ad Groups API

Information about ad groups.

Reddit App API

Information about apps.

Reddit Bid Suggestions API

Suggest bids.

Reddit Businesses API

Information about businesses.

Reddit Campaigns API

Information about campaigns.

Reddit Creative Assets API

Information about creative assets stored in the asset library.

Reddit Creative Generator API

Information about creative generator.

Reddit Custom Audiences API

Information about custom audiences. > **Note:** We're updating custom audience estimates during the week of October 14, 2026. Advertisers may see lower estimates after these upd...

Reddit Data Deletion API

Information about data deletion jobs.

Reddit Forecasting API

Information about forecasting.

Reddit Funding Instruments API

Information about funding instruments.

Reddit Lead Generation Forms API

Information about lead generation forms.

Reddit Members API

Information about members.

Reddit Pixels API

Information about Pixels.

Reddit Posts API

Information about posts. > **Note:** This is a legacy API. Use [Structured Posts API](/docs/v3/api/structured-posts) instead.

Reddit Product Catalogs API

Information about product catalogs.

Reddit Profiles API

Information about profiles.

Reddit Reports API

Information about reports.

Reddit Saved Audiences API

Information about saved audiences.

Reddit SK Ad Network API

Information about SKAdNetwork.

Reddit Structured Posts API

Information about structured posts.

Reddit Targeting API

Information about targeting.

Reddit o Embed API

Endpoints implementing the oEmbed protocol for embedding Reddit content in external websites and applications.

Reddit Timezones API

Information about time zones.

MCP Servers 1

Model Context Protocol servers that expose these APIs to AI agents.

Reddit Devvit MCP server

Reddit's Devvit developer platform ships an official MCP server, published on npm as @devvit/mcp ("MCP for Devvit things", latest 0.0.27, 2026-06-12), to assist with agent-drive...

ads-campaign-management-read: ads-campaign-management-read 400 requests 60 sec
ads-campaign-management-write: ads-campaign-management-write 200 requests 60 sec
ads-forecasting: ads-forecasting 30 requests 60 sec

All 21 limits →

Pricing Plans 1

Published pricing tiers and plan structures.

Reddit Plans Pricing

2 plans

PLANS

Rate Limits 2

Documented rate limits and quota policies.

Reddit Ads Api Rate Limits

21 limits

RATE LIMITS

Reddit Rate Limits

4 limits

RATE LIMITS

Service Levels 1

Uptime the provider promises or reports, as SLA4OAI. Read from its own pages; APIs.io runs no monitors.

SLA

FinOps 1

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

Reddit Finops

FINOPS

Event Specifications 1

AsyncAPI definitions for this provider's event-driven and streaming APIs.

Reddit Webhooks

ASYNCAPI

Semantic Vocabularies 1

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

Reddit Context

0 classes · 7 properties

JSON-LD

Spectral Rules 2

Spectral governance rulesets for linting and validating these APIs.

Reddit — jsonschema rules

5 rules · 4 warnings 1 info

SPECTRAL

Reddit API Rules

12 rules · 3 errors 8 warnings 1 info

SPECTRAL

OpenAPI Overlays 12

Overlays applied on top of this provider's contracts. Each card says who wrote it: a document the provider publishes, or one API Evangelist derived or generated.

Reddit Account Api Overlay

JSON Structure 1

JSON Structure definitions describing this provider's data shapes.

Reddit Post Structure

0 properties

JSON STRUCTURE

Examples 2

Example request and response payloads for these APIs.

Reddit Ads Api Create Campaign Example

2 fields

EXAMPLE

Reddit Data Api Get Subreddit Hot Example

2 fields

EXAMPLE

Security Posture 3

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

Reddit Authentication

oauth2 · 1 scheme

SECURITY

Reddit Domain Security

TLSv1.3 · HSTS · DMARC

SECURITY

Reddit Vulnerability Disclosure

Hackerone · security.txt · contact published

SECURITY

Scopes 1

OAuth scopes governing access to this provider's APIs.

Reddit Scopes

23 scopes · authorizationCode

23 scopes

SCOPES

Agentic Access 1

Recommended x-agentic-access execution contracts for AI agents.

Reddit Agentic Access

56 operations · 19 acting

AGENTIC

Resources

Get Started 3

Portal, sign-up, and the first successful call

DeveloperPortal

DeveloperPortal

GettingStarted

GettingStarted

Signup

Signup

Documentation 9

Reference material describing how the API behaves

APIReference

Documentation

Documentation

Documentation

OpenAPI

OpenAPI

JSONSchema

JSONSchema

JSONSchema

Scroll for all 9

Agent Surfaces 5

MCP servers, agent skills, and machine-readable catalogs

AgentSkill

MCPServer

WellKnown

AgenticAccess

LLMsTxt

Design & Contract 13

Pagination, idempotency, versioning, errors, and events

Spectral

Spectral

JSONLD

Webhooks

DataModel

Conventions

Lifecycle

ErrorCatalog

Conformance

JSONLDContext

JSONStructure

SpectralRuleset

Vocabulary

Scroll for all 13

Build 5

SDKs, sample code, and the tooling you integrate with

CLI

CLI

ToolCrosswalk

ToolCrosswalk

IntegrationEdges

IntegrationEdges

GitHubOrganization

GitHubOrganization

GitHubOrganization

GitHubOrganization

Access & Security 9

Authentication, authorization, and security posture

Security

SecurityTxt

SecurityTxt

SecurityTxt

SecurityTxt

VulnerabilityDisclosure

VulnerabilityDisclosure

DomainSecurity

DomainSecurity

Authentication

Authentication

OAuthScopes

OAuthScopes

Scroll for all 9

Operate 7

Status, limits, changes, and where to get help

RateLimits

ChangeLog

Deprecation

RateLimits

ChangeLog

StatusPage

Support

Scroll for all 7

Commercial 5

Pricing, plans, and the legal terms of use

Plans

FinOps

TermsOfService

PrivacyPolicy

TermsOfService

Company 3

The organization behind the API

LinkedIn

Website

Website

Blog

Blog

Other 18

Properties that don't map to a standard resource type

Protobuf

Protobuf

Protobuf

Protobuf

Protobuf

Protobuf

Protobuf

Protobuf

Protobuf

Protobuf

Protobuf

Protobuf

Protobuf

Overlay

Hosts

Vendors

VendorFacets

CapabilityMap

Scroll for all 18

Source (apis.yml)

aid: reddit
name: Reddit
description: Reddit is a social news aggregation, discussion, and community platform where users submit, vote, and comment
  on content organized into topic-based communities called subreddits. Reddit provides developer APIs for accessing platform
  data, managing communities, running advertising campaigns, and embedding content. The Reddit Data API provides access to
  posts, comments, subreddits, user profiles, and moderation tools via OAuth 2.0. The Reddit Ads API enables programmatic
  management of advertising campaigns, audiences, and conversion tracking. All API access requires OAuth 2.0 authentication
  via the oauth.reddit.com server at 60 requests per minute.
type: Index
deliveryModel:
  model: saas
  open_source: false
  commercial: true
  callable_host: true
  label: Hosted service · you call their endpoint
  confidence: high
  source:
  - openapi
  - pricing
  generated: '2026-08-28'
  method: derived
accessModel:
  pricing: free
  onboarding: self-serve
  trial: false
  try_now: true
  public: false
  gated: none
  gated_source:
  - onboarding
  label: Free · Self-serve signup
  confidence: high
  probe_state: covered
  source:
  - plans
  - authentication
  - scopes
  - rate-limits
  - security
  generated: '2026-11-06'
  method: derived
image: https://kinlane-images.s3.amazonaws.com/shared/apis-json/icons/reddit.png
tags:
- Reddit
- Advertising
- Community
- Content
- Social Media
- Social News
- Social
tags_raw:
- Reddit
- Advertising
- Communities
- Content
- Social Media
- Social News
- Social-Media
- Social
url: https://raw.githubusercontent.com/api-evangelist/reddit/refs/heads/main/apis.yml
created: '2026-01-01'
modified: '2026-11-05'
specificationVersion: '0.23'
maintainers:
- FN: Kin Lane
  email: kin@apievangelist.com
common:
- type: RateLimits
  url: rate-limits/reddit-ads-api-rate-limits.yml
- type: Spectral
  url: rules/reddit-rules.yml
- type: Spectral
  url: rules/reddit-jsonschema-spectral-rules.yml
- type: JSONLD
  url: json-ld/reddit-context.jsonld
- type: AgentSkill
  url: skills/_index.yml
- type: Webhooks
  url: asyncapi/reddit-webhooks.yml
- type: DataModel
  url: data-model/reddit-data-model.yml
- type: CLI
  url: cli/reddit-cli.yml
- type: ChangeLog
  url: changelog/reddit-changelog.yml
- type: Conventions
  url: conventions/reddit-conventions.yml
- type: Security
  url: https://hackerone.com/reddit?type=team
- type: Deprecation
  url: lifecycle/reddit-lifecycle.yml
- type: Lifecycle
  url: lifecycle/reddit-lifecycle.yml
- type: ErrorCatalog
  url: errors/reddit-problem-types.yml
- type: Conformance
  url: conformance/reddit-conformance.yml
- type: Protobuf
  url: grpc/reddit-devvit-wiki_msg.proto
- type: Protobuf
  url: grpc/reddit-devvit-widgets_msg.proto
- type: Protobuf
  url: grpc/reddit-devvit-users_msg.proto
- type: Protobuf
  url: grpc/reddit-devvit-subreddits_msg.proto
- type: Protobuf
  url: grpc/reddit-devvit-privatemessages_msg.proto
- type: Protobuf
  url: grpc/reddit-devvit-newmodmail_msg.proto
- type: Protobuf
  url: grpc/reddit-devvit-modnote_msg.proto
- type: Protobuf
  url: grpc/reddit-devvit-moderation_msg.proto
- type: Protobuf
  url: grpc/reddit-devvit-listings_msg.proto
- type: Protobuf
  url: grpc/reddit-devvit-linksandcomments_msg.proto
- type: Protobuf
  url: grpc/reddit-devvit-graphql_msg.proto
- type: Protobuf
  url: grpc/reddit-devvit-flair_msg.proto
- type: Protobuf
  url: grpc/reddit-devvit-common_msg.proto
- type: Overlay
  url: overlays/reddit-account-api-overlay.yaml
- type: ToolCrosswalk
  url: mcp/reddit-tool-crosswalk.yml
- type: MCPServer
  url: mcp/reddit-mcp.yml
- type: SecurityTxt
  url: well-known/reddit-www-security.txt
- type: SecurityTxt
  url: well-known/reddit-security.txt
- type: SecurityTxt
  url: well-known/reddit-oauth-security.txt
- type: SecurityTxt
  url: well-known/reddit-api-security.txt
- type: WellKnown
  url: well-known/reddit-well-known.yml
- type: Hosts
  url: hosts/reddit-hosts.yml
- type: IntegrationEdges
  url: integrations/reddit-integration-edges.yml
- type: Vendors
  url: vendors/reddit-vendors.yml
- type: Plans
  url: plans/reddit-plans-pricing.yml
- type: RateLimits
  url: rate-limits/reddit-rate-limits.yml
- type: FinOps
  url: finops/reddit-finops.yml
- type: VendorFacets
  url: vendor-facets/reddit-vendor-facets.yml
- type: CapabilityMap
  url: capabilities/reddit-capability-edges.yml
  name: Reddit Business Capability Map
- type: AgenticAccess
  url: agentic-access/reddit-agentic-access.yml
- type: VulnerabilityDisclosure
  url: security/reddit-vulnerability-disclosure.yml
- type: DomainSecurity
  url: security/reddit-domain-security.yml
- type: Authentication
  url: authentication/reddit-authentication.yml
- type: OAuthScopes
  url: scopes/reddit-scopes.yml
- type: LinkedIn
  url: https://www.linkedin.com/company/reddit-com
- type: Website
  url: https://www.reddit.com
- type: DeveloperPortal
  url: https://developers.reddit.com/
- type: APIReference
  url: https://www.reddit.com/dev/api
- type: Documentation
  name: Devvit Developer Platform Docs
  url: https://developers.reddit.com/docs
- type: GettingStarted
  url: https://developers.reddit.com/docs/quickstart
- type: ChangeLog
  url: https://developers.reddit.com/docs/changelog
- type: LLMsTxt
  url: https://developers.reddit.com/docs/llms.txt
- type: Documentation
  name: Reddit Ads API Documentation
  url: https://ads-api.reddit.com/docs/
- type: Documentation
  url: https://support.reddithelp.com/hc/en-us/articles/16160319875092-Reddit-Data-API-Wiki
- type: GitHubOrganization
  url: https://github.com/reddit
- type: GitHubOrganization
  name: The Reddit Archives
  url: https://github.com/reddit-archive
- type: TermsOfService
  name: Developer Terms
  url: https://www.redditinc.com/policies/developer-terms
- type: Blog
  url: https://www.redditinc.com/blog
- type: PrivacyPolicy
  url: https://www.reddit.com/policies/privacy-policy
- type: TermsOfService
  url: https://www.redditinc.com/policies/user-agreement
- type: StatusPage
  url: https://www.redditstatus.com/
- type: Support
  url: https://support.reddithelp.com/hc/en-us
- type: Signup
  url: https://www.reddit.com/register
- type: OpenAPI
  url: openapi/_original/reddit-data-api-openapi.yml
- type: OpenAPI
  url: openapi/_original/reddit-embeds-openapi.yml
- type: JSONSchema
  url: json-schema/reddit-post-schema.json
- type: JSONSchema
  url: json-schema/reddit-comment-schema.json
- type: JSONSchema
  url: json-schema/reddit-subreddit-schema.json
- type: JSONLDContext
  url: json-ld/reddit-context.jsonld
- type: JSONStructure
  url: json-structure/reddit-post-structure.json
- type: SpectralRuleset
  url: rules/reddit-rules.yml
- type: Vocabulary
  url: vocabulary/reddit-vocabulary.yml
apis:
- aid: reddit:oauth
  name: Reddit OAuth 2.0 Authorization
  description: Reddit's OAuth 2.0 authorization system provides authentication for all Reddit API access. Developers register
    applications at reddit.com/prefs/apps to obtain client credentials. Supported grant types include authorization_code (for
    user-delegated access), client_credentials (for app-only access), and implicit (for installed apps). Access tokens are
    obtained from https://www.reddit.com/api/v1/access_token and must be refreshed using refresh tokens. All scopes and permissions
    are listed at https://www.reddit.com/api/v1/scopes.
  humanURL: https://github.com/reddit-archive/reddit/wiki/OAuth2
  baseURL: https://www.reddit.com/api/v1
  tags:
  - Authentication
  - Authorization
  - OAuth
  - Security
  tags_raw:
  - Authentication
  - Authorization
  - OAuth 2.0
  - Security
  properties:
  - type: Documentation
    url: https://github.com/reddit-archive/reddit/wiki/OAuth2
  - type: Scopes
    url: https://www.reddit.com/api/v1/scopes
  - type: App Registration
    url: https://www.reddit.com/prefs/apps
- aid: reddit:reddit-account-api
  name: Reddit Account API
  description: Endpoints related to the authenticated user account, including identity, preferences, karma, trophies, and
    friend management.
  humanURL: https://www.reddit.com/dev/api
  baseURL: https://oauth.reddit.com
  tags:
  - Account
  properties:
  - type: OpenAPI
    url: openapi/reddit-account-api-openapi.yml
  - type: Documentation
    url: https://www.reddit.com/dev/api
  - type: Authentication
    url: https://github.com/reddit-archive/reddit/wiki/OAuth2
  - type: TermsOfService
    url: https://www.redditinc.com/policies/data-api-terms
  - type: Documentation
    url: https://support.reddithelp.com/hc/en-us/articles/14945211791892-Developer-Platform-Accessing-Reddit-Data
  - type: JSONSchema
    url: json-schema/reddit-account-schema.json
  - type: JSONSchema
    url: json-schema/reddit-karma-breakdown-schema.json
- aid: reddit:reddit-flair-api
  name: Reddit Flair API
  description: Endpoints for managing user and link flair within subreddits, including flair templates, assignments, and configuration.
  humanURL: https://www.reddit.com/dev/api
  baseURL: https://oauth.reddit.com
  tags:
  - Flair
  properties:
  - type: OpenAPI
    url: openapi/reddit-flair-api-openapi.yml
  - type: Documentation
    url: https://www.reddit.com/dev/api
  - type: Authentication
    url: https://github.com/reddit-archive/reddit/wiki/OAuth2
  - type: TermsOfService
    url: https://www.redditinc.com/policies/data-api-terms
  - type: Documentation
    url: https://support.reddithelp.com/hc/en-us/articles/14945211791892-Developer-Platform-Accessing-Reddit-Data
- aid: reddit:reddit-links-comments-api
  name: Reddit Links & Comments API
  description: Endpoints for interacting with submissions (links) and comments, including voting, saving, hiding, reporting,
    and submitting content.
  humanURL: https://www.reddit.com/dev/api
  baseURL: https://oauth.reddit.com
  tags:
  - Links & Comments
  properties:
  - type: OpenAPI
    url: openapi/reddit-links-comments-api-openapi.yml
  - type: Documentation
    url: https://www.reddit.com/dev/api
  - type: Authentication
    url: https://github.com/reddit-archive/reddit/wiki/OAuth2
  - type: TermsOfService
    url: https://www.redditinc.com/policies/data-api-terms
  - type: Documentation
    url: https://support.reddithelp.com/hc/en-us/articles/14945211791892-Developer-Platform-Accessing-Reddit-Data
  - type: JSONSchema
    url: json-schema/reddit-listing-schema.json
- aid: reddit:reddit-listings-api
  name: Reddit Listings API
  description: Endpoints for retrieving sorted listings of content from subreddits, including hot, new, rising, top, and controversial
    posts.
  humanURL: https://www.reddit.com/dev/api
  baseURL: https://oauth.reddit.com
  tags:
  - Listings
  properties:
  - type: OpenAPI
    url: openapi/reddit-listings-api-openapi.yml
  - type: Documentation
    url: https://www.reddit.com/dev/api
  - type: Authentication
    url: https://github.com/reddit-archive/reddit/wiki/OAuth2
  - type: TermsOfService
    url: https://www.redditinc.com/policies/data-api-terms
  - type: Documentation
    url: https://support.reddithelp.com/hc/en-us/articles/14945211791892-Developer-Platform-Accessing-Reddit-Data
  - type: JSONSchema
    url: json-schema/reddit-listing-schema.json
- aid: reddit:reddit-messages-api
  name: Reddit Messages API
  description: Endpoints for managing private messages, including inbox, sent, unread messages, composing, and message actions.
  humanURL: https://www.reddit.com/dev/api
  baseURL: https://oauth.reddit.com
  tags:
  - Message
  tags_raw:
  - Messages
  properties:
  - type: OpenAPI
    url: openapi/reddit-messages-api-openapi.yml
  - type: Documentation
    url: https://www.reddit.com/dev/api
  - type: Authentication
    url: https://github.com/reddit-archive/reddit/wiki/OAuth2
  - type: TermsOfService
    url: https://www.redditinc.com/policies/data-api-terms
  - type: Documentation
    url: https://support.reddithelp.com/hc/en-us/articles/14945211791892-Developer-Platform-Accessing-Reddit-Data
  - type: JSONSchema
    url: json-schema/reddit-listing-schema.json
- aid: reddit:reddit-moderation-api
  name: Reddit Moderation API
  description: Endpoints for subreddit moderation tasks, including approving and removing content, managing bans, moderation
    logs, and modqueue.
  humanURL: https://www.reddit.com/dev/api
  baseURL: https://oauth.reddit.com
  tags:
  - Moderation
  properties:
  - type: OpenAPI
    url: openapi/reddit-moderation-api-openapi.yml
  - type: Documentation
    url: https://www.reddit.com/dev/api
  - type: Authentication
    url: https://github.com/reddit-archive/reddit/wiki/OAuth2
  - type: TermsOfService
    url: https://www.redditinc.com/policies/data-api-terms
  - type: Documentation
    url: https://support.reddithelp.com/hc/en-us/articles/14945211791892-Developer-Platform-Accessing-Reddit-Data
  - type: JSONSchema
    url: json-schema/reddit-listing-schema.json
- aid: reddit:reddit-search-api
  name: Reddit Search API
  description: Endpoints for searching Reddit content including submissions, subreddits, and users across the platform.
  humanURL: https://www.reddit.com/dev/api
  baseURL: https://oauth.reddit.com
  tags:
  - Search
  properties:
  - type: OpenAPI
    url: openapi/reddit-search-api-openapi.yml
  - type: Documentation
    url: https://www.reddit.com/dev/api
  - type: Authentication
    url: https://github.com/reddit-archive/reddit/wiki/OAuth2
  - type: TermsOfService
    url: https://www.redditinc.com/policies/data-api-terms
  - type: Documentation
    url: https://support.reddithelp.com/hc/en-us/articles/14945211791892-Developer-Platform-Accessing-Reddit-Data
  - type: JSONSchema
    url: json-schema/reddit-listing-schema.json
- aid: reddit:reddit-subreddits-api
  name: Reddit Subreddits API
  description: Endpoints for managing and retrieving information about subreddits, including subscription, creation, rules,
    and settings.
  humanURL: https://www.reddit.com/dev/api
  baseURL: https://oauth.reddit.com
  tags:
  - Subreddits
  properties:
  - type: OpenAPI
    url: openapi/reddit-subreddits-api-openapi.yml
  - type: Documentation
    url: https://www.reddit.com/dev/api
  - type: Authentication
    url: https://github.com/reddit-archive/reddit/wiki/OAuth2
  - type: TermsOfService
    url: https://www.redditinc.com/policies/data-api-terms
  - type: Documentation
    url: https://support.reddithelp.com/hc/en-us/articles/14945211791892-Developer-Platform-Accessing-Reddit-Data
  - type: JSONSchema
    url: json-schema/reddit-subreddit-schema.json
  - type: JSONSchema
    url: json-schema/reddit-listing-schema.json
  - type: JSONSchema
    url: json-schema/reddit-subreddit-rule-schema.json
- aid: reddit:reddit-users-api
  name: Reddit Users API
  description: Endpoints for retrieving information about Reddit users, including profiles, post history, comment history,
    and trophies.
  humanURL: https://www.reddit.com/dev/api
  baseURL: https://oauth.reddit.com
  tags:
  - User
  tags_raw:
  - Users
  properties:
  - type: OpenAPI
    url: openapi/reddit-users-api-openapi.yml
  - type: Documentation
    url: https://www.reddit.com/dev/api
  - type: Authentication
    url: https://github.com/reddit-archive/reddit/wiki/OAuth2
  - type: TermsOfService
    url: https://www.redditinc.com/policies/data-api-terms
  - type: Documentation
    url: https://support.reddithelp.com/hc/en-us/articles/14945211791892-Developer-Platform-Accessing-Reddit-Data
  - type: JSONSchema
    url: json-schema/reddit-account-schema.json
  - type: JSONSchema
    url: json-schema/reddit-listing-schema.json
- aid: reddit:reddit-wiki-api
  name: Reddit Wiki API
  description: Endpoints for managing subreddit wikis, including reading and editing wiki pages, revision history, and permissions.
  humanURL: https://www.reddit.com/dev/api
  baseURL: https://oauth.reddit.com
  tags:
  - Wiki
  properties:
  - type: OpenAPI
    url: openapi/reddit-wiki-api-openapi.yml
  - type: Documentation
    url: https://www.reddit.com/dev/api
  - type: Authentication
    url: https://github.com/reddit-archive/reddit/wiki/OAuth2
  - type: TermsOfService
    url: https://www.redditinc.com/policies/data-api-terms
  - type: Documentation
    url: https://support.reddithelp.com/hc/en-us/articles/14945211791892-Developer-Platform-Accessing-Reddit-Data
  - type: JSONSchema
    url: json-schema/reddit-listing-schema.json
  - type: JSONSchema
    url: json-schema/reddit-wiki-page-schema.json
- aid: reddit:reddit-ads-api
  name: Reddit Ads API
  description: The Reddit Advertising API (v3) lets advertisers and partners programmatically manage ad accounts, businesses,
    campaigns, ad groups, ads, creative assets, custom and saved audiences, pixels, product catalogs, lead generation forms,
    targeting, forecasting and reporting. Authentication is Reddit OAuth2 with the adsread, adsedit, adsconversions and adsdatadeletion
    scopes. Use is governed by the Reddit Ads API Terms.
  humanURL: https://ads-api.reddit.com/docs/
  baseURL: https://ads-api.reddit.com/api/v3
  tags:
  - Advertising
  properties:
  - type: OpenAPI
    url: openapi/reddit-ads-api-openapi.yml
  - type: OpenAPI
    name: OpenAPI (provider-hosted)
    url: https://ads-api.reddit.com/api/v3/openapi.json
  - type: Documentation
    url: https://ads-api.reddit.com/docs/
  - type: TermsOfService
    url: https://business.reddithelp.com/s/article/Reddit-Ads-API-Terms
  - type: JSONSchema
    url: json-schema/reddit-components-enums-report-field-schema.json
  - type: JSONSchema
    url: json-schema/reddit-components-enums-time-zones-schema.json
  - type: JSONSchema
    url: json-schema/reddit-components-schema-campaign-schema.json
  - type: JSONSchema
    url: json-schema/reddit-components-schema-product-schema.json
  - type: JSONSchema
    url: json-schema/reddit-components-schema-pixel-conversion-event-schema.json
  - type: JSONSchema
    url: json-schema/reddit-components-schema-app-last-fired-at-report-schema.json
- aid: reddit:devvit-reddit-api-plugin
  name: Reddit Devvit Reddit API Plugin (gRPC)
  description: 'Protocol Buffer service definitions for the Reddit API as exposed to Devvit apps (Reddit''s Developer Platform):
    Flair, GraphQL, LinksAndComments, Listings, Moderation, ModNote, NewModmail, PrivateMessages, Subreddits, Users, Widgets
    and Wiki services, published by Reddit in the @devvit/protos npm package (v0.15.2, BSD-3-Clause, repository developers.reddit.com).'
  humanURL: https://developers.reddit.com/docs
  tags:
  - Developer Platform
  properties:
  - type: Protobuf
    url: grpc/reddit-devvit-flair_svc.proto
  - type: Protobuf
    url: grpc/reddit-devvit-graphql_svc.proto
  - type: Protobuf
    url: grpc/reddit-devvit-linksandcomments_svc.proto
  - type: Protobuf
    url: grpc/reddit-devvit-listings_svc.proto
  - type: Protobuf
    url: grpc/reddit-devvit-moderation_svc.proto
  - type: Protobuf
    url: grpc/reddit-devvit-modnote_svc.proto
  - type: Protobuf
    url: grpc/reddit-devvit-newmodmail_svc.proto
  - type: Protobuf
    url: grpc/reddit-devvit-privatemessages_svc.proto
  - type: Protobuf
    url: grpc/reddit-devvit-subreddits_svc.proto
  - type: Protobuf
    url: grpc/reddit-devvit-users_svc.proto
  - type: Protobuf
    url: grpc/reddit-devvit-widgets_svc.proto
  - type: Protobuf
    url: grpc/reddit-devvit-wiki_svc.proto
  - type: Documentation
    url: https://developers.reddit.com/docs
- aid: reddit:reddit-ad-account-history-api
  name: Reddit Ad Account History API
  description: Information about ad account history.
  humanURL: https://github.com/reddit-archive/reddit/wiki/OAuth2
  baseURL: https://ads-api.reddit.com/api/v3
  tags:
  - Ad Account History
  properties:
  - type: OpenAPI
    url: openapi/reddit-ad-account-history-api-openapi.yml
  - type: Documentation
    url: https://www.reddit.com/dev/api
  - type: Authentication
    url: https://github.com/reddit-archive/reddit/wiki/OAuth2
  - type: TermsOfService
    url: https://www.redditinc.com/policies/data-api-terms
  - type: Documentation
    url: https://support.reddithelp.com/hc/en-us/articles/14945211791892-Developer-Platform-Accessing-Reddit-Data
  - type: JSONSchema
    url: json-schema/reddit-oembed-response-schema.json
- aid: reddit:reddit-ad-accounts-api
  name: Reddit Ad Accounts API
  description: Information about ad accounts.
  humanURL: https://github.com/reddit-archive/reddit/wiki/OAuth2
  baseURL: https://ads-api.reddit.com/api/v3
  tags:
  - Ad Accounts
  properties:
  - type: OpenAPI
    url: openapi/reddit-ad-accounts-api-openapi.yml
  - type: Documentation
    url: https://www.reddit.com/dev/api
  - type: Authentication
    url: https://github.com/reddit-archive/reddit/wiki/OAuth2
  - type: TermsOfService
    url: https://www.redditinc.com/policies/data-api-terms
  - type: Documentation
    url: https://support.reddithelp.com/hc/en-us/articles/14945211791892-Developer-Platform-Accessing-Reddit-Data
  - type: JSONSchema
    url: json-schema/reddit-oembed-response-schema.json
- aid: reddit:reddit-ad-groups-api
  name: Reddit Ad Groups API
  description: Information about ad groups.
  humanURL: https://github.com/reddit-archive/reddit/wiki/OAuth2
  baseURL: https://ads-api.reddit.com/api/v3
  tags:
  - Ad Groups
  properties:
  - type: OpenAPI
    url: openapi/reddit-ad-groups-api-openapi.yml
  - type: Documentation
    url: https://www.reddit.com/dev/api
  - type: Authentication
    url: https://github.com/reddit-archive/reddit/wiki/OAuth2
  - type: TermsOfService
    url: https://www.redditinc.com/policies/data-api-terms
  - type: Documentation
    url: https://support.reddithelp.com/hc/en-us/articles/14945211791892-Developer-Platform-Accessing-Reddit-Data
  - type: JSONSchema
    url: json-schema/reddit-oembed-response-schema.json
- aid: reddit:reddit-app-api
  name: Reddit App API
  description: Information about apps.
  humanURL: https://github.com/reddit-archive/reddit/wiki/OAuth2
  baseURL: https://ads-api.reddit.com/api/v3
  tags:
  - App
  properties:
  - type: OpenAPI
    url: openapi/reddit-app-api-openapi.yml
  - type: Documentation
    url: https://www.reddit.com/dev/api
  - type: Authentication
    url: https://github.com/reddit-archive/reddit/wiki/OAuth2
  - type: TermsOfService
    url: https://www.redditinc.com/policies/data-api-terms
  - type: Documentation
    url: https://support.reddithelp.com/hc/en-us/articles/14945211791892-Developer-Platform-Accessing-Reddit-Data
  - type: JSONSchema
    url: json-schema/reddit-oembed-response-schema.json
- aid: reddit:reddit-bid-suggestions-api
  name: Reddit Bid Suggestions API
  description: Suggest bids.
  humanURL: https://github.com/reddit-archive/reddit/wiki/OAuth2
  baseURL: https://ads-api.reddit.com/api/v3
  tags:
  - Bid Suggestions
  properties:
  - type: OpenAPI
    url: openapi/reddit-bid-suggestions-api-openapi.yml
  - type: Documentation
    url: https://www.reddit.com/dev/api
  - type: Authentication
    url: https://github.com/reddit-archive/reddit/wiki/OAuth2
  - type: TermsOfService
    url: https://www.redditinc.com/policies/data-api-terms
  - type: Documentation
    url: https://support.reddithelp.com/hc/en-us/articles/14945211791892-Developer-Platform-Accessing-Reddit-Data
  - type: JSONSchema
    url: json-schema/reddit-oembed-response-schema.json
- aid: reddit:reddit-businesses-api
  name: Reddit Businesses API
  description: Information about businesses.
  humanURL: https://github.com/reddit-archive/reddit/wiki/OAuth2
  baseURL: https://ads-api.reddit.com/api/v3
  tags:
  - Business
  tags_raw:
  - Businesses
  properties:
  - type: OpenAPI
    url: openapi/reddit-businesses-api-openapi.yml
  - type: Documentation
    url: https://www.reddit.com/dev/api
  - type: Authentication
    url: https://github.com/reddit-archive/reddit/wiki/OAuth2
  - type: TermsOfService
    url: https://www.redditinc.com/policies/data-api-terms
  - type: Documentation
    url: https://support.reddithelp.com/hc/en-us/articles/14945211791892-Developer-Platform-Accessing-Reddit-Data
  - type: JSONSchema
    url: json-schema/reddit-oembed-response-schema.json
- aid: reddit:reddit-campaigns-api
  name: Reddit Campaigns API
  description: Information about campaigns.
  humanURL: https://github.com/reddit-archive/reddit/wiki/OAuth2
  baseURL: https://ads-api.reddit.com/api/v3
  tags:
  - Campaigns
  properties:
  - type: OpenAPI
    url: openapi/reddit-campaigns-api-openapi.yml
  - type: Documentation
    url: https://www.reddit.com/dev/api
  - type: Authentication
    url: https://github.com/reddit-archive/reddit/wiki/OAuth2
  - type: TermsOfService
    url: https://www.redditinc.com/policies/data-api-terms
  - type: Documentation
    url: https://support.reddithelp.com/hc/en-us/articles/14945211791892-Developer-Platform-Accessing-Reddit-Data
  - type: JSONSchema
    url: json-schema/reddit-oembed-response-schema.json
- aid: reddit:reddit-creative-assets-api
  name: Reddit Creative Assets API
  description: Information about creative assets stored in the asset library.
  humanURL: https://github.com/reddit-archive/reddit/wiki/OAuth2
  baseURL: https://ads-api.reddit.com/api/v3
  tags:
  - Creative Assets
  properties:
  - type: OpenAPI
    url: openapi/reddit-creative-assets-api-openapi.yml
  - type: Documentation
    url: https://www.reddit.com/dev/api
  - type: Authentication
    url: https://github.com/reddit-archive/reddit/wiki/OAuth2
  - type: TermsOfService
    url: https://www.redditinc.com/policies/data-api-terms
  - type: Documentation
    url: https://support.reddithelp.com/hc/en-us/articles/14945211791892-Developer-Platform-Accessing-Reddit-Data
  - type: JSONSchema
    url: json-schema/reddit-oembed-response-schema.json
- aid: reddit:reddit-creative-generator-api
  name: Reddit Creative Generator API
  description: Information about creative generator.
  humanURL: https://github.com/reddit-archive/reddit/wiki/OAuth2
  baseURL: https://ads-api.reddit.com/api/v3
  tags:
  - Creative Generator
  properties:
  - type: OpenAPI
    url: openapi/reddit-creative-generator-api-openapi.yml
  - type: Documentation
    url: https://www.reddit.com/dev/api
  - type: Authentication
    url: https://github.com/reddit-archive/reddit/wiki/OAuth2
  - type: TermsOfService
    url: https://www.redditinc.com/policies/data-api-terms
  - type: Documentation
    url: https://support.reddithelp.com/hc/en-us/articles/14945211791892-Developer-Platform-Accessing-Reddit-Data
  - type: JSONSchema
    url: json-schema/reddit-oembed-response-schema.json
- aid: reddit:reddit-custom-audiences-api
  name: Reddit Custom Audiences API
  description: 'Information about custom audiences.

    > **Note:** We''re updating custom audience estimates during the week of October 14, 2026. Advertisers may see lower estimates
    after these updates roll out. [Learn more about the planned changes](/blog/09-2026-monthly-update#upcoming-improvements-to-custom-audience-estimates).'
  humanURL: https://github.com/reddit-archive/reddit/wiki/OAuth2
  baseURL: https://ads-api.reddit.com/api/v3
  tags:
  - Custom Audiences
  properties:
  - type: OpenAPI
    url: openapi/reddit-custom-audiences-api-openapi.yml
  - type: Documentation
    url: https://www.reddit.com/dev/api
  - type: Authentication
    url: https://github.com/reddit-archive/reddit/wiki/OAuth2
  - type: TermsOfService
    url: https://www.redditinc.com/policies/data-api-terms
  - type: Documentation
    url: https://support.reddithelp.com/hc/en-us/articles/14945211791892-Developer-Platform-Accessing-Reddit-Data
  - type: JSONSchema
    url: json-schema/reddit-oembed-response-schema.json
- aid: reddit:reddit-data-deletion-api
  name: Reddit Data Deletion API
  description: Information about data deletion jobs.
  humanURL: https://github.com/reddit-archive/reddit/wiki/OAuth2
  baseURL: https://ads-api.reddit.com/api/v3
  tags:
  - Data Deletion
  properties:
  - type: OpenAPI
    url: openapi/reddit-data-deletion-api-openapi.yml
  - type: Documentation
    url: https://www.reddit.com/dev/api
  - type: Authentication
    url: https://github.com/reddit-archive/reddit/wiki/OAuth2
  - type: TermsOfService
    url: https://www.redditinc.com/policies/data-api-terms
  - type: Documentation
    url: https://support.reddithelp.com/hc/en-us/articles/14945211791892-Developer-Platform-Accessing-Reddit-Data
  - type: JSONSchema
    url: json-schema/reddit-oembed-response-schema.json
- aid: reddit:reddit-forecasting-api
  name: Reddit Forecasting API
  description: Information about forecasting.
  humanURL: https://github.com/reddit-archive/reddit/wiki/OAuth2
  baseURL: https://ads-api.reddit.com/api/v3
  tags:
  - Forecasting
  properties:
  - type: OpenAPI
    url: openapi/reddit-forecasting-api-openapi.yml
  - type: Documentation
    url: https://www.reddit.com/dev/api
  - type: Authentication
    url: https://github.com/reddit-archive/reddit/wiki/OAuth2
  - type: TermsOfService
    url: https://www.redditinc.com/policies/data-api-terms
  - type: Documentation
    url: https://support.reddithelp.com/hc/en-us/articles/14945211791892-Developer-Platform-Accessing-Reddit-Data
  - type: JSONSchema
    url: json-schema/reddit-oembed-response-schema.json
- aid: reddit:reddit-funding-instruments-api
  name: Reddit Funding Instruments API
  description: Information about funding instruments.
  humanURL: https://github.com/reddit-archive/reddit/wiki/OAuth2
  baseURL: https://ads-api.reddit.com/api/v3
  tags:
  - Funding Instruments
  properties:
  - type: OpenAPI
    url: openapi/reddit-funding-instruments-api-openapi.yml
  - type: Documentation
    url: https://www.reddit.com/dev/api
  - type: Authentication
    url: https://github.com/reddit-archive/reddit/wiki/OAuth2
  - type: TermsOfService
    url: https://www.redditinc.com/policies/data-api-terms
  - type: Documentation
    url: https://support.reddithelp.com/hc/en-us/articles/14945211791892-Developer-Platform-Accessing-Reddit-Data
  - type: JSONSchema
    url: json-schema/reddit-oembed-response-schema.json
- aid: reddit:reddit-lead-generation-forms-api
  name: Reddit Lead Generation Forms API
  description: Information about lead generation forms.
  humanURL: https://github.com/reddit-archive/reddit/wiki/OAuth2
  baseURL: https://ads-api.reddit.com/api/v3
  tags:
  - Lead Generation Forms
  properties:
  - type: OpenAPI
    url: openapi/reddit-lead-generation-forms-api-openapi.yml
  - type: Documentation
    url: https://www.reddit.com/dev/api
  - type: Authentication
    url: https://github.com/reddit-archive/reddit/wiki/OAuth2
  - type: TermsOfService
    url: https://www.redditinc.com/policies/data-api-terms
  - type: Documentation
    url: https://support.reddithelp.com/hc/en-us/articles/14945211791892-Developer-Platform-Accessing-Reddit-Data
  - type: JSONSchema
    url: json-schema/reddit-oembed-response-schema.json
- aid: reddit:reddit-members-api
  name: Reddit Members API
  description: Information about members.
  humanURL: https://github.com/reddit-archive/reddit/wiki/OAuth2
  baseURL: https://ads-api.reddit.com/api/v3
  tags:
  - Members
  properties:
  - type: OpenAPI
    url: openapi/reddit-members-api-openapi.yml
  - type: Documentation
    url: https://www.reddit.com/dev/api
  - type: Authentication
    url: https://github.com/reddit-archive/reddit/wiki/OAuth2
  - type: TermsOfService
    url: https://www.redditinc.com/policies/data-api-terms
  - type: Documentation
    url: https://support.reddithelp.com/hc/en-us/articles/14945211791892-Developer-Platform-Accessing-Reddit-Data
  - type: JSONSchema
    url: json-schema/reddit-oembed-response-schema.json
- aid: reddit:reddit-pixels-api
  name: Reddit Pixels API
  description: Information about Pixels.
  humanURL: https://github.com/reddit-archive/reddit/wiki/OAuth2
  baseURL: https://ads-api.reddit.com/api/v3
  tags:
  - Pixels
  properties:
  - type: OpenAPI
    url: openapi/reddit-pixels-api-openapi.yml
  - type: Documentation
    url: https://www.reddit.com/dev/api
  - type: Authentication
    url: https://github.com/reddit-archive/reddit/wiki/OAuth2
  - type: TermsOfService
    url: https://www.redditinc.com/policies/data-api-terms
  - type: Documentation
    url: https://support.reddithelp.com/hc/en-us/articles/14945211791892-Developer-Platform-Accessing-Reddit-Data
  - type: JSONSchema
    url: json-schema/reddit-oembed-response-schema.json
- aid: reddit:reddit-posts-api
  name: Reddit Posts API
  description: 'Information about posts.

    > **Note:** This is a legacy API. Use [Structured Posts API](/docs/v3/api/structured-posts) instead.'
  humanURL: https://github.com/reddit-archive/reddit/wiki/OAuth2
  baseURL: https://ads-api.reddit.com/api/v3
  tags:
  - Posts
  properties:


# --- truncated at 32 KB (40 KB total) ---
# Full source: https://artifacts.apis.io/reddit/apis.yml

Reddit API — frequently asked questions

Does Reddit have an API?

Yes. APIs.io lists 39 APIs from Reddit, including Reddit OAuth 2.0 Authorization, Reddit Account API and Reddit Flair API, and 36 more.

Is there an OpenAPI specification for the Reddit API?

Yes. APIs.io indexes 37 OpenAPI specifications for Reddit, each linked for download from this page.

How do I authenticate with the Reddit API?

Reddit documents its authentication (oauth2 · 1 scheme). The details are profiled on APIs.io as Reddit Authentication.

How much does the Reddit API cost?

Reddit publishes its prices; its Data API free access plan is free access usage of our Data API as of 2026-11-05. APIs.io lists 2 pricing plans for Reddit, with each plan's price, limits and inclusions under Pricing on this page.

Does Reddit have an MCP server?

Yes. APIs.io lists 1 MCP server for Reddit: Reddit's Devvit developer platform ships an official MCP server, published on npm as @devvit/mcp ("MCP for Devvit things", latest 0.0.27, 2026-06-12), to assist with agent-driven development of Devvit

Is the Reddit API ready for AI agents?

Reddit has a Kin Score of 63.0 out of 100 (strong) and an Agent Readiness score of 39.1 (agent-ready), scored by API Evangelist on 2026-11-06.

Work with this as data

Every provider here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for providers

9 MCP tools reach this

find_providersBrowse and filter every provider in the catalog.
get_provider_artifactsEvery artifact this provider publishes, grouped by type.
get_provider_operationsEvery operation across all of their OpenAPIs — one call instead of parsing every spec.
get_provider_toolsEvery MCP tool they ship, with the operation each wraps.
get_provider_evidenceHow each part of their score was established. Free — the basis for a claim should not sit behind it.
get_provider_ratingPRO — composite, band, trend and facet scores.
apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
resolveTurn a domain, URL or GitHub org into the provider it belongs to.
find_cohortsEvery scored population of providers in the catalog.

All 92 tools →

Call it yourself

curl for this page

This provider

curl "https://apis.io/api/v1/providers/reddit"

All providers

curl "https://apis.io/api/v1/providers?limit=25"

Every operation they expose

curl "https://apis.io/api/v1/providers/reddit/operations?limit=25"

How their score was established

curl "https://apis.io/api/v1/providers/reddit/evidence"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

Reddit

What this lets a business do 1

What adopting Reddit moves on the Kin Score 1

Markets this provider is in provisional

Standards implemented 3

APIs 39

Open Collections 22

MCP Servers 1

Agent Skills 6

Reddit API pricing

Rate limits

Pricing Plans 1

Rate Limits 2

Service Levels 1

FinOps 1

Event Specifications 1

Semantic Vocabularies 1

Spectral Rules 2

OpenAPI Overlays 12

JSON Schema 15

JSON Structure 1

Examples 2

Security Posture 3

Scopes 1