GET/reddit/archive/comments/{id}/treeapiKeyNo listed credit charge
Returns a bounded nested comment tree from Arctic Shift's public archive. `t1` entries contain comments and their replies; `more` entries mark collapsed branches and include child ids/counts. Omitted parent_id requests the whole tree, while an explicitly empty parent_id requests top-level comments only. Empty archived trees return 200 with an empty comments array. Archived scores can lag changes for roughly 36 hours; slow or throttled upstream requests return 503 with Retry-After.
Required: id. Optional: parent_id, limit, start_breadth, start_depth.
Sampled 25 Oct 2026: 1 item. Filled in every item: kind, comment.
Open in Playground
GET/reddit/archive/comments/idsapiKey30 credits/request
Looks up known Reddit comment ids in Arctic Shift's historical archive. Supply 1 to 1,000 comma-separated ids; duplicates are removed, results follow input order, and missing ids are listed separately. The service sends at most two upstream requests of up to 500 ids each. Archived scores are snapshots, and removed_by_category is included when available.
Required: ids.
Sampled 25 Oct 2026: 1 item. Filled in every item: id, author, author_flair_text, created_utc, retrieved_on, subreddit, subreddit_id, score and 3 more. In the sample: created_utc: 2012-08-29; body: median 564 characters.
Open in Playground
GET/reddit/archive/comments/searchapiKey3 credits/request
Searches Arctic Shift's public historical comment archive. Supply at least one of query, author, subreddit, link_id, or parent_id; date bounds can further narrow that search. query searches comment body text and must be combined with author, subreddit, link_id, or parent_id; it maps to Arctic Shift's body parameter. Arctic Shift may time out or throttle broad searches, which return 503 with Retry-After. created_after/created_before are time boundaries, not Reddit listing cursors. Each comment includes created_utc and retrieved_on; archived scores can lag changes for roughly 36 hours. A valid query with no matches returns an empty comments array.
Optional: author, subreddit, query, link_id, parent_id, created_after, created_before, sort (2 allowed values: asc, desc), limit.
Open in Playground
GET/reddit/archive/posts/idsapiKey30 credits/request
Looks up known Reddit post ids in Arctic Shift's historical archive. Supply 1 to 1,000 comma-separated ids; duplicates are removed, results follow input order, and missing ids are listed separately. The service sends at most two upstream requests of up to 500 ids each. Archived scores and comment counts are snapshots, and removed_by_category is included when available.
Required: ids.
Sampled 25 Oct 2026: 1 item. Filled in every item: id, author, author_fullname, created_utc, retrieved_on, subreddit, subreddit_id, score and 8 more. In the sample: created_utc: 2026-10-03; url: i.redd.it; over_18: true in 0 of 1; spoiler: true in 0 of 1.
Open in Playground
GET/reddit/archive/posts/searchapiKey3 credits/request
Searches Arctic Shift's public historical post archive. Supply at least one of query, author, subreddit, or url; date bounds can further narrow that search. This is separate from the live Reddit search endpoint. created_after/created_before are time boundaries, not Reddit listing cursors; posts include created_utc and retrieved_on so callers can see when the archive captured each record. Archived scores and comment counts can lag changes for roughly 36 hours. A valid query with no matches returns an empty posts array. Slow or throttled upstream searches return 503 with Retry-After.
Optional: query, author, subreddit, url, url_exact, created_after, created_before, sort (2 allowed values: asc, desc), limit.
Open in Playground
GET/reddit/archive/subreddits/searchapiKey3 credits/request
Searches Arctic Shift's native subreddit directory by name prefix. Directory metadata is updated infrequently; subscriber counts are archived snapshots and retrieved_on indicates when the source captured the entry. The selectable fields are limited to the verified public directory fields.
Required: query. Optional: min_subscribers, max_subscribers, over_18, sort_by (3 allowed values: created_utc, subscribers, subreddit), sort (2 allowed values: asc, desc), limit.
Sampled 25 Oct 2026: 20 items. Filled in every item: display_name, id, created_utc, retrieved_on, subscribers, over_18. In the sample: created_utc: 2015-12-11 to 2026-09-07; retrieved_on: 1,739,566,084 to 1,791,746,063, median 1,739,604,637; over_18: true in 0 of 20; subscribers: 8 to 2,239,919, median 91.
Open in Playground
GET/reddit/archive/time-seriesapiKey3 credits/request
Returns Arctic Shift's native time-series values. Supply an absolute creation-time range and a precision; ranges that could exceed 1,000 points are rejected. Counts, score sums, and retrieval-delay sums are archive metrics, not current Reddit totals. Arctic Shift says time-series data may be approximate and take hours or days to update.
Required: metric (7 allowed values: posts_count, comments_count, posts_score_sum, comments_score_sum, posts_retrieval_delay_seconds_sum, comments_retrieval_delay_seconds_sum, subreddit_subscribers), precision (7 allowed values: year, quarter, month, week, day, hour, minute), created_after, created_before. Optional: subreddit.
Open in Playground
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}/postsapiKey5 credits/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