# Scrapier — Reddit API > Scrapier endpoints for Reddit: Reddit Comment Replies, Reddit Post Comments, Reddit Post Search, Reddit Post Transcript and 5 more. Base URL: https://api.scrapier.io/api/v2 · Auth: header `X-API-Key: ` · Synchronous: HTTP 200 returns {"success": true, "data": {...}} · Paginate by sending data.next_cursor back as `cursor` until it is null · Paths keep the trailing slash. Live parameter source (no auth): https://api.scrapier.io/api/v2/endpoints · Docs: https://docs.scrapier.io/api-reference/reddit.md ## GET /reddit-comment-replies/ Reddit Comment Replies: Structured Reddit data: send `urls`. Cursor-paginated, 1 credit per successful call. Cost: 1 credit per successful call · Pagination: cursor · Results: data.data · Long-running (client timeout 210 s or more) Parameters: - urls (required, string, example https://www.reddit.com/r/Whatcouldgowrong/comments/1wr71bt/ripping_through_an_intersection/): Reddit post URL, share link, or bare post id. Required on first call; ignored when `cursor` is supplied. Only the first url is honored (cursor pagination walks one post's thread at a time). One record per call: a page of top-level comment threads (with reply expansion + author avatars), nested under data.items. - cursor (optional, string): 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. - max_items (optional, integer, default 30): Top-level comment threads per page (max 300). A page can come back shorter when the per-call time budget is reached -- the cursor then resumes exactly after the last returned thread. Locked into the cursor. - sort (optional, string, one of: confidence|top|new|controversial|old|random|qa|live, default confidence): Comment sort ('best' = confidence). Locked into the cursor after the first call. - max_depth (optional, integer, default 10): Reply nesting depth requested from Reddit. Locked into the cursor. - expand_more_comments (optional, boolean, default true): Expand the "N more replies" stubs under each returned thread. Locked into the cursor. - max_more_requests (optional, integer, default 40): "More replies" request budget per page (max 100); each request returns a whole level. Locked into the cursor. - fetch_avatars (optional, boolean, default true): Resolve authors' avatar_url + display_name (profile title). Locked into the cursor. - max_avatar_lookups (optional, integer, default 30): Unique-author profile lookups per page (max 100; first authors in reading order). Locked into the cursor. - raw_data (optional, boolean, default false): When 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. Example: curl "https://api.scrapier.io/api/v2/reddit-comment-replies/?urls=https%3A%2F%2Fwww.reddit.com%2Fr%2FWhatcouldgowrong%2Fcomments%2F1wr71bt%2Fripping_through_an_intersection%2F" -H "X-API-Key: YOUR_API_KEY" Docs: https://docs.scrapier.io/api-reference/reddit/reddit-comment-replies.md ## GET /reddit-comments/ Reddit Post Comments: Structured Reddit data: send `urls`. Cursor-paginated, 1 credit per successful call. Cost: 1 credit per successful call · Pagination: cursor · Results: data.comments · Long-running (client timeout 210 s or more) Parameters: - urls (required, string, example https://www.reddit.com/r/ChatGPT/comments/1epeshq/these_are_all_ai/): Reddit post URL (or share link / redd.it / t3_). Required on first call; ignored when `cursor` is supplied. 50 comments per page, native cursor. - cursor (optional, string): 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. - reply_limit (optional, integer, default 1): Direct replies kept per comment (0 = top-level only; max 500). Locked into the cursor. - sort_order (optional, string, default hot): Comment sort: hot, best, confidence, top, new, controversial, old, qa, random, live, all. Locked into the cursor. (random reshuffles every call - not page-stable.) - raw_data (optional, boolean, default false): When 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. Example: curl "https://api.scrapier.io/api/v2/reddit-comments/?urls=https%3A%2F%2Fwww.reddit.com%2Fr%2FChatGPT%2Fcomments%2F1epeshq%2Fthese_are_all_ai%2F" -H "X-API-Key: YOUR_API_KEY" Docs: https://docs.scrapier.io/api-reference/reddit/reddit-comments.md ## GET /reddit-post-search/ Reddit Post Search: Structured Reddit data: send `queries`. Cursor-paginated, 1 credit per successful call. Cost: 1 credit per successful call · Pagination: cursor · Results: data.posts Parameters: - queries (required, string, example programming): Search term. Required on first call; ignored when `cursor` is supplied. - cursor (optional, string): 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. - sort_by (optional, string, one of: comments|hot|top|new|relevance, default comments): Sort: relevance, hot, top, new, comments. Locked into the cursor. - time_filter (optional, string, one of: hour|day|week|month|year|all, default year): Time window: hour, day, week, month, year, all. Locked into the cursor. - subreddit (optional, string): Optional: restrict the search to one subreddit (name, r/Name or URL). Locked into the cursor. - page_size (optional, integer, default 25): Posts per page (1-100). Locked into the cursor. - raw_data (optional, boolean, default false): When 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. Example: curl "https://api.scrapier.io/api/v2/reddit-post-search/?queries=programming" -H "X-API-Key: YOUR_API_KEY" Docs: https://docs.scrapier.io/api-reference/reddit/reddit-post-search.md ## GET /reddit-post-transcript/ Reddit Post Transcript: Structured Reddit data: send `urls`. Single lookup, 1 credit per successful call. Cost: 1 credit per successful call · Pagination: single lookup · Results: data.transcript Parameters: - urls (required, string, example https://www.reddit.com/r/PraiseTheCameraMan/comments/1u7xfz4/camera_guy_keeping_up_with_performance/): The Reddit post: permalink (www / old / new / np / m / sh hosts), /comments/, redd.it/, v.redd.it/, www.reddit.com/video/, a /r//s/ share link, or the bare id "1u7xfz4" / "t3_1u7xfz4" -> ONE transcript record: post metadata (title, subreddit, author, created_at, score, num_comments, video {duration, width, height, has_audio ...}), video_id, caption_url, the raw WebVTT file (vtt), the plain-text transcript, timed segments [{start, end, text}], cue_count / word_count. Single lookup: next_cursor is always null. A text / image / link post answers status no_video, an uncaptioned Reddit video status no_captions, an unknown / removed post status not_found. - cursor (optional, string): 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. - language (optional, string, default en, locked in cursor): 2-letter caption language (default en; Reddit publishes English captions only - other codes answer no_captions). - transcript_mode (optional, string, one of: reference|clean, default reference, locked in cursor): reference (default) = the hosted API's text cue for cue (with the rolling-window repeats); clean = the spoken words once. - page_fallback (optional, boolean, default true, locked in cursor): true (default) = when the conventional caption file is missing, load the post page once and follow the caption-url its player declares if it differs. false = CDN only. - raw_data (optional, boolean, default false): When 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. Example: curl "https://api.scrapier.io/api/v2/reddit-post-transcript/?urls=https%3A%2F%2Fwww.reddit.com%2Fr%2FPraiseTheCameraMan%2Fcomments%2F1u7xfz4%2Fcamera_guy_keeping_up_with_performance%2F" -H "X-API-Key: YOUR_API_KEY" Docs: https://docs.scrapier.io/api-reference/reddit/reddit-post-transcript.md ## GET /reddit-profile/ Reddit User Submitted Posts: Structured Reddit data: send `users`. Cursor-paginated, 1 credit per successful call. Cost: 1 credit per successful call · Pagination: cursor · Results: data.posts · Long-running (client timeout 210 s or more) Parameters: - users (required, string, example spez): Reddit username: name, u/name or profile URL. Required on first call; ignored when `cursor` is supplied. - cursor (optional, string): 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. - sort (optional, string, one of: new|hot|top|controversial, default new): Listing order: new, hot, top, controversial. Locked into the cursor. - time_filter (optional, string, one of: hour|day|week|month|year|all, default all): Time window for sort=top/controversial (alias: t). Locked into the cursor. - limit (optional, integer, default 25): Posts per page, 1-100 (one Reddit call per page). Locked into the cursor. - raw_data (optional, boolean, default false): When 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. Example: curl "https://api.scrapier.io/api/v2/reddit-profile/?users=spez" -H "X-API-Key: YOUR_API_KEY" Docs: https://docs.scrapier.io/api-reference/reddit/reddit-profile.md ## GET /reddit-subreddit-info-details/ Reddit Subreddit Info Details: Structured Reddit data: send `subreddits`. Single lookup, 1 credit per successful call. Cost: 1 credit per successful call · Pagination: single lookup · Results: data.subreddit Parameters: - subreddits (required, string, example AskReddit): Subreddit name ("AskReddit", "r/AskReddit" - any casing) or a subreddit URL (www./old./new./np. hosts) -> ONE full detail record (subreddit_id, display_name, title, subscribers, weekly_active_users, weekly_contributions, description, created_at, rules, icon / banner URLs, is_nsfw, subreddit_type, language ...). Single lookup: next_cursor is always null. An unknown / private / banned / quarantined subreddit answers a status record (not_found | private | banned | quarantined | gold_only). - cursor (optional, string): 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. - fetch_page (optional, boolean, default true, locked in cursor): true (default) = also load the reddit.com community page for the web-only leaves (weekly_active_users, weekly_contributions, ms-precise created_at, web image variants, community_status). false = API only. - raw_data (optional, boolean, default false): When 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. Example: curl "https://api.scrapier.io/api/v2/reddit-subreddit-info-details/?subreddits=AskReddit" -H "X-API-Key: YOUR_API_KEY" Docs: https://docs.scrapier.io/api-reference/reddit/reddit-subreddit-info-details.md ## GET /reddit-subreddit-posts/ Reddit Subreddit Posts: Structured Reddit data: send `subreddits`. Cursor-paginated, 1 credit per successful call. Cost: 1 credit per successful call · Pagination: cursor · Results: data.posts Parameters: - subreddits (required, string, example AbsoluteUnits): Subreddit 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. - cursor (optional, string): 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. - after (optional, string): 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`). - sort (optional, string, one of: hot|new|top|rising|controversial|best, default hot, locked in cursor): hot (default) | new | top | rising | controversial | best. - timeframe (optional, string, one of: hour|day|week|month|year|all, locked in cursor): Window for sort=top / controversial (empty = Reddit's default, day). - trim (optional, boolean, default true, locked in cursor): true = the reference post fields only; false = + every other field Reddit returns for the post (~110 keys). - limit (optional, integer, default 25, locked in cursor): Posts per page = one Reddit Listing call, 1..100 (default 25); larger values are clamped to 100 with a note in `warnings`. - include_subreddit_info (optional, boolean, default true, locked in cursor): Attach 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. - raw_data (optional, boolean, default false): When 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. Example: curl "https://api.scrapier.io/api/v2/reddit-subreddit-posts/?subreddits=AbsoluteUnits" -H "X-API-Key: YOUR_API_KEY" Docs: https://docs.scrapier.io/api-reference/reddit/reddit-subreddit-posts.md ## GET /reddit-subreddit-search/ Reddit Subreddit Search: Structured Reddit data: every input is optional. Cursor-paginated, 1 credit per successful call. Cost: 1 credit per successful call · Pagination: cursor · Results: data.items Parameters: - subreddits (optional, string, default SelfDrivingCars): Subreddit to search inside ("SelfDrivingCars", "r/SelfDrivingCars" or a reddit.com/r/ URL; a full /r//search/?q=..&sort=..&t=..&type=.. URL fills the empty options). EMPTY = all of Reddit. At least one of subreddits / queries on the first call; ignored when `cursor` is supplied. - queries (optional, string, default waymo): Search terms (Reddit syntax works). EMPTY = the subreddit's unfiltered list. ONE native Reddit search page per call (7 posts / ~9-10 comments / 7 media - Reddit ignores page-size params; source=api = 100-row Listing pages), rows in Reddit's order with flat id / title / score / num_comments / author / permalink / url (+ body for comments, media_urls for media) plus the full post (or comment) + computed blocks. Required on the first call (unless subreddits is given); ignored when `cursor` is supplied. - cursor (optional, string): 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. - type (optional, string, one of: posts|comments|media, default posts, locked in cursor): posts (default) | comments | media - Reddit's search tabs. - sort (optional, string, one of: relevance|hot|top|new|comments, default relevance, locked in cursor): relevance (default) | hot | top | new | comments (comments type: relevance | top | new). - timeframe (optional, string, one of: hour|day|week|month|year|all, locked in cursor): hour | day | week | month | year | all (relevance / top / comments only). - include_body (optional, boolean, default false, locked in cursor): true = hydrate every hit via oauth.reddit.com/api/info (selftext, upvote_ratio, flair, media, awards ...). - source (optional, string, one of: auto|web|api, default auto, locked in cursor): auto (default) = the site's index (fresh guest sessions raced on a wall); when it stays walled the first page falls back and the walk continues on that index: posts+query -> api search, subreddit without query -> api listing, media -> api filtered to image/video/gallery, comments in a subreddit -> Arctic Shift archive (rows carry `source`, response `warning`). web = site index only; api = oauth.reddit.com Listing search (100 a page, `after` cursor, bodies included, posts only). Nothing able to serve the page -> HTTP 502 naming the cursor to retry. - trim (optional, boolean, default true, locked in cursor): false = + every raw Reddit field of hydrated hits in the post / comment block. - raw_data (optional, boolean, default false): When 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. No parameter is marked required; send at least one input (see descriptions). Example: curl "https://api.scrapier.io/api/v2/reddit-subreddit-search/" -H "X-API-Key: YOUR_API_KEY" Docs: https://docs.scrapier.io/api-reference/reddit/reddit-subreddit-search.md ## GET /reddit-user-profile-posts-comments/ Reddit User Profile: Structured Reddit data: send `users`. Cursor-paginated, 1 credit per successful call. Cost: 1 credit per successful call · Pagination: cursor · Results: data.items · Long-running (client timeout 210 s or more) Parameters: - users (required, string, example HLCYSWAP): Reddit username, u/name, /user/name or profile URL. Required on first call; ignored when `cursor` is supplied. - cursor (optional, string): 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. - content_type (optional, string, default both): both (posts + comments) | posts | comments. Locked into the cursor. - page_size (optional, integer, default 25): Items per page (1-100). Locked into the cursor. - extract_content (optional, boolean, default true): Kept for compatibility: full selftext/body always come from the listing JSON. - raw_data (optional, boolean, default false): When 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. Example: curl "https://api.scrapier.io/api/v2/reddit-user-profile-posts-comments/?users=HLCYSWAP" -H "X-API-Key: YOUR_API_KEY" Docs: https://docs.scrapier.io/api-reference/reddit/reddit-user-profile-posts-comments.md