{"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"},"id":"reddit/data-api","name":"Reddit Data API","vendor":"Reddit","status":"researched","last_verified":null,"last_researched":"2026-10-25","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.","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."}],"identity_requires":[],"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_url":"https://redditinc.com/policies/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_url":"https://redditinc.com/policies/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","gate":"human_login","human_only":true,"gate_label":"You sign in","depends_on":[],"optional":false,"url":"https://www.reddit.com/login/","lead_time":null,"preflight":[],"captures":null},{"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","gate":"human_terms","human_only":true,"gate_label":"You accept the terms","depends_on":["account"],"optional":false,"url":"https://support.reddithelp.com/hc/en-us/articles/42728983564564-Responsible-Builder-Policy","lead_time":null,"preflight":[],"captures":null},{"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","gate":"third_party_review","human_only":true,"gate_label":"The provider reviews it","depends_on":["read-policy"],"optional":false,"url":"https://support.reddithelp.com/hc/en-us/requests/new","lead_time":{"official":{"text":"No review time published [to verify]","source_url":"https://support.reddithelp.com/hc/en-us/articles/42728983564564-Responsible-Builder-Policy","source_title":"Reddit Help – Responsible Builder Policy"},"reported":null,"typical_minutes":null},"preflight":[],"captures":null},{"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","gate":"human_submit","human_only":true,"gate_label":"You press submit","depends_on":["request-access"],"optional":false,"url":"https://www.reddit.com/prefs/apps","lead_time":null,"preflight":[],"captures":"REDDIT_CLIENT_ID"},{"id":"client-secret","title":"Copy the client secret","summary":"Copy the secret from the app card (installed apps have no secret).","route":"guided","gate":"none","human_only":false,"gate_label":null,"depends_on":["register-app"],"optional":false,"url":"https://www.reddit.com/prefs/apps","lead_time":null,"preflight":[],"captures":"REDDIT_CLIENT_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","gate":"none","human_only":false,"gate_label":null,"depends_on":["register-app"],"optional":false,"url":null,"lead_time":null,"preflight":[],"captures":"REDDIT_USER_AGENT"}],"gates":[{"step":"account","gate":"human_login","label":"You sign in"},{"step":"read-policy","gate":"human_terms","label":"You accept the terms"},{"step":"request-access","gate":"third_party_review","label":"The provider reviews it"},{"step":"register-app","gate":"human_submit","label":"You press submit"}],"lead_times":[{"step":"request-access","what":"Request Data API access","official":{"text":"No review time published [to verify]","source_url":"https://support.reddithelp.com/hc/en-us/articles/42728983564564-Responsible-Builder-Policy","source_title":"Reddit Help – Responsible Builder Policy"},"reported":null}],"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"]},{"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"]},{"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"]}],"renewals":[],"estimated_minutes":null,"guide_url":"https://verapli.com/guides/reddit/data-api"}