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-productions.s3.amazonaws.com/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-02' 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: Terms of Service url: https://www.redditinc.com/policies/data-api-terms - type: OpenAPI url: openapi/reddit-data-api-openapi.yml - 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: Terms of Service 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: 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: GitHub Organization url: https://github.com/reddit-archive - type: Blog url: https://www.redditinc.com/blog - type: Privacy Policy url: https://www.reddit.com/policies/privacy-policy - type: Terms of Service url: https://www.redditinc.com/policies/user-agreement - type: Status url: https://www.redditstatus.com/ - type: Support url: https://support.reddithelp.com/hc/en-us - type: Sign Up 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: NaftikoCapability url: capabilities/community-engagement.yaml - type: NaftikoCapability url: capabilities/advertising.yaml - type: Vocabulary url: vocabulary/reddit-vocabulary.yml maintainers: - FN: Kin Lane email: kin@apievangelist.com