Reddit Post Transcript
Structured Reddit data: send urls. Single lookup, 1 credit per successful call.
GET · POST1 credit / successful callSingle lookup
Overview
Section titled “Overview”Call GET /api/v2/reddit-post-transcript/ with urls. The results are in data.transcript. 4 optional parameters refine the call (see Parameters).
Request
Section titled “Request”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 210const params = new URLSearchParams({ urls: "https://www.reddit.com/r/PraiseTheCameraMan/comments/1u7xfz4/camera_guy_keeping_up_with_performance/" });
const res = await fetch(`https://api.scrapier.io/api/v2/reddit-post-transcript/?${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}`);
console.log(body.data.transcript);import requests
resp = requests.get( "https://api.scrapier.io/api/v2/reddit-post-transcript/", headers={"X-API-Key": "YOUR_API_KEY"}, params={"urls": "https://www.reddit.com/r/PraiseTheCameraMan/comments/1u7xfz4/camera_guy_keeping_up_with_performance/"}, timeout=210,)body = resp.json()if not resp.ok: raise RuntimeError(body.get("error") or body.get("detail"))
print(body["data"]["transcript"])curl -X POST "https://api.scrapier.io/api/v2/reddit-post-transcript/" \ -H "X-API-Key: YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{"urls":"https://www.reddit.com/r/PraiseTheCameraMan/comments/1u7xfz4/camera_guy_keeping_up_with_performance/"}' \ --max-time 210Parameters
Section titled “Parameters”| Name | Type | Required | Default | Description |
|---|---|---|---|---|
X-API-Key header | string | yes | — | Your API key from the dashboard. |
urls | string | yes | e.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. |
cursor | string | no | — | 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 | string | no | en | 2-letter caption language (default en; Reddit publishes English captions only - other codes answer no_captions). locked in cursor |
transcript_mode | string | no | reference | reference (default) = the hosted API's text cue for cue (with the rolling-window repeats); clean = the spoken words once. referenceclean locked in cursor |
page_fallback | boolean | no | true | 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. locked in cursor |
Advanced
| Name | Type | Default | Description |
|---|---|---|---|
use_proxy | boolean | true | Route the request through Scrapier's residential proxy pool. Default: true. Leave as is unless support tells you otherwise. |
raw_data | boolean | 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. |
Response
Section titled “Response”{ "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 }}Bad input. The exact message varies by endpoint.
{ "success": false, "error": "…"}Balance below the endpoint’s price.
{ "error": "Insufficient credits. Buy more to scrape more.", "balance": 1, "required": 2}Invalid or unknown API key.
{ "detail": "Authentication service unavailable or invalid API key."}Throttled — wait for Retry-After.
{ "detail": "Request was throttled. Expected available in N seconds."}Sample from the live catalog; arrays trimmed to 3 items. Results are in data.transcript.
Response fields
Section titled “Response fields”| Field | Type | Example | Description |
|---|---|---|---|
urls | string | https://redd.it/1u7xfz4 | — |
transcript | object | {…} | The results. |
next_cursor | null | null | Pass back as cursor for the next page. null on the last page. |
transcript.input_url | string | https://redd.it/1u7xfz4 | — |
transcript.post_id | string | 1u7xfz4 | — |
transcript.video_id | string | wrxf0jnl5r7h1 | — |
transcript.status | string | ok | — |
transcript.note | null | null | — |
transcript.http_status | integer | 200 | — |
transcript.url | string | https://www.reddit.com/r/PraiseTheCameraMan/c… | — |
transcript.title | string | Camera guy .. keeping UP with performance | — |
transcript.subreddit | string | PraiseTheCameraMan | — |
transcript.subreddit_id | string | t5_3ocv3 | — |
transcript.author | string | Negative-Invite-6174 | — |
transcript.author_fullname | string | t2_29om70zd6o | — |
transcript.created_at | string | 2026-06-17T02:17:26Z | — |
transcript.created_utc | integer | 1781662646 | — |
transcript.score | integer | 17029 | — |
transcript.upvote_ratio | number | 0.97 | — |
transcript.num_comments | integer | 213 | — |
transcript.over_18 | boolean | false | — |
transcript.spoiler | boolean | false | — |
transcript.is_video | boolean | true | — |
transcript.post_hint | string | hosted:video | — |
transcript.domain | string | v.redd.it | — |
transcript.link_url | string | https://v.redd.it/wrxf0jnl5r7h1 | — |
transcript.thumbnail | string | https://external-preview.redd.it/eHU1M3U2b2w1… | — |
transcript.link_flair_text | null | null | — |
transcript.crosspost_parent | null | null | — |
transcript.removed_by_category | null | null | — |
transcript.video | object | {…} | — |
transcript.language | string | en | — |
transcript.transcript_mode | string | reference | — |
transcript.caption_url | string | https://v.redd.it/wrxf0jnl5r7h1/wh_ben_en.vtt | — |
transcript.caption_source | string | cdn | — |
transcript.has_captions | boolean | true | — |
transcript.transcript_not_available | boolean | false | — |
transcript.cue_count | integer | 208 | — |
transcript.word_count | integer | 355 | — |
transcript.transcript | string | I'm freezing outside I'm freezing outside Wit… | — |
transcript.segments | array | [3 items] | — |
transcript.vtt | string | WEBVTT 00:00.000 --> 00:01.240 <u>I'm</u> fr… | — |
transcript.warnings | array | [] | — |
transcript.stats | object | {…} | — |
transcript.duration_ms | integer | 685 | — |
transcript.scraped_at | string | 2026-09-22T08:41:01.958Z | — |
Pagination
Section titled “Pagination”Returns everything in one call; next_cursor is always null.
Errors
Section titled “Errors”Failed calls are free. Branch on the HTTP status and read the message from error (or detail). Full details in Errors.
| Status | Meaning | Retry? | Charged? |
|---|---|---|---|
400 | Bad or missing input. | No — fix the params | No |
401 / 403 | Missing, invalid or revoked API key. | No — fix the key | No |
402 | Out of credits (body has balance). | No — top up | No |
404 | Unknown endpoint slug. | No — check the slug | No |
429 / 503 | Busy or throttled. | Yes — after Retry-After | No |
5xx | Target site or upstream failure, or timeout. | Yes — with backoff | No |
- Nothing special: send the inputs, read the result.
Related
Section titled “Related”- 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.