reddit-search
Reddit's search results as posts: title, the post's page, what it links to, score, comment count, author, time, flair and the first 300 characters of the text. Site-wide, or inside one subreddit. sort relevance, hot, top, new or comments; t the window for top; limit up to 250. Without session it reads Reddit's public search feed (1 to 3 s per 100 posts; the feed has no score, comment count or flair, so those are null). With session (your reddit_session cookie, used for this run only, never stored) every column is filled.
Recipes are not open yet.
What this recipe returned on its last run. No key needed to look.
Fields
11 columns on every row. null means the site does not state it.| field | type | meaning |
|---|---|---|
| title | string | The post's title. |
| url | string | The post's own page on Reddit. |
| link | string | What the post points at: an outside link, or the post's own page for a text post; null on the second source. |
| score | integer | The post's score (upvotes minus downvotes) when read. |
| comments | integer | How many comments the post has, as Reddit counts them. |
| author | string | The author's Reddit name, without u/. |
| created | string | When the post was published, ISO 8601 UTC. |
| flair | string | The post's flair text; null when it has none. |
| subreddit | string | The subreddit's name, without r/. |
| id | string | Reddit's id of the post (without t3_). |
| text | string | The first 300 characters of a text post's body; empty for a link post. |
null means the site does not state it.
How it behaves
Cost. 1-3 units per 100 posts; or records. A failed run costs 0.
Freshness 5 min. The same input within 5 min is served from cache at 0 units.
How it answers. Answers at once for one input; a large run goes as a job you poll.
Questions about this recipeQuestions
Short answers. The API reference has the long ones.
Call POST /recipes/reddit-search with your key and query and subreddit and sort. You get rows with the 11 fields above. The recipe is tested against the live site every 6 hours.
1-3 units per 100 posts; or records. A failed run costs 0. The same input within 5 min costs 0.
Yes. Sign up with Google, GitHub or email for a free key with 1,000 credits every month. No credit card.
The health check runs every 6 hours against the live site. A failing recipe shows as failing on this page until we fix it.
Extra fields, higher volume, or a private copy with a freshness SLA. We build it on Enterprise.
Request a changeMore for market research
All 9 recipes →The products on an Amazon search results page: ASIN, title, price, star rating, review count, the product's link, image, and whether the…
Headlines for a query from Google News: title, the publishing source, Google's link to the article, time and a short summary.
The places Google Maps lists for a search, in Google's order, one row per place: name, place id and cid, category, address, map point…
For developers
Get a free API key and run your first crawl.
1,000 credits every month. No credit card. Your self-hosted setup keeps working.
For teams
Talk to us about volume, regions and an SLA.
A 30-minute call with the team that writes the crawler. DPA on request, invoice billing, your choice of US, EU or Singapore.