Skip to content

Structured Reddit data: send subreddits. Cursor-paginated, 1 credit per successful call.

GET · POST1 credit / successful callCursor-paginated
GEThttps://api.scrapier.io/api/v2/reddit-subreddit-posts/Open in Playground

Call GET /api/v2/reddit-subreddit-posts/ with subreddits. The results are in data.posts; send data.next_cursor back as cursor to get the next page. 7 optional parameters refine the call (see Parameters).

Terminal window
curl -G "https://api.scrapier.io/api/v2/reddit-subreddit-posts/" \
-H "X-API-Key: YOUR_API_KEY" \
--data-urlencode "subreddits=AbsoluteUnits" \
--max-time 210
NameTypeRequiredDefaultDescription
X-API-Key headerstringyes—Your API key from the dashboard.
subredditsstringyese.g. AbsoluteUnitsSubreddit name ("AbsoluteUnits"), "r/AbsoluteUnits" or a full reddit.com/r/AbsoluteUnits/ URL (case-insensitive) -> ONE native Reddit Listing page per call (limit posts, default 25) in listing order, each row with the post's engagement metrics, author, flair, selftext, media URL, permalink and the subreddit info block. A private / banned / quarantined / premium-only / unknown / empty subreddit answers one status row (next_cursor null). Required on the first call; ignored when cursor is supplied.
cursorstringno—Pagination cursor returned in the previous response's next_cursor. Pass it back unchanged to fetch the next page. When next_cursor is null, you have reached the last page.
afterstringno—First call only: start the walk at a Reddit post fullname ("t3_1w05sdh" or the bare id) instead of the top of the listing. Later pages come from cursor (which carries Reddit's own after).
sortstringnohothot (default) | new | top | rising | controversial | best.
hotnewtoprisingcontroversialbest
locked in cursor
timeframestringno—Window for sort=top / controversial (empty = Reddit's default, day).
hourdayweekmonthyearall
locked in cursor
trimbooleannotruetrue = the reference post fields only; false = + every other field Reddit returns for the post (~110 keys).
locked in cursor
limitintegerno25Posts per page = one Reddit Listing call, 1..100 (default 25); larger values are clamped to 100 with a note in warnings.
locked in cursor
include_subreddit_infobooleannotrueAttach the subreddit info block (subscribers, weekly_active_users, rules, icons ...) to every row: /about + /about/rules + one community page load on the first call; continuation pages reuse the weekly stats carried in the cursor.
locked in cursor
Advanced
NameTypeDefaultDescription
use_proxybooleantrueRoute the request through Scrapier's residential proxy pool. Default: true. Leave as is unless support tells you otherwise.
raw_databooleanfalseWhen true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under raw_responses, in place of the formatted items. When false (default) you get the formatted output. Pagination (cursor / next_cursor) works the same in both modes.
{
"success": true,
"data": {
"subreddits": "AbsoluteUnits",
"subreddit": "AbsoluteUnits",
"sort": "top",
"timeframe": "month",
"status": "ok",
"note": null,
"page": 1,
"page_size": 2,
"after": null,
"next_after": "t3_1w12kzi",
"has_more": true,
"posts": [
{
"input_subreddit": "AbsoluteUnits",
"subreddit": "AbsoluteUnits",
"status": "ok",
"position": 1,
"post_id": "1wb8slx",
"post_url": "https://www.reddit.com/r/AbsoluteUnits/comments/1wb8slx/of_a_polar_bear_literally_trying_to_figure_out/",
"id": "1wb8slx",
"author": "DarthiusFatticus",
"author_fullname": "t2_5t81wgdhd",
"title": "of a polar bear. Literally trying to figure out how to eat them.",
"link_flair_text": "/r/all",
"selftext": null,
"selftext_html": null,
"downs": 0,
"name": "t3_1wb8slx",
"upvote_ratio": 0.97,
"ups": 57502,
"total_awards_received": 0,
"score": 57502,
"created": 1788920629,
"created_utc": 1788920629,
"created_at_iso": "2026-09-09T02:23:49.000Z",
"num_comments": 2848,
"url": "https://v.redd.it/zbef9p7fneoh1",
"permalink": "/r/AbsoluteUnits/comments/1wb8slx/of_a_polar_bear_literally_trying_to_figure_out/",
"subreddit_subscribers": 2138337,
"is_video": true,
"over_18": false,
"spoiler": false,
"domain": "v.redd.it",
"subreddit_id": "t5_a7wuv",
"post_hint": "hosted:video",
"sort": "top",
"timeframe": "month",
"subreddit_info": {
"subreddit_id": "t5_a7wuv",
"display_name": "AbsoluteUnits",
"weekly_active_users": 2104672,
"weekly_contributions": 23960,
"subscribers": 2138336,
"created_at": "2018-01-05T10:35:24.000Z",
"title": "Lads that you’re in awe at the size of.",
"subreddit_type": "public",
"...": "(rules, description, header_img, icon_img, advertiser_category, submit_text, url, is_nsfw, language, rules_list)"
},
"pagination": {
"page": 1,
"after_sent": null,
"next_after": "t3_1w12kzi",
"has_more": true,
"next_cursor": "t3_1w12kzi"
},
"scraped_at": "2026-09-21T11:31:34.910Z"
},
{
"position": 2,
"post_id": "1w12kzi",
"title": "of a Bong",
"author": "Desilaundry",
"score": 51708,
"num_comments": 3905,
"url": "https://v.redd.it/eudnuq8xi6mh1",
"created_at_iso": "2026-08-28T20:55:44.000Z",
"...": "(same shape as row 1)"
}
],
"warnings": [],
"next_cursor": "eyJhIjoidDNfMXcxMmt6aSIsImxrIjp7ImxpbWl0IjoiMiIsInNvcnQiOiJ0b3AiLCJ0aW1lZnJhbWUiOiJtb250aCJ9LCJwIjoxLCJwb3MiOjIsInMiOlsidDNfMXdiOHNseCIsInQzXzF3MTJremkiXSwic3ViIjoiQWJzb2x1dGVVbml0cyJ9"
}
}

Sample from the live catalog; arrays trimmed to 3 items. Results are in data.posts.

FieldTypeExampleDescription
subredditsstringAbsoluteUnits—
subredditstringAbsoluteUnits—
sortstringtop—
timeframestringmonth—
statusstringok—
notenullnull—
pageinteger1—
page_sizeinteger2—
afternullnull—
next_afterstringt3_1w12kzi—
has_morebooleantrue—
postsarray[2 items]The results.
warningsarray[]—
next_cursorstringeyJhIjoidDNfMXcxMmt6aSIsImxrIjp7ImxpbWl0IjoiM…Pass back as cursor for the next page. null on the last page.
posts[].input_subredditstringAbsoluteUnits—
posts[].subredditstringAbsoluteUnits—
posts[].statusstringok—
posts[].positioninteger1—
posts[].post_idstring1wb8slx—
posts[].post_urlstringhttps://www.reddit.com/r/AbsoluteUnits/commen…—
posts[].idstring1wb8slx—
posts[].authorstringDarthiusFatticus—
posts[].author_fullnamestringt2_5t81wgdhd—
posts[].titlestringof a polar bear. Literally trying to figure o…—
posts[].link_flair_textstring/r/all—
posts[].selftextnullnull—
posts[].selftext_htmlnullnull—
posts[].downsinteger0—
posts[].namestringt3_1wb8slx—
posts[].upvote_rationumber0.97—
posts[].upsinteger57502—
posts[].total_awards_receivedinteger0—
posts[].scoreinteger57502—
posts[].createdinteger1788920629—
posts[].created_utcinteger1788920629—
posts[].created_at_isostring2026-09-09T02:23:49.000Z—
posts[].num_commentsinteger2848—
posts[].urlstringhttps://v.redd.it/zbef9p7fneoh1—
posts[].permalinkstring/r/AbsoluteUnits/comments/1wb8slx/of_a_polar_…—
posts[].subreddit_subscribersinteger2138337—
posts[].is_videobooleantrue—
posts[].over_18booleanfalse—
posts[].spoilerbooleanfalse—
posts[].domainstringv.redd.it—
posts[].subreddit_idstringt5_a7wuv—
posts[].post_hintstringhosted:video—
posts[].sortstringtop—
posts[].timeframestringmonth—
posts[].subreddit_infoobject{…}—
posts[].paginationobject{…}—
posts[].scraped_atstring2026-09-21T11:31:34.910Z—

Pass data.next_cursor back as cursor until it is null. Required inputs are ignored once a cursor is sent. Each page is one billed call. More in Pagination.

const url = "https://api.scrapier.io/api/v2/reddit-subreddit-posts/";
let params = { subreddits: "AbsoluteUnits" };
const items = [];
for (let page = 0; page < 10; page++) { // each page is one billed call
const res = await fetch(`${url}?${new URLSearchParams(params)}`, {
headers: { "X-API-Key": "YOUR_API_KEY" },
signal: AbortSignal.timeout(210_000),
});
const body = await res.json();
if (!res.ok) throw new Error(body.error ?? body.detail ?? `HTTP ${res.status}`);
const data = body.data;
items.push(...(data.posts ?? []));
if (!data.next_cursor) break; // null = last page
params = { cursor: data.next_cursor };
}

Failed calls are free. Branch on the HTTP status and read the message from error (or detail). Full details in Errors.

StatusMeaningRetry?Charged?
400Bad or missing input.No — fix the paramsNo
401 / 403Missing, invalid or revoked API key.No — fix the keyNo
402Out of credits (body has balance).No — top upNo
404Unknown endpoint slug.No — check the slugNo
429 / 503Busy or throttled.Yes — after Retry-AfterNo
5xxTarget site or upstream failure, or timeout.Yes — with backoffNo
  • Locked into the cursor: sort, timeframe, trim, limit, include_subreddit_info. Set them on the first call; later pages reuse them.
  • Reddit Comment Replies — Structured Reddit data: send urls. Cursor-paginated, 1 credit per successful call.
  • Reddit Post Comments — Structured Reddit data: send urls. Cursor-paginated, 1 credit per successful call.
  • Reddit Post Search — Structured Reddit data: send queries. Cursor-paginated, 1 credit per successful call.
  • Reddit Post Transcript — Structured Reddit data: send urls. Single lookup, 1 credit per successful call.