Reddit API getting started: first request in 5 minutes
Reddit API getting started in five minutes: make your first Reddit search request with curl and Python, plus how it compares with the official route and X's API.
Piyushh · November 13, 2026 · 3 min read

Reddit API getting started takes five minutes if you skip the developer-app route: get a key, send one GET request, read the JSON. This guide does it with curl and then Python. It ends with a short comparison against the official route and X's API, since people often start both at once.
Step 1: Get a key
Sign in at chatterapi.com/signup with Google, then open the keys page in the dashboard and copy a key. Live keys start with ca_live_. Test keys start with ca_test_ and are free: whatever you ask, they return one recorded real response per endpoint. Use a test key for this walkthrough and switch afterwards.
Put the key in an environment variable so it never ends up in your code:
export CHATTERAPI_KEY=ca_test_xxxxxxxx
Step 2: Make the first request
Search Reddit for a phrase with reddit.search.
curl "https://api.chatterapi.com/v1/reddit/search?q=best+crm+for+small+business&time=year" \
-H "Authorization: Bearer $CHATTERAPI_KEY"
Every response comes back in the same envelope: data, a page with nextCursor and hasMore, credits, requestId and cached. Below is one row of data, trimmed, from a recorded sample captured 2026-10-07:
{
"id": "1wdihhj",
"title": "What CRM should a small business use?",
"author": "NotedWhisky",
"subreddit": "CRM",
"permalink": "/r/CRM/comments/1wdihhj/what_crm_should_a_small_business_use",
"score": 51,
"numComments": 186,
"createdAt": "2026-09-11T14:52:16.000Z"
}
A search page returns about 25 posts and costs 2 credits. Failed calls aren't charged.
Step 3: The same call in Python
import os
import requests
r = requests.get(
"https://api.chatterapi.com/v1/reddit/search",
params={"q": "best crm for small business", "time": "year", "sort": "top"},
headers={"Authorization": f"Bearer {os.environ['CHATTERAPI_KEY']}"},
timeout=60,
)
r.raise_for_status()
body = r.json()
for post in body["data"][:5]:
print(post["score"], post["numComments"], post["subreddit"], post["title"])
print("more pages:", body["page"]["hasMore"])
time takes hour, day, week, month, year or all, and sort takes relevance, new, hot, top or comments. Add subreddit=SaaS to stay inside one community. For the next page, pass body["page"]["nextCursor"] back as cursor.
Step 4: Go one level deeper
Most first projects need just two more calls:
- A whole thread with comments:
reddit.thread, 3 credits. - A subreddit's recent posts:
reddit.subreddit_posts, 2 credits.
You can try any of them in a browser first with the free Reddit search tool. The Reddit API Python guide walks through threads and loops in Python, and the Reddit API complete guide covers the endpoints and data shapes.
How this compares with the official route
Reddit's own API requires an app registered with Reddit and OAuth. Our Reddit API key guide walks through the steps. Reddit has also announced it will stop accepting new public API requests on October 31, 2026, and that remaining public access ends in March 2027. The sources, and the date we checked them (2026-10-14), are in our shutdown timeline. Check Reddit's current page again before you plan to register a new app.
| Reddit's own API | Hosted API (ChatterAPI) | |
|---|---|---|
| Setup | Register an app, OAuth | Copy a key |
| Reddit developer account | Required | Not needed |
| Writes (posting, voting) | Possible with user auth | Not supported, Reddit is read-only here |
| Pricing | See Reddit API pricing | Credits, from $19 a month |
| Rate limits | Reddit's, per client id | Per plan |
If you need to post as a user or build a moderator tool, go through Reddit. If you only read data, a hosted API is enough.
Twitter API getting started, briefly
X's own API v2 is different. Its overview on docs.x.com (checked 2026-11-13) lists a base of api.x.com/2, Bearer authentication and pay-per-usage billing paid for with purchased credits. Before any of that, you create an app in X's developer console.
A hosted API works the same way it does for Reddit. To search tweets, call x.search:
curl "https://api.chatterapi.com/v1/x/tweets/search?q=%22crm%20recommendation%22&sort=latest" \
-H "Authorization: Bearer $CHATTERAPI_KEY"
Each page of about 20 tweets costs 2 credits. The Twitter API Python guide goes further and covers pagination and a script that reads both platforms.
Common first-call mistakes
- Unquoted words match anywhere in a post, which makes for a noisy query. Put a phrase in quotes, as in
"cold email". - The key goes in
Authorization: Bearer ..., not in the URL. Forgetting the header is a common miss. - Search covers what Reddit's own search returns. It is not an archive, so don't expect full history.
- One page is not everything, so don't ignore the cursor. Check
hasMore.
Make your first call free
Create a key and run the curl above. Test keys are free.