Home Providers Reddit
Reddit
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 11 APIs on the APIs.io network, including Account API, Flair API, Links & Comments API, and 8 more. Tagged areas include Advertising, Communities, Content, Social-Media, and Social News.
The Reddit catalog on APIs.io includes 1 JSON-LD context and 2 Spectral governance rulesets.
Reddit’s developer surface includes authentication, documentation, engineering blog, support, signup flow, and 22 more developer resources.
2 APIs
On this page
Kin Score
APIs 12
Open Collections 23
GraphQL 1
Pricing Plans 1
Rate Limits 1
FinOps 1
Vocabularies 1
Spectral Rules 2
JSON Schema 3
JSON Structure 1
Examples 2
Security Posture 3
Scopes 1
Agentic Access 1
Resources 27
apis.yml
24 Operational Transparency
0 Create-or-Update Ergonomics
Composite quality — 42.7/100 · developing
Agent readiness — 25/100 · agent aware
Individual APIs this provider publishes, each with its own machine-readable definition.
Scroll for all 12
Open, tool-agnostic API collections (OpenAPI-derived and Bruno).
Scroll for all 23
GraphQL schemas published by this provider.
Published pricing tiers and plan structures.
Documented rate limits and quota policies.
Cost, billing, and metering signals for API financial operations.
JSON-LD contexts and semantic vocabularies used across these APIs.
Spectral governance rulesets for linting and validating these APIs.
Standalone JSON Schema definitions for this provider's data models.
JSON Structure definitions describing this provider's data shapes.
Example request and response payloads for these APIs.
Authentication, domain security, vulnerability disclosure, and trust-center signals.
OAuth scopes governing access to this provider's APIs.
Recommended x-agentic-access execution contracts for AI agents.
Get Started 2
Portal, sign-up, and the first successful call
Documentation 7
Reference material describing how the API behaves
Scroll for all 7
Agent Surfaces 1
MCP servers, agent skills, and machine-readable catalogs
Design & Contract 4
Pagination, idempotency, versioning, errors, and events
Build 1
SDKs, sample code, and the tooling you integrate with
Access & Security 4
Authentication, authorization, and security posture
Operate 2
Status, limits, changes, and where to get help
Commercial 2
Pricing, plans, and the legal terms of use
Company 3
The organization behind the API
Other 1
Properties that don't map to a standard resource type
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: freemium
onboarding: self-serve
trial: false
try_now: true
public: false
label: Freemium · Self-serve signup
confidence: high
source:
- plans
- authentication
generated: '2026-07-22'
method: derived
image: https://kinlane-images.s3.amazonaws.com/shared/apis-json/icons/reddit.png
tags:
- Advertising
- Communities
- Content
- Social-Media
- Social News
tags_raw:
- Advertising
- Communities
- Content
- Social Media
- Social News
url: https://raw.githubusercontent.com/api-evangelist/reddit/refs/heads/main/apis.yml
created: '2026-01-01'
modified: '2026-05-19'
specificationVersion: '0.23'
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
- 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: GraphQL
url: graphql/reddit-graphql.md
- type: Documentation
url: https://support.reddithelp.com/hc/en-us/articles/14945211791892-Developer-Platform-Accessing-Reddit-Data
- 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: GraphQL
url: graphql/reddit-graphql.md
- 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: GraphQL
url: graphql/reddit-graphql.md
- type: Documentation
url: https://support.reddithelp.com/hc/en-us/articles/14945211791892-Developer-Platform-Accessing-Reddit-Data
- 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: GraphQL
url: graphql/reddit-graphql.md
- type: Documentation
url: https://support.reddithelp.com/hc/en-us/articles/14945211791892-Developer-Platform-Accessing-Reddit-Data
- 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: GraphQL
url: graphql/reddit-graphql.md
- type: Documentation
url: https://support.reddithelp.com/hc/en-us/articles/14945211791892-Developer-Platform-Accessing-Reddit-Data
- 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: GraphQL
url: graphql/reddit-graphql.md
- type: Documentation
url: https://support.reddithelp.com/hc/en-us/articles/14945211791892-Developer-Platform-Accessing-Reddit-Data
- aid: reddit:reddit-oembed-api
name: Reddit oEmbed API
description: Endpoints implementing the oEmbed protocol for embedding Reddit content in external websites and applications.
humanURL: https://www.reddit.com/dev/api
baseURL: https://oauth.reddit.com
tags:
- oEmbed
properties:
- type: OpenAPI
url: openapi/reddit-oembed-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: GraphQL
url: graphql/reddit-graphql.md
- type: Documentation
url: https://support.reddithelp.com/hc/en-us/articles/14945211791892-Developer-Platform-Accessing-Reddit-Data
- 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: GraphQL
url: graphql/reddit-graphql.md
- type: Documentation
url: https://support.reddithelp.com/hc/en-us/articles/14945211791892-Developer-Platform-Accessing-Reddit-Data
- 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: GraphQL
url: graphql/reddit-graphql.md
- type: Documentation
url: https://support.reddithelp.com/hc/en-us/articles/14945211791892-Developer-Platform-Accessing-Reddit-Data
- 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: GraphQL
url: graphql/reddit-graphql.md
- type: Documentation
url: https://support.reddithelp.com/hc/en-us/articles/14945211791892-Developer-Platform-Accessing-Reddit-Data
- 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: GraphQL
url: graphql/reddit-graphql.md
- type: Documentation
url: https://support.reddithelp.com/hc/en-us/articles/14945211791892-Developer-Platform-Accessing-Reddit-Data
common:
- 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://www.reddit.com/dev/api
- type: Documentation
url: https://support.reddithelp.com/hc/en-us/articles/16160319875092-Reddit-Data-API-Wiki
- type: GitHubOrganization
url: https://github.com/reddit-archive
- 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/reddit-ads-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
maintainers:
- FN: Kin Lane
email: kin@apievangelist.com
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"
Discovery needs no key. Ratings and market analysis are Pro.
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 .
A second provider on the same verified email joins the account you already have.
Kin Score
How this is scored →