{"registry_version":"2026.1025.387","generated_at":"2026-10-25T06:27:00Z","content_sha256":"089d16f627d9365e3d0663cc8069203706d7cb23a76c332226e29686968811a5","signed":true,"signature":{"key_id":"ed25519:74ca19268e364242","algorithm":"ed25519","expires_at":"2026-11-24T06:27:09Z","expired":false,"manifest":"/registry/manifest.json"},"entry_sha256":"91a2b250ab4129bfe796e9b254b06aebe765196ef2bcbae4b7e24894b96c01d5","entry":{"id":"reddit/data-api","name":"Reddit Data API","vendor":"Reddit","summary":"OAuth client id and secret for Reddit's Data API. New access now needs explicit approval under the Responsible Builder Policy, and commercial use needs a separate agreement with Reddit.","aliases":["reddit","reddit-api"],"category":"social","group":"C","homepage":"https://www.redditinc.com/","docs":["https://support.reddithelp.com/hc/en-us/articles/16160319875092-Reddit-Data-API-Wiki","https://support.reddithelp.com/hc/en-us/articles/42728983564564-Responsible-Builder-Policy","https://redditinc.com/policies/data-api-terms"],"status":"researched","last_verified":null,"last_researched":"2026-10-25","sources":[{"id":"data-api-terms","url":"https://redditinc.com/policies/data-api-terms","title":"Reddit – Data API Terms (effective June 19, 2023; last revised July 20, 2026)","accessed":"2026-10-25","supports":"Contact information required; commercial use, research beyond rate limits or other uses need a separate agreement; no selling or deriving revenue without written approval; no AI/ML training on User Content without rightsholder permission; no masking user agent or OAuth identity; delete data beyond the approved use case and on termination; Reddit may set limits and charge future fees; \"[name] for Reddit\" attribution only; privacy policy required in the app","kind":"official"},{"id":"data-api-wiki","url":"https://support.reddithelp.com/hc/en-us/articles/16160319875092-Reddit-Data-API-Wiki","title":"Reddit Help – Reddit Data API Wiki","accessed":"2026-10-25","supports":"100 QPM per OAuth client id averaged over 10 minutes; non-OAuth traffic blocked; User-Agent format <platform>:<app ID>:<version string> (by /u/<username>); X-Ratelimit-* headers. Read via search index only (page returned 403 to direct fetch) [to verify]","kind":"official"},{"id":"responsible-builder-policy","url":"https://support.reddithelp.com/hc/en-us/articles/42728983564564-Responsible-Builder-Policy","title":"Reddit Help – Responsible Builder Policy","accessed":"2026-10-25","supports":"Request access and get explicit approval before accessing any Reddit data through the API; no misrepresenting or masking how or why you access data; no circumventing or exceeding access limits; commercial use needs explicit written approval; no multiple accounts or duplicate requests for the same use case; developers pointed to Devvit. Read via search index only (page returned 403 to direct fetch) [to verify]","kind":"official"},{"id":"reddit-api-wiki-archive","url":"https://github.com/reddit-archive/reddit/wiki/API","title":"reddit-archive – API wiki (Reddit's archived developer wiki)","accessed":"2026-10-25","supports":"User-Agent format and example; generic user agents such as \"Python/urllib\" are drastically limited; never lie about your user-agent (spoofing browsers or bots leads to a ban). Archived page; its older 60 requests/minute figure is superseded by the Data API Wiki","kind":"official"},{"id":"developer-platform-help","url":"https://support.reddithelp.com/hc/en-us/articles/14945211791892-Developer-Platform-Accessing-Reddit-Data","title":"Reddit Help – Developer Platform & Accessing Reddit Data","accessed":"2026-10-25","supports":"Non-commercial Data API sign-up vs reaching out for commercial use; requests from hosted-provider IP ranges need a valid OAuth token. Read via search index only [to verify]","kind":"official"}],"allowed_domains":["www.reddit.com","reddit.com","support.reddithelp.com","redditinc.com"],"account_model":{"summary":"A Reddit user account owns the OAuth app (client id). API access for that app must be approved by Reddit.","accounts":[{"name":"Reddit user account","kind":"personal","owned_by":"the person (or a dedicated account the company controls)","required":true,"note":"Its username goes in the User-Agent string. The policy forbids registering multiple accounts for the same use case."},{"name":"OAuth app (client id)","kind":"developer","owned_by":"the Reddit account that registered it","parent":"Reddit user account","required":true,"note":"Rate limits are counted per OAuth client id."}],"notes":["If you accept the Data API Terms for a company, you warrant you can bind that company (Data API Terms 1.2)."]},"prerequisites":[{"need":"A Reddit account in good standing that you control"},{"need":"A written description of your use case (what data, why, commercial or not) for the access request","note":"Reddit reviews requests against its criteria; duplicate requests for the same use case are not allowed."}],"have_ready":[{"kind":"other","description":"Accurate, current contact details for the developer or company","why":"The Data API Terms require identification information that is kept up to date","needed_for":["request-access"],"auto_check":"none","source":"data-api-terms"},{"kind":"app_privacy_policy_url","description":"A privacy policy for your app explaining how you collect, use, store and disclose data","why":"Data API Terms 2.6 requires it","needed_for":["request-access"],"auto_check":"website_live","source":"data-api-terms"}],"steps":[{"id":"account","title":"Sign in to Reddit","summary":"You sign in to the Reddit account that will own the app, or create it yourself.","route":"guided","depends_on":[],"gate":"human_login","url":"https://www.reddit.com/login/"},{"id":"read-policy","title":"Read the Responsible Builder Policy and Data API Terms","summary":"Check your use case against the policy and terms. Consider Reddit's Developer Platform (Devvit) first; Reddit points developers there.","route":"guided","depends_on":["account"],"gate":"human_terms","url":"https://support.reddithelp.com/hc/en-us/articles/42728983564564-Responsible-Builder-Policy","sources":["responsible-builder-policy","data-api-terms"]},{"id":"request-access","title":"Request Data API access","summary":"You submit an access request describing your use case through Reddit's help-center request form. Commercial use must be requested separately and needs explicit written approval. You press submit. [to verify exact form and fields]","route":"guided","depends_on":["read-policy"],"gate":"third_party_review","url":"https://support.reddithelp.com/hc/en-us/requests/new","lead_time":{"official":{"text":"No review time published [to verify]","source":"responsible-builder-policy"}},"sources":["responsible-builder-policy","developer-platform-help"]},{"id":"register-app","title":"Register the OAuth app","summary":"At reddit.com/prefs/apps, create an app (script, web or installed type) with a name and redirect URI. Reddit shows the client id under the app name and the secret on the app card. Whether registration is blocked until approval is granted is [to verify].","route":"guided","depends_on":["request-access"],"gate":"human_submit","url":"https://www.reddit.com/prefs/apps","capture":{"env":"REDDIT_CLIENT_ID","kind":"client_id"},"sources":["developer-platform-help"]},{"id":"client-secret","title":"Copy the client secret","summary":"Copy the secret from the app card (installed apps have no secret).","route":"guided","depends_on":["register-app"],"gate":"none","url":"https://www.reddit.com/prefs/apps","capture":{"env":"REDDIT_CLIENT_SECRET","kind":"secret"}},{"id":"user-agent","title":"Set a unique, honest User-Agent","summary":"Use the format <platform>:<app ID>:<version string> (by /u/<reddit username>). Never spoof a browser or another bot; generic agents are heavily limited.","route":"guided","depends_on":["register-app"],"gate":"none","capture":{"env":"REDDIT_USER_AGENT","kind":"other"},"sources":["data-api-wiki","reddit-api-wiki-archive","data-api-terms"]}],"outputs":[{"name":"REDDIT_CLIENT_ID","description":"OAuth client id of the registered app","secret":false,"example_format":"short random string, e.g. aB3…","environments":["development","test","staging","production"],"from_step":"register-app"},{"name":"REDDIT_CLIENT_SECRET","description":"OAuth client secret (script and web apps)","secret":true,"example_format":"random string, e.g. xY9…","environments":["development","test","staging","production"],"from_step":"client-secret"},{"name":"REDDIT_USER_AGENT","description":"Required User-Agent string identifying the app, version and owning user","secret":false,"example_format":"web:com.example.app:v1.0.0 (by /u/…)","environments":["development","test","staging","production"],"from_step":"user-agent"}],"terms_notes":[{"kind":"rules_say","severity":"red","title":"Explicit approval before any data access","text":"Under the Responsible Builder Policy you must request access and get explicit approval before accessing any Reddit data through the API. Self-serve app registration alone is not permission.","source":"responsible-builder-policy"},{"kind":"rules_say","severity":"red","title":"Commercial use needs a separate agreement","text":"Commercial use, research beyond rate limits, or any use not expressly permitted requires a separate agreement with Reddit. You may not sell, lease or sublicense API access or derive revenue from it without Reddit's express written approval.","source":"data-api-terms"},{"kind":"rules_say","severity":"red","title":"No AI/ML training on User Content","text":"The licence does not cover using User Content to train a machine learning or AI model without the express permission of the rightsholders. On termination you must delete stored content and any models derived from it.","source":"data-api-terms"},{"kind":"rules_say","severity":"amber","title":"Do not mask user agent or OAuth identity","text":"Use the Access Info Reddit provided, and never misrepresent or mask the user agent or OAuth identity. Circumventing or exceeding limits can lead to a permanent block.","source":"data-api-terms"},{"kind":"rules_say","severity":"amber","title":"Keep only what the approved use case needs","text":"You may not use or retain data beyond your approved use case and must immediately delete any data not required for it. Reddit can revoke access at any time without notice.","source":"data-api-terms"},{"kind":"rules_say","severity":"yellow","title":"Branding and attribution","text":"Do not use Reddit trademarks in your app name or logo; you may use the form \"[name] for Reddit\". Do not imply partnership or endorsement without written approval.","source":"data-api-terms"},{"kind":"rules_say","severity":"yellow","title":"Rate limit","text":"100 queries per minute per OAuth client id, averaged over a 10-minute window. Traffic not using OAuth is blocked. Watch the X-Ratelimit-Used, X-Ratelimit-Remaining and X-Ratelimit-Reset headers.","source":"data-api-wiki"}],"pricing_notes":{"free_tier":"Approved non-commercial use within the published rate limit (100 QPM per OAuth client id)","costs":"Commercial use is under a separate agreement with Reddit; no public price list [to verify]","notes":"Reddit reserves the right to charge fees for future use of the Data APIs at its sole discretion.","source":"data-api-terms"},"stripe_projects":false,"api_provisioning":{"available":"no","notes":"No official API to register OAuth apps or request Data API access; registration is in the reddit.com/prefs/apps UI and approval is a manual review.","source":"responsible-builder-policy"},"notes":["support.reddithelp.com and reddit.com returned 403 / blocked direct fetches; Data API Wiki and Responsible Builder Policy facts come from search-index text of the official pages [to verify against the live pages].","The exact access-request form, its fields and review times are not documented in what could be read [to verify].","Whether reddit.com/prefs/apps still lets you create an app before approval is [to verify].","Reddit points developers to its Developer Platform (Devvit); moderator tools go through Devvit App Review. A Devvit route would be a separate entry.","Researchers have a separate route (Reddit for Researchers program); not covered here."]}}