Reddit

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
image: https://kinlane-images.s3.amazonaws.com/shared/apis-json/apis-json-logo.jpg
tags:
- 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.19'
apis:
- aid: reddit:data-api
  name: Reddit Data API
  description: The Reddit Data API provides programmatic access to Reddit content
    including subreddits, posts, comments, user profiles, and voting data. Developers
    can use the API to read and submit content, manage subreddits, search across the
    platform, interact with Reddit communities, handle private messages, and manage
    flair. All requests require OAuth 2.0 authentication via oauth.reddit.com with
    rate limits of 60 requests per minute for authenticated clients. A Data API Terms
    agreement is required for high-volume access.
  humanURL: https://www.reddit.com/dev/api
  baseURL: https://oauth.reddit.com
  tags:
  - Comments
  - Communities
  - Content
  - Posts
  - Social Media
  - Subreddits
  properties:
  - 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: OpenAPI
    url: openapi/reddit-data-api-openapi.yml
  - url: graphql/reddit-graphql.md
    type: GraphQL
- aid: reddit:ads-api
  name: Reddit Ads API
  description: The Reddit Ads API allows advertisers and their marketing partners
    to programmatically create, edit, manage, and report on advertising campaigns
    on the Reddit platform. It provides endpoints for managing ad accounts, campaigns,
    ad groups, ads, creatives, targeting configurations, custom audiences (email lists,
    mobile IDs, pixel-based), conversion pixels, and performance reporting. Authentication
    uses OAuth 2.0 with a rate limit of one request per second per advertiser account.
  humanURL: https://ads-api.reddit.com/docs/
  baseURL: https://ads-api.reddit.com/api/v3
  tags:
  - Advertising
  - Campaigns
  - Marketing
  - Social Media
  - Targeting
  properties:
  - type: Documentation
    url: https://ads-api.reddit.com/docs/
  - type: TermsOfService
    url: https://business.reddithelp.com/s/article/Reddit-Ads-API-Terms
  - type: OpenAPI
    url: openapi/reddit-ads-api-openapi.yml
- aid: reddit:embeds
  name: Reddit Embeds (oEmbed)
  description: Reddit Embeds allows developers and content creators to embed Reddit
    posts and comments directly into external websites and applications. The service
    provides oEmbed endpoints that return embed codes and metadata for rendering Reddit
    content in a visually consistent format outside of the Reddit platform. It follows
    the oEmbed specification for content discovery and embedding, returning HTML embed
    code for any Reddit post or comment URL.
  humanURL: https://oembed.com/
  baseURL: https://www.reddit.com
  tags:
  - Content
  - Embedding
  - oEmbed
  - Social Media
  properties:
  - type: Documentation
    url: https://support.reddithelp.com/hc/en-us/articles/14945211791892-Developer-Platform-Accessing-Reddit-Data
  - type: OpenAPI
    url: openapi/reddit-embeds-openapi.yml
- 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 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
common:
- type: LinkedIn
  url: https://www.linkedin.com/company/reddit-com
- type: Website
  url: https://www.reddit.com
- type: Developer Portal
  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/reddit-data-api-openapi.yml
- type: OpenAPI
  url: openapi/reddit-ads-api-openapi.yml
- type: OpenAPI
  url: openapi/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