Skip to content

Reddit API application

A Reddit API application asks Reddit to approve your app for a token. Reddit reviews each request against its Responsible Builder Policy, so describe a clear, specific use case. If approval does not come, a read-only hosted API is the fallback.

Reddit api application: an applicant at a small clerk window handing over a neatly written form.

The job

Read the policy, describe what your app does, name the data you read and why, say how you store and protect it, and register the app. Reddit decides case by case, and timelines vary. The guide to getting a Reddit API key tracks the current process and dates, and Reddit API credentials explains the client ID, secret and token you receive.

An application does better with a narrow purpose, read-only use where that is true, no resale of Reddit content, and a way for users to remove their data. Vague goals, bulk collection and anything that looks like training a model without permission count against it.

Searches for a Reddit app API usually mean the app you register at Reddit to get a client ID and secret. That app is what the application approves. If you only need to read public posts and comments, a hosted read-only API skips the application. See Reddit API alternatives.

How it works

  1. Read the policy

    Know what Reddit allows before you write the request.

  2. Write a specific use case

    Say what the app does, what it reads and why, and how you store and protect the data.

  3. Register and wait

    Submit the app. If approval is slow or declined, use a read-only route in the meantime.

Endpoints that do it

EndpointWhat it's forCredits
Search postsGET /v1/reddit/searchA read-only call that needs no application.2 credits
Get a subredditGET /v1/reddit/subreddits/{name}Community details without a Reddit app.2 credits
Get a thread with commentsGET /v1/reddit/threads/{id}A post with its comments.3 credits

Free tools for the same job

Try the job in a browser first. These tools call the same endpoints, and you don't need a key or any code.

A read-only call that needs no application

A hosted search call. It uses one key and no Reddit app.

curl "https://api.chatterapi.com/v1/reddit/search?q=best+crm+for+small+business&time=year" \
  -H "Authorization: Bearer $CHATTERAPI_KEY"
response, first 2 rows
{
  "data": [
    {
      "id": "1wdihhj",
      "fullname": "t3_1wdihhj",
      "title": "What CRM should a small business use?",
      "body": "We’re a small B2B business with 6 people and sales is still pretty founder led, but revenue has grown enough that keeping leads, follow ups and customer conversations spread across spreadsheets and inboxes is starting to…",
      "author": "NotedWhisky",
      "subreddit": "CRM",
      "permalink": "/r/CRM/comments/1wdihhj/what_crm_should_a_small_business_use/",
      "url": "https://www.reddit.com/r/CRM/comments/1wdihhj/what_crm_should_a_small_business_use/",
      "externalUrl": null,
      "score": 51,
      "numComments": 186,
      "upvoteRatio": null,
      "createdAt": "2026-09-11T14:52:16.000Z",
      "nsfw": false,
      "locked": null,
      "media": null
    },
    {
      "id": "1vmy4xb",
      "fullname": "t3_1vmy4xb",
      "title": "If You Had to Pick the Best CRM for Small Business Today, What Would It Be?",
      "body": "I've spent the last few days reading reviews and watching videos, and somehow I'm even more undecided than when I started.\n\nEvery CRM looks amazing on its website, but that doesn't tell you what it's like after you've be…",
      "author": "Living_Dependent242",
      "subreddit": "CRMSoftware",
      "permalink": "/r/CRMSoftware/comments/1vmy4xb/if_you_had_to_pick_the_best_crm_for_small/",
      "url": "https://www.reddit.com/r/CRMSoftware/comments/1vmy4xb/if_you_had_to_pick_the_best_crm_for_small/",
      "externalUrl": null,
      "score": 10,
      "numComments": 56,
      "upvoteRatio": null,
      "createdAt": "2026-08-13T02:25:31.000Z",
      "nsfw": false,
      "locked": null,
      "media": null
    }
  ],
  "page": {
    "nextCursor": "AX-v…",
    "hasMore": true
  }
}

Recorded from a live call on . Long text is shortened and the cursor is cut. A live key is charged 2 credits for this call. A test key returns this same sample for 0 credits.

What it won't do

  • This page cannot speed up or guarantee an approval. Reddit decides.
  • Reddit is read-only here. Posting and voting need your own approved app.
  • Check Reddit's current policy before you apply.

Questions

What is a Reddit app API?
It is the app you register with Reddit to get a client ID, secret and token. Reddit now reviews that request before it gives access. If you only read public data, you can skip registering an app by using a hosted read-only API.
How do I apply for Reddit API access?
Read the Responsible Builder Policy, then submit an application that states your use case. See how to get a Reddit API key.
What should the application say?
What the app does, which data it reads and why, and how you store and protect it. Keep it specific.
What if I am not approved?
Use a read-only hosted API for public data, or look at the alternatives.

More ways to use the API

Build it with one API key

Try it free for 7 days with 1,000 credits.