GET/reddit/comments/{id}apiKey1 credit default · 3 with metrics
Returns a Reddit post with its public comments. The default mode is 1 credit. Set `include_metrics=true` to return the comments with public net score and award count plus post engagement metrics for 3 credits. Large threads may expose only an initial comment subset. Reddit does not expose per-comment upvote ratios or exact upvote/downvote totals anonymously. A post that exists but has no comments yet returns a 200 response with an empty comments list; a post that does not exist returns 404, and a temporary block or upstream failure returns 503 (retryable) rather than 404. If source.type is redlib, public fields and credit weights are preserved.
Required: id. Optional: sort (6 allowed values: confidence, top, new, controversial, old, qa), limit, depth, include_metrics.
Sampled 14 Oct 2026: 3 items. Filled in every item: id, name, parent_id, author, body, permalink, score, award_count and 2 more. Not in every item: depth (2). In the sample: created_utc: 2026-05-22; score: 2 to 8, median 2; permalink: reddit.com; body: median 111 characters; created: 2026-05-22; depth: 1 to 2, median 1.
Open in Playground
GET/reddit/domain/{domain}/postsapiKeyNo listed credit charge
Returns public posts submitted from a linked domain. A `503` with a `Retry-After` header means Reddit is temporarily throttling the request; wait that many seconds and retry. If source.type is redlib, public fields and credit weights are preserved.
Required: domain. Optional: sort (4 allowed values: hot, new, top, rising), time (6 allowed values: hour, day, week, month, year, all), limit, after.
Sampled 14 Oct 2026: 20 items. Filled in every item: id, name, subreddit, title, url, permalink, author, created_utc and 3 more. In the sample: created_utc: 2026-10-06 to 2026-10-10; url: reddit.com; permalink: reddit.com; created: 2026-10-06 to 2026-10-10; source_feed_url: reddit.com.
Open in Playground
GET/reddit/leadsapiKey25 credits/request
Scans a Reddit search page for people actively asking for a product or service, scores each post 0-10 for buying intent, and returns them ranked highest-first with the signals that fired. Self-promotion, hiring posts, freelancer service adverts, revenue-milestone posts, duplicate reposts, and Title Case article headlines are filtered out before scoring. A deterministic prefilter always runs; when `classifier` resolves to `llm` the surviving candidates are additionally refined in one batched model call. A `503` with a `Retry-After` header means Reddit is temporarily throttling the request; wait that many seconds and retry. The lead-response fields and credit weights are preserved regardless of the underlying Reddit data source.
Required: q. Optional: subreddit, sort (5 allowed values: relevance, hot, new, top, comments), time (6 allowed values: hour, day, week, month, year, all), limit, min_score, classifier (3 allowed values: auto, heuristic, llm).
Sampled 14 Oct 2026: 1 item. Filled in every item: score, signals, title, subreddit, author, permalink, created. In the sample: created: 2026-09-30; permalink: reddit.com; signals: median 1 entry.
Open in Playground
GET/reddit/post/{id}apiKey1 credit default · 3 with metrics
Returns a public Reddit post. The default mode is 1 credit. Set `include_metrics=true` to return public net score, upvote ratio, comment count, award count, and estimated upvote/downvote totals for 3 credits. Reddit fuzzes voting data, so estimates are approximate; share, repost/crosspost, and view counts are not exposed anonymously. If source.type is redlib, public fields and credit weights are preserved.
Required: id. Optional: include_metrics.
Sampled 14 Oct 2026: 25 fields returned with a value. In the sample: post.created_utc: 2026-07-28; post.score: 17,312; post.url: reddit.com; post.vote_counts_estimated: true; post.title: 119 characters; post.permalink: reddit.com; post.upvote_ratio: 0.94; post.estimated_upvotes: 18,492.
Open in Playground
GET/reddit/searchapiKey1 credit/request
Searches public Reddit content and returns public post entries. A `503` with a `Retry-After` header means Reddit is temporarily throttling the request; wait that many seconds and retry. If source.type is redlib, public fields and credit weights are preserved.
Required: q. Optional: subreddit, sort (5 allowed values: relevance, hot, new, top, comments), time (6 allowed values: hour, day, week, month, year, all), limit, after.
Sampled 14 Oct 2026: 20 items. Filled in every item: id, name, subreddit, title, url, permalink, author, created_utc and 3 more. In the sample: created_utc: 2025-05-04 to 2026-10-04; url: reddit.com; permalink: reddit.com; created: 2025-05-04 to 2026-10-04; source_feed_url: reddit.com.
Open in Playground
GET/reddit/subreddit/{subreddit}/aboutapiKey1 credit/request
Returns public metadata and sample posts for a subreddit. Subscriber counts, icons, and banners are omitted because they are not available on anonymous Reddit pages. A `503` with a `Retry-After` header means Reddit is temporarily throttling the request; wait that many seconds and retry. If source.type is redlib, public fields and credit weights are preserved.
Required: subreddit. Optional: limit.
Sampled 14 Oct 2026: 20 items. Filled in every item: id, name, subreddit, title, url, permalink, author, created_utc and 3 more. In the sample: created_utc: 2026-09-03 to 2026-10-13; url: reddit.com; permalink: reddit.com; created: 2026-09-03 to 2026-10-13; source_feed_url: reddit.com.
Open in Playground
GET/reddit/subreddit/{subreddit}/commentsapiKey1 credit/request
Returns flat public comment entries from a subreddit latest-comments feed. A `503` with a `Retry-After` header means Reddit is temporarily throttling the request; wait that many seconds and retry. If source.type is redlib, public fields and credit weights are preserved.
Required: subreddit. Optional: limit, after.
Sampled 14 Oct 2026: 20 items. Filled in every item: id, name, parent_id, author, body, permalink, created_utc, created. In the sample: created_utc: 2026-10-13; permalink: reddit.com; body: median 230 characters; created: 2026-10-13.
Open in Playground
GET/reddit/subreddit/{subreddit}/postsapiKey1 credit/request
Returns public posts from a subreddit. A `503` with a `Retry-After` header means Reddit is temporarily throttling the request; wait that many seconds and retry. If source.type is redlib, public fields and credit weights are preserved.
Required: subreddit. Optional: sort (4 allowed values: hot, new, top, rising), time (6 allowed values: hour, day, week, month, year, all), limit, after.
Sampled 14 Oct 2026: 20 items. Filled in every item: id, name, subreddit, title, url, permalink, author, created_utc and 3 more. In the sample: created_utc: 2026-09-03 to 2026-10-13; url: reddit.com; permalink: reddit.com; created: 2026-09-03 to 2026-10-13; source_feed_url: reddit.com.
Open in Playground
GET/reddit/subreddits/postsapiKey1 credit/request
Returns public posts from a combined multi-subreddit feed. A `503` with a `Retry-After` header means Reddit is temporarily throttling the request; wait that many seconds and retry. If source.type is redlib, public fields and credit weights are preserved.
Required: subreddits. Optional: sort (4 allowed values: hot, new, top, rising), time (6 allowed values: hour, day, week, month, year, all), limit, after.
Sampled 14 Oct 2026: 20 items. Filled in every item: id, name, subreddit, title, url, permalink, author, created_utc and 3 more. In the sample: created_utc: 2026-10-12 to 2026-10-13; url: reddit.com; selftext: median 226 characters; permalink: reddit.com; created: 2026-10-12 to 2026-10-13; source_feed_url: reddit.com.
Open in Playground
GET/reddit/trendsapiKey1 credit/request
Returns public posts from broad Reddit hot, new, rising, or top feeds. For subreddit-specific trends, use `/reddit/subreddit/{subreddit}/posts` with `sort=hot`, `sort=new`, `sort=rising`, or `sort=top`. A `503` with a `Retry-After` header means Reddit is temporarily throttling the request; wait that many seconds and retry. If source.type is redlib, public fields and credit weights are preserved.
Optional: sort (4 allowed values: hot, new, rising, top), time (6 allowed values: hour, day, week, month, year, all), limit, after.
Sampled 14 Oct 2026: 20 items. Filled in every item: id, name, subreddit, title, url, permalink, author, created_utc and 3 more. In the sample: created_utc: 2026-10-13; url: reddit.com; permalink: reddit.com; created: 2026-10-13; source_feed_url: reddit.com.
Open in Playground
GET/reddit/user/{username}/commentsapiKey1 credit/request
Returns flat public comment entries from a public Reddit user's comments feed. A `503` with a `Retry-After` header means Reddit is temporarily throttling the request; wait that many seconds and retry. If source.type is redlib, public fields and credit weights are preserved.
Required: username. Optional: limit, after.
Sampled 14 Oct 2026: 20 items. Filled in every item: id, name, parent_id, author, body, permalink, created_utc, created. In the sample: created_utc: 2021-12-06 to 2025-06-11; permalink: reddit.com; body: median 107 characters; created: 2021-12-06 to 2025-06-11.
Open in Playground
GET/reddit/user/{username}/postsapiKey1 credit/request
Returns public posts from a public Reddit user's submitted feed. A `503` with a `Retry-After` header means Reddit is temporarily throttling the request; wait that many seconds and retry. If source.type is redlib, public fields and credit weights are preserved.
Required: username. Optional: limit, after.
Sampled 14 Oct 2026: 20 items. Filled in every item: id, name, subreddit, title, url, permalink, author, created_utc and 3 more. In the sample: created_utc: 2021-12-12 to 2026-04-03; url: reddit.com; selftext: median 122 characters; permalink: reddit.com; created: 2021-12-12 to 2026-04-03; source_feed_url: reddit.com.
Open in Playground