Reddit video post transcript API
The transcript of a Reddit video post or v.redd.it link: Reddit's own automatic captions when it has them, otherwise AI transcription of the audio.
GET /v1/reddit/post/transcript
GET /v1/reddit/post/transcript
The transcript of a Reddit video post or v.redd.it link: Reddit's own automatic captions when it has them, otherwise AI transcription of the audio.
- Cost: 1 credit for captions; AI transcription 1 up to 2 minutes, then 5 per started minute of the whole video
- Cache: Results are kept up to 30 days; send
max_age_daysto reuse them for free. - Timeout: A request still running after about 25 seconds answers
202with a job to poll (Batch and jobs).
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
url | URL | yes | Post URL or a direct v.redd.it video URL. Accepted hosts: reddit.com, redd.it. |
allow_long_transcription | boolean | no | Transcribe audio past 2 minutes with AI, at 5 credits per started minute of the whole video. Without it a longer video answers invalid_params naming the cost, which is free. Default false. Also accepted as allowLongTranscription. |
language | string | no | 2-letter language. Captions in another language are skipped for AI transcription in this one; by default whatever Reddit has. Also accepted as lang. |
Every request also accepts:
trim:truefor a smaller response withoutnullfields andextra.raw:trueto also get the platform's original object asraw.max_age_days: accept a cached result up to this many days old, for 0 credits (Caching).
Example request
Set your key in the environment first (see Authentication).
curl -G "https://api.socialscrape.dev/v1/reddit/post/transcript" \ -H "x-api-key: $SOCIALSCRAPE_API_KEY" \ --data-urlencode "url=https://www.reddit.com/r/interestingasfuck/comments/1xl30t2/a_bird_watches_a_man_fish_he_offers_it_his_catch/"
import os
import requests
params = {
"url": "https://www.reddit.com/r/interestingasfuck/comments/1xl30t2/a_bird_watches_a_man_fish_he_offers_it_his_catch/",
}
res = requests.get(
"https://api.socialscrape.dev/v1/reddit/post/transcript",
headers={"x-api-key": os.environ["SOCIALSCRAPE_API_KEY"]},
params=params,
)
body = res.json()
if body["ok"]:
print(body["data"])
else:
print(body["error"]["code"], body["error"]["message"])
const url = new URL("https://api.socialscrape.dev/v1/reddit/post/transcript"); url.search = new URLSearchParams({ "url": "https://www.reddit.com/r/interestingasfuck/comments/1xl30t2/a_bird_watches_a_man_fish_he_offers_it_his_catch/" }).toString(); const res = await fetch(url, { headers: { "x-api-key": process.env.SOCIALSCRAPE_API_KEY! }, }); const body = await res.json(); if (body.ok) { console.log(body.data); } else { console.error(body.error.code, body.error.message); }
{
"nodes": [
{
"name": "SocialScrape Reddit video post transcript",
"type": "n8n-nodes-base.httpRequest",
"typeVersion": 4.2,
"position": [
0,
0
],
"parameters": {
"method": "GET",
"url": "https://api.socialscrape.dev/v1/reddit/post/transcript",
"sendQuery": true,
"queryParameters": {
"parameters": [
{
"name": "url",
"value": "https://www.reddit.com/r/interestingasfuck/comments/1xl30t2/a_bird_watches_a_man_fish_he_offers_it_his_catch/"
}
]
},
"sendHeaders": true,
"headerParameters": {
"parameters": [
{
"name": "x-api-key",
"value": "={{ $env.SOCIALSCRAPE_API_KEY }}"
}
]
}
}
}
],
"connections": {}
}
Example response
This is a sample from a recorded response. Status 200.
{
"ok": true,
"credits_charged": 1,
"credits_remaining": 4999,
"cached": false,
"cached_at": null,
"request_id": "req_e58f520a56c7f096162a4fbb",
"data": {
"object": "transcript",
"platform": "reddit",
"video_id": "1xl30t2",
"url": "https://www.reddit.com/r/interestingasfuck/comments/1xl30t2/a_bird_watches_a_man_fish_he_offers_it_his_catch/",
"language": "en",
"source": "auto_captions",
"duration_seconds": 33.0,
"text": "He's heavy, oh wow. I was not expecting that. Okay. Hey, kudos on you, dude. Oh yeah.",
"segments": [
{
"start": 15.86,
"end": 18.88,
"text": "He's heavy, oh wow."
},
{
"start": 24.32,
"end": 31.62,
"text": "I was not expecting that. Okay. Hey, kudos on you, dude. Oh yeah."
}
],
"available_languages": null,
"extra": null
},
"cursor": null,
"has_more": null
}
Response
A Transcript object in data.
See Data models for every field. The envelope around data is described in Responses.
Errors
Failures are free: credits_charged is 0. Branch on error.code, never on the message.
| Code | HTTP | Retry | Meaning |
|---|---|---|---|
invalid_params | 400 | no | A parameter is missing, unknown or has the wrong type. |
unsupported_url | 400 | no | The URL is not one this endpoint accepts (wrong platform or form). |
not_found | 404 | no | The platform says this profile, post or item does not exist. |
transcript_unavailable | 404 | no | No captions exist and AI transcription is not possible for this media. |
Every request can also fail with the account and platform errors listed on the Errors page.
Related endpoints
- Subreddit details (
GET /v1/reddit/subreddit/details) - Subreddit posts (
GET /v1/reddit/subreddit/posts) - Search within a subreddit (
GET /v1/reddit/subreddit/search) - Reddit post (
GET /v1/reddit/post) - Reddit post comments (
GET /v1/reddit/post/comments) - Reddit post comments (POST body) (
POST /v1/reddit/post/comments) - Reddit search (
GET /v1/reddit/search)