Reddit

How to get a Reddit API key (2026)

How Reddit API keys work in 2026: free vs commercial access, OAuth apps, rate limits, and when a public-data API is simpler.

Social FetchUpdated

How to get a Reddit API key (2026)

How Reddit API keys work in 2026: free vs commercial access, OAuth apps, rate limits, and when a public-data API is simpler.

"Reddit API key" search usually means one of two things: Reddit's official OAuth credentials for a client under Reddit's terms, or a third-party key that returns public subreddits, posts, comments, and search as JSON. Mixing those up is how teams wait weeks on an approval ticket for a research cron that only needed public search.

Need a Reddit-native client, mod tools, or first-party compliance? Register a Reddit app and follow Reddit's Data API process. Need public research or multi-platform monitoring without OAuth? Create a Social Fetch sfk_… key and call /v1/reddit/*. Smoke-test a query first with the free Reddit research tool. This guide covers both paths — how official keys work, what "free" and rate limits actually mean in 2026, and when a Social Fetch key is the shorter path for public enrichment.

Two different products named "Reddit API"

NeedOfficial Reddit Data APISocial Fetch Reddit routes
Reddit client / bots under Reddit ToSYesWrong product
Public subreddit cards, search, commentsYes (with access)Yes
Instant self-serve key for enrichmentOften noYes
Same envelope as TikTok / InstagramNoYes
Private subreddits / user inboxPer Reddit scopesNo — public only
Cost modelQPM + commercial contractCredits per completed lookup

Glossary context: Does Reddit have an API?. Platform routes and examples: Reddit hub.

How to get an official Reddit API key

Reddit's developer flow still starts with an account and an app registration. High level:

  1. Create or use a Reddit account that will own the app.
  2. Open Reddit's app preferences / developer settings and register an application (script, web app, or installed app — pick the type that matches how you will call OAuth).
  3. Note the client id and secret Reddit issues for that app.
  4. Implement OAuth for the scopes your product needs. Read-only public data still uses Reddit's auth model for the official API.
  5. If your use is commercial (selling monitoring, enrichment, or a customer-facing Reddit feature under Reddit's commercial rules), treat approval and contract terms as part of onboarding — not a checkbox after you ship.

Self-serve registration has tightened over the last few years. Expect delays, rejection risk, and policy changes. For personal scripts and approved non-commercial bots, PRAW is still a common Python wrapper on top of the same official endpoints — it does not unlock a free commercial entitlement.

This is not a ToS-bypass guide. If Reddit's rules say you need their commercial path, use it. If you only need public posts that anyone can open in a browser, a public-data API is a different product category — see the Social Fetch section below.

Is the Reddit API free?

Yes — and a few production details matter:

  • Approved non-commercial use often has a free tier. Teams commonly cite about 100 queries per minute per OAuth client. That is a rate ceiling, not "unlimited research for a SaaS."
  • Commercial use is a separate approval and pricing path. Published figures teams quote for commercial access are often around $0.24 per 1,000 API calls when access is granted — verify against Reddit's current commercial terms before you model a budget.
  • Free ≠ commercial monitoring. Brand-listening products, customer-facing enrichment, and paid research tools usually fall outside the free non-commercial story.

Deeper cost math and vendor alternatives: Reddit API pricing and the Best Reddit Data APIs roundup.

Reddit API rate limits

On the official API, architecture follows Reddit's quotas:

  • Free / non-commercial access is commonly rate-limited around 100 QPM per OAuth client.
  • Listing endpoints often return on the order of 100 items per page, so deep comment trees and long search backfills burn quota fast.
  • Hitting the ceiling means backoff, queues, and product delays — not a soft warning in the JSON.

Social Fetch's metered /v1/reddit/* routes work differently: there is no hard requests-per-second cap on paid metered lookups. Your credit balance is the practical limit. Stay under roughly 500 concurrent requests as a courtesy for reliability. Free dashboard helpers (whoami, balance) have their own per-key limits — see Credits and Errors.

Billing rule that trips people up: Social Fetch charges on completed lookups. An empty search that finished upstream still bills. lookup_failed and 503 temporarily_unavailable do not. Trust meta.creditsCharged on every response.

When Social Fetch is the simpler key

Use Social Fetch when:

  • Reddit is one source next to TikTok, Instagram, YouTube, or X in the same product.
  • You need sync REST (GET /v1/reddit/search, comments, subreddit feeds) without standing up Reddit OAuth.
  • You want prepaid credits that do not reset on a monthly free-tier clock.
  • Public data is enough — you are not building mod tools, inbox access, or a Reddit client.
Request
bash

Create a key at API Keys (starts with sfk_). Full route list: Reddit platform page. Research sprint patterns: Reddit product research. Listening recipe: Reddit research recipe.

Stay on public content. Private or banned communities return documented miss outcomes — we do not help you reach content Reddit keeps gated.

Try a search before you wire OAuth

Before you commit to an official app or a credit pack:

  1. Run one query in the free Reddit research tool (Turnstile + IP caps; first page only).
  2. Or spend signup credits in the playground against GET /v1/reddit/search.
  3. Decide whether you need Reddit-native scopes or public enrichment. That fork decides the key you register next.

Next steps: Reddit hub · Reddit API pricing · Credits · Pricing