# Reddit search API for your agent

Reddit search API for an agent: it sends a search query to a catalog endpoint and reads post title, text and subreddit back. Several providers sell the call, so the agent tries the cheapest first. You pay per call, and a failed call costs nothing.

## What this does

Reddit is where buyers ask each other what to buy and complain when it fails. Your agent searches posts and comments by keyword and reads back the title, the subreddit, the score and the number of comments. It surfaces the threads where your category is discussed, and the words people use for it.

Two providers answer. One searches posts or comments across all of Reddit, with sort and time-frame options, and returns the fields a reader needs: title, author, text, subreddit, score, upvote ratio, comment count and link. The other runs the dynamic search of the Reddit app and covers posts, communities, comments, media and users.

You give: a search query. Example: best crm for startups.

## What differs between providers

- Scrape Creators API (scrapecreators-reddit-search): searches posts or comments across all of Reddit, with sort and time-frame options, and returns title, author, text, subreddit, score, upvote ratio, comment count and link.
- TikHub (tikhub-api-reddit-app-fetch-dynamic-search): runs the Reddit app's dynamic search over posts, communities, comments, media and users, with sort, time range and paging.

## Before you start

- Choose posts or comments. Posts give the thread, and comments give the opinions inside it.
- Set a time window. A thread from three years ago ranks well but may describe a product that no longer exists.
- Read before you reply. Reddit is strict about promotion, and your agent should only collect the research.

## Prompt

Use looot to search Reddit for best crm for startups over the last month and return the title, subreddit, score, comment count and link of the top posts. 1. Set up https://looot.ai/skill.md. 2. Search the catalog for each step and check its price before you call. 3. Run the cheapest endpoint that fits. 4. Show the results as a table and the total cost.

## Steps and providers

- Search Reddit: scrapecreators, tikhub. 1 call per search.

## What comes back

- Post title and text
- Subreddit
- Score and upvote ratio
- Comment count
- Link

## The request and what comes back

Each run is one POST to /v1/runs with an endpoint id and an input. These are illustrative calls with generic values. The run's result holds the provider's own fields.

- Scrape Creators API: {"endpointId":"scrapecreators-reddit-search","input":{"query":"best crm for startups","timeframe":"month"},"wait":30}

## What can I do with the results?

Read the threads where buyers compare tools, copy the words they use for the problem and note which alternatives they name. Your agent can group the threads by subreddit and rank them by score and comment count.

## How current are the results?

A search reads Reddit as it is at the time of the call, and you can restrict the time window. Use a short window for what people say now and a long one for the threads that rank over time.

## How do I search Reddit by keyword?

Send the keyword to a Reddit search endpoint. Your agent reads the posts with their subreddit, score and comment count, and can open the comments of the best threads.

## Can I search comments as well as posts?

Yes. The first provider's filter switches between posts and comments, and the second covers comments, communities, media and users.

## Can I search inside one subreddit?

The catalog has subreddit endpoints and a search that finds subreddits by name. Ask your agent to look them up and show the price first.

## Does it return the full comment thread?

A post search returns the post. Your agent fetches the comments of a post with a second endpoint, and each fetch is billed as a call.

## How much does one search cost?

You pay per call, and the price depends on the provider your agent picks. This page reads the cheapest live price from the catalog and shows no number when the catalog is unreachable.

## Do I pay when a reddit search call fails?

No. A call that fails at the provider costs nothing, and your agent can retry it or send it to another provider.

## Do I need an account with each reddit search provider?

No. One looot key reaches every provider in the catalog. You top up once, and each call is billed at the price shown before it runs.

## How do I call reddit search from code?

Send a POST to /v1/runs with the endpoint id, the input and a new idempotency key, and your looot token in the Authorization header. With wait set to 30, the answer comes back in the response when the run ends within 30 seconds. Otherwise poll GET /v1/runs/<runId>.

## Can I run reddit search on a schedule?

That needs scheduled runs, not available yet. Run it by hand whenever you want fresh results.

## Do I pay while my agent is idle?

No. looot bills per call, and nothing runs while your agent is idle.

## Related pages

- /use-cases/twitter-search-api
- /use-cases/linkedin-post-search-api
- /use-cases/youtube-comments-api

## Last reviewed

2026-10-04. The cost per 1,000 search runs is read live from the catalog on the web page.
