Post Transcript

GET/v1/reddit/post/transcript1 credit

Returns the transcript of a Reddit video post from its captions, with the raw caption file and the caption URL.

01Query parameters

Name	Type	Description
urlrequired	string	The post URL, a share URL or a `https://v.redd.it/<id>` video URL.
languageoptional	string	Two-letter caption language code, e.g. `en`.Default: `en`
cache_max_ageoptional	string	Accepted for compatibility; every call is fetched fresh and costs the normal price. Any other value is a free 400.Accepted values:`1d3d7d14d30d`

02Pricing

1 credit when a transcript is returned; 0 when the post has no video or the video has no captions (`transcriptNotAvailable: true`).

03Request

curl "https://api.scrapesocial.ai/v1/reddit/post/transcript?url=https%3A%2F%2Fwww.reddit.com%2Fr%2Fyouseeingthisshit%2Fcomments%2F1oiu9xm%2Ffootball_nostalgiasaints_punter_head_coach_cant%2F" \
  -H "x-api-key: $SCRAPESOCIAL_KEY"

04Responses

Real answers from the API. Lists are shortened to 2 items.

GET /v1/reddit/post/transcript?url=https%3A%2F%2Fwww.reddit.com%2Fr%2Fyouseeingthisshit%2Fcomments%2F1oiu9xm%2Ffootball_nostalgiasaints_punter_head_coach_cant%2F

{
  "success": true,
  "credits_remaining": 4980,
  "credits_charged": 1,
  "url": "https://www.reddit.com/r/youseeingthisshit/comments/1oiu9xm/football_nostalgiasaints_punter_head_coach_cant/",
  "post_id": "1oiu9xm",
  "video_id": "eflpgc6r0zxf1",
  "caption_url": "https://v.redd.it/eflpgc6r0zxf1/wh_ben_en.vtt",
  "language": "en",
  "raw_vtt": "WEBVTT\n\n00:00.000 --> 00:00.300\n<u>stop</u> on third down and now Barnhart I\nhanging\n\n00:00.300 --> 00:00.560\nstop <u>on</u> third down and now Barnhart I\nhanging\n\n00:00.560 --> 00:00.760\nstop on <u>third</u> down and now Barnhart I\nhanging\n\n00:00.760 --> 00:01.120\nstop on third <u>down</u> and now Barnhart I\nhanging\n\n00:01.120 --> 00:01.320\nstop on third down <u>and</u> now Barnhart I\nhanging\n\n00…",
  "transcript": "stop on third down and now Barnhart I hanging spiraling punts touch back Barnhart could not pull it up short of the end zone I think the way the returns have been going in this game I'd just assume wait a minute what's going on out here they down the ball that this is going to touch down that that is one of the most unbelievable plays I've ever seen they never down the ball it was sitting in the e…",
  "transcriptNotAvailable": false
}

Common to every endpoint

Any route can answer these: a missing or wrong key, no credits left, the platform not answering, or a failure on our side. None of them costs credits.

GET /v1/cosmos/profile?handle=design

{
  "success": false,
  "message": "Invalid API key"
}

05Notes

The answer has `url`, `post_id`, `video_id`, `caption_url`, `language`, `raw_vtt` (the WebVTT file), `transcript` (the caption text) and `transcriptNotAvailable`. Only Reddit's own captions are used, no AI transcription. A text post returns `video_id: null`, `transcript: null` for 0 credits. An unknown post is a free 404; an invalid `language` is a free 400.

06Errors & credits

Every error has success: false, a real HTTP status and costs no credits.

400missing_parameter
A required parameter is missing or invalid.
403private_account
The account is private or age-restricted.
404not_found
No such account.
503upstream_error
The platform did not answer; retry shortly.