Skip to content

Structured Reddit data: send urls. Single lookup, 1 credit per successful call.

GET · POST1 credit / successful callSingle lookup
GEThttps://api.scrapier.io/api/v2/reddit-post-transcript/Open in Playground

Call GET /api/v2/reddit-post-transcript/ with urls. The results are in data.transcript. 4 optional parameters refine the call (see Parameters).

Terminal window
curl -G "https://api.scrapier.io/api/v2/reddit-post-transcript/" \
-H "X-API-Key: YOUR_API_KEY" \
--data-urlencode "urls=https://www.reddit.com/r/PraiseTheCameraMan/comments/1u7xfz4/camera_guy_keeping_up_with_performance/" \
--max-time 210
NameTypeRequiredDefaultDescription
X-API-Key headerstringyes—Your API key from the dashboard.
urlsstringyese.g. 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/<id>, redd.it/<id>, v.redd.it/<video_id>, www.reddit.com/video/<video_id>, a /r/<sub>/s/<token> 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.
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.
languagestringnoen2-letter caption language (default en; Reddit publishes English captions only - other codes answer no_captions).
locked in cursor
transcript_modestringnoreferencereference (default) = the hosted API's text cue for cue (with the rolling-window repeats); clean = the spoken words once.
referenceclean
locked in cursor
page_fallbackbooleannotruetrue (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.
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": {
"urls": "https://redd.it/1u7xfz4",
"transcript": {
"input_url": "https://redd.it/1u7xfz4",
"post_id": "1u7xfz4",
"video_id": "wrxf0jnl5r7h1",
"status": "ok",
"note": null,
"http_status": 200,
"url": "https://www.reddit.com/r/PraiseTheCameraMan/comments/1u7xfz4/camera_guy_keeping_up_with_performance/",
"title": "Camera guy .. keeping UP with performance",
"subreddit": "PraiseTheCameraMan",
"subreddit_id": "t5_3ocv3",
"author": "Negative-Invite-6174",
"author_fullname": "t2_29om70zd6o",
"created_at": "2026-06-17T02:17:26Z",
"created_utc": 1781662646,
"score": 17029,
"upvote_ratio": 0.97,
"num_comments": 213,
"over_18": false,
"spoiler": false,
"is_video": true,
"post_hint": "hosted:video",
"domain": "v.redd.it",
"link_url": "https://v.redd.it/wrxf0jnl5r7h1",
"thumbnail": "https://external-preview.redd.it/eHU1M3U2b2w1cjdoMbW5IOX5tDGAF7XJ3688zIW7VY9tJFtlZfmGsg7GVkp3.png?width=140&height=140&crop=1:1,smart&format=jpg&auto=webp&s=...",
"link_flair_text": null,
"crosspost_parent": null,
"removed_by_category": null,
"video": {
"duration": 165,
"width": 720,
"height": 1280,
"is_gif": false,
"has_audio": true,
"bitrate_kbps": 2400,
"fallback_url": "https://v.redd.it/wrxf0jnl5r7h1/CMAF_720.mp4?source=fallback",
"hls_url": "https://v.redd.it/wrxf0jnl5r7h1/HLSPlaylist.m3u8?a=1792658461%2C...&v=1&f=sd",
"dash_url": "https://v.redd.it/wrxf0jnl5r7h1/DASHPlaylist.mpd?a=1792658461%2C...&v=1&f=sd",
"transcoding_status": "completed"
},
"language": "en",
"transcript_mode": "reference",
"caption_url": "https://v.redd.it/wrxf0jnl5r7h1/wh_ben_en.vtt",
"caption_source": "cdn",
"has_captions": true,
"transcript_not_available": false,
"cue_count": 208,
"word_count": 355,
"transcript": "I'm freezing outside I'm freezing outside With a nice good time Make me this inside I look up again With a nice good time Make me this inside I'm freezing outside ... (355 words; transcript_mode=clean gives the 197 spoken words once)",
"segments": [
{
"start": "00:00.000",
"end": "00:08.840",
"start_seconds": 0,
"end_seconds": 8.84,
"text": "I'm freezing outside With a nice good time Make me this inside I look up again"
},
{
"start": "00:08.840",
"end": "00:14.800",
"start_seconds": 8.84,
"end_seconds": 14.8,
"text": "I change your plan by They're in the end tonight Tell me when is the next time"
},
"... 15 more segments ..."
],
"vtt": "WEBVTT\n\n00:00.000 --> 00:01.240\n<u>I'm</u> freezing outside With a nice good\ntime Make me this inside I look up again\n\n... (208 cues, 20,652 bytes)",
"warnings": [],
"stats": {
"requests": 2,
"retries": 0,
"api_calls": 1,
"cdn_calls": 1,
"page_loads": 0,
"token_source": "accounts.reddit.com",
"token_mints": 1,
"ratelimit_remaining": 99,
"proxy": false,
"caption_source": "cdn",
"cues": 208,
"language": "en",
"transcript_mode": "reference",
"video_duration": 165
},
"duration_ms": 685,
"scraped_at": "2026-09-22T08:41:01.958Z"
},
"next_cursor": null
}
}

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

FieldTypeExampleDescription
urlsstringhttps://redd.it/1u7xfz4—
transcriptobject{…}The results.
next_cursornullnullPass back as cursor for the next page. null on the last page.
transcript.input_urlstringhttps://redd.it/1u7xfz4—
transcript.post_idstring1u7xfz4—
transcript.video_idstringwrxf0jnl5r7h1—
transcript.statusstringok—
transcript.notenullnull—
transcript.http_statusinteger200—
transcript.urlstringhttps://www.reddit.com/r/PraiseTheCameraMan/c…—
transcript.titlestringCamera guy .. keeping UP with performance—
transcript.subredditstringPraiseTheCameraMan—
transcript.subreddit_idstringt5_3ocv3—
transcript.authorstringNegative-Invite-6174—
transcript.author_fullnamestringt2_29om70zd6o—
transcript.created_atstring2026-06-17T02:17:26Z—
transcript.created_utcinteger1781662646—
transcript.scoreinteger17029—
transcript.upvote_rationumber0.97—
transcript.num_commentsinteger213—
transcript.over_18booleanfalse—
transcript.spoilerbooleanfalse—
transcript.is_videobooleantrue—
transcript.post_hintstringhosted:video—
transcript.domainstringv.redd.it—
transcript.link_urlstringhttps://v.redd.it/wrxf0jnl5r7h1—
transcript.thumbnailstringhttps://external-preview.redd.it/eHU1M3U2b2w1…—
transcript.link_flair_textnullnull—
transcript.crosspost_parentnullnull—
transcript.removed_by_categorynullnull—
transcript.videoobject{…}—
transcript.languagestringen—
transcript.transcript_modestringreference—
transcript.caption_urlstringhttps://v.redd.it/wrxf0jnl5r7h1/wh_ben_en.vtt—
transcript.caption_sourcestringcdn—
transcript.has_captionsbooleantrue—
transcript.transcript_not_availablebooleanfalse—
transcript.cue_countinteger208—
transcript.word_countinteger355—
transcript.transcriptstringI'm freezing outside I'm freezing outside Wit…—
transcript.segmentsarray[3 items]—
transcript.vttstringWEBVTT 00:00.000 --> 00:01.240 <u>I'm</u> fr…—
transcript.warningsarray[]—
transcript.statsobject{…}—
transcript.duration_msinteger685—
transcript.scraped_atstring2026-09-22T08:41:01.958Z—

Returns everything in one call; next_cursor is always null.

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
  • Nothing special: send the inputs, read the result.
  • 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 User Submitted Posts — Structured Reddit data: send users. Cursor-paginated, 1 credit per successful call.