How to choose a Reddit API
Reading Reddit by code used to mean one free API. With public access closing in stages, this guide compares the options that remain and what to check in each.
By PrimaryAPIReviewed
What changed in 2026
Approval was already required under Reddit’s Responsible Builder Policy. Since 2026-10-31, Reddit takes no new requests for public Data API access at all.
Two more dates follow: unregistered apps lose access from 2027-01-12, and what is left of public access ends in March 2027. If your product depends on the free tier, plan its replacement before then.
Four ways to read Reddit data
Each option suits a different kind of project.
- Reddit’s Data API: direct and documented, for apps Reddit has approved. Commercial use needs written approval and a contract, and public access ends in March 2027.
- Reddit’s Developer Platform (Devvit): for apps that run inside Reddit, such as mod tools and games. It issues no external API key.
- Writing your own collector: you decide what to keep, and you repair it whenever Reddit’s pages change.
- Calling a data API, for example PrimaryAPI: one key and JSON responses for subreddits, posts, comments, search and profiles, paid per call.
Match the API to the job
Common Reddit jobs, and the PrimaryAPI APIs that fit them:
- Brand and topic monitoring: Reddit Search sorted by new with a time window, or Reddit Subreddit Search inside one community.
- Community research: Reddit Subreddit Posts for hot, new or top posts, and Reddit Subreddit Details for the description, creation date and weekly active users.
- Thread analysis: Reddit Post for the post itself, then Reddit Post Comments for the discussion.
- User research: Reddit Profile for karma, bio and account age, and Reddit User Posts for what the user submitted.
- Trend spotting: Reddit Trending Posts for what is popular across Reddit right now.
Reading comment threads
A Reddit thread is a tree of replies. Reddit Post Comments returns it flattened depth-first, with each comment’s parent ID, depth, score and timestamp.
Rebuild the tree from parent IDs, or filter on depth to keep only top-level comments. Pass nextCursor back as the cursor to read the next page of a long thread.
Making your first Reddit call
Sign up, copy your key and send a search term to the Reddit Search API. Reddit’s own operators, such as subreddit: and author:, work inside the query.
The API page documents every input and output field with an example. If an AI agent will make the calls, point it at the MCP server or SKILL.md; it uses the same key.