Reddit API for agents: posts and comments, one token
How an AI agent gets Reddit posts, comments and subreddit search results through looot, what each call returns, and where the data stops.
Walid Boulanouar · · 7 min read
On this page
You want Reddit data in your agent. Posts that mention your product, the comments under a thread, what a subreddit says about a problem you sell against. The usual path is a Reddit API app, a client id, a secret, a rate limit table and a script to keep running. Then the agent still needs a way to call the script.
This post shows the shorter path. Your agent calls Reddit search, subreddit search and comment endpoints through the looot catalog, with one token and a price it can read before each call. It also covers what this setup returns, what it does not, and how to keep a Reddit scraper job inside a budget.
What does a Reddit API call return through looot?
A call returns the public fields of a post or a comment as JSON: title, body text, author name, subreddit, score, comment count and the post URL. The catalog lists several providers for the same job, so your agent picks one by price and measured reliability.
The Reddit endpoints in the catalog cover these jobs:
| Job | What you send | What comes back |
|---|---|---|
| Search posts by keyword | A search phrase | Matching posts with title, subreddit, score and URL |
| Search inside one subreddit | A subreddit and a keyword | Posts and comments from that community |
| Read the comments of a post | The post URL | The comment tree with text and scores |
| Read a user's comments | A username | Recent comments by that account |
Each row is a separate endpoint, and an endpoint can have more than one provider behind it. Search for the job in plain words, not by provider name.
How do I get Reddit data without a scraper?
Skip the scraper and let the agent run catalog calls. The agent finds the endpoint for the job, reads its input fields, checks the price and runs it. You write no parsing code because the response is already named fields.
The steps your agent takes:
- Search the catalog for "reddit search posts" and "reddit post comments". Searching and inspecting are free.
- Inspect the cheapest endpoint that fits. Inspecting shows the input schema, the price and the provider.
- Run one call with a small limit and read the raw result.
- Run the rest of the batch and save the rows.
If you have not connected looot yet, the one-line setup takes a minute. A new workspace starts at zero balance, so top up before the first run.
What does a Reddit API call cost?
You pay per call, and the price depends on the provider the agent picks. The table below reads the cheapest priced endpoint for each job from the live catalog when this page loads, so it does not go stale.
For a feel of volume, what 1,000 lookups cost shows how to turn a per call price into a batch price. A single search call returns a page of posts, so a hundred keywords is a hundred calls, not ten thousand.
Which Reddit jobs work well with an agent?
The jobs that work are the ones where the agent reads a lot of text and you want a short summary. Three are worth trying first.
- Brand and product mentions. Search your product name and its common misspellings, then ask the agent to group the posts by complaint or praise. The recipe page for Reddit brand listening lays out the steps.
- Customer language. Search a problem, not a product ("cold email bounce rate", "scraping blocked"), and have the agent pull the phrases people use. Those phrases make better headlines than your own guesses.
- Thread research before you post. Pull the comments of the three biggest threads on a topic and have the agent list the questions that stay unanswered.
Reddit text is opinion. Treat the output as raw research and read the source thread before you quote anything.
Reddit scraper or Reddit API: which one is this?
It is an API in the sense that you get structured JSON back, and a scraper in the sense that the provider collects public pages for you. You do not run a scraper yourself, and you do not hold the upstream credentials. The provider handles access, and looot bills the call.
That has a trade-off. A provider can change or drop an endpoint, and the data lags the live site by whatever the provider's cache holds. If your job needs the exact current score of one post, check the post itself. For research over many posts, the lag rarely matters.
Keep to public data. Do not collect private messages, deleted content or anything behind a login, and read the platform's own terms before you build a product on top of the data. Providers differ in what they return, and the terms for the data are yours to follow.
How do I keep a Reddit job inside a budget?
Set the limit before the first call, not after the bill. Tell the agent the maximum it may spend, ask it to show any price over one cent, and have it run one small call first. A search with a page limit of ten tells you the shape of the result for the price of one call.
Then scale in steps. Run ten keywords, read the output, fix the prompt, and only then run a hundred. Most wasted spend on social data comes from a prompt that was wrong for the first thousand calls.
Also ask the agent to save every result row with the endpoint, the provider and the cost. When a number looks odd later, you can trace it to the call that produced it.
Run it: a prompt for your agent
Paste this into Claude Code, Cursor or any agent that can run shell commands.
Prompt for your agent
Reddit research
What it cannot do
- It does not post, vote or comment. The endpoints read public data only.
- It does not give you a live stream. Each call is a request you make by hand. Anything that needs a timer, such as a nightly rerun, needs scheduled runs, not available yet.
- It does not guarantee completeness. A search returns a page of results, not every post that ever matched.
- It does not return private subreddits, removed posts or user data the platform hides.
- The catalog publishes a measured success rate for some endpoints and not others. Check the endpoint page before you rely on one.
For a post that digs into Google data the same way, see the Google Maps lead guide. To see every Reddit endpoint and its price, open the public catalog.
Last checked 2026-10-03 against the live catalog. Author: Walid Boulanouar.
Questions
Keep reading
MCP vs API for agents: when each one fits
MCP and a plain API both let an agent reach outside data. What the agent handles in each, when to pick which, and a prompt to test both on your job.
Walid Boulanouar · · 5 min read
Set up looot with one line: skill.md and llms.txt
Give your agent one URL and it can set up looot itself. What skill.md and llms.txt are, what each one tells an agent, and a prompt you can paste today.
The looot team · · 3 min read
What 1,000 lookups cost: reading the looot catalog
How to work out the cost of 1,000 lookups from the live looot catalog, and why the cheapest provider is chosen per call instead of once per project.
Luisa · · 4 min read
Try it with the agent you already use
Start your workspace, top up, and paste one prompt into your agent.
