Transcript from any video URL API

Detects the platform from the URL and runs its transcript endpoint: YouTube, TikTok, Instagram, X, Facebook, LinkedIn, Reddit, Twitch clips, Kick clips...

GET /v1/transcript

Detects the platform from the URL and runs its transcript endpoint: YouTube, TikTok, Instagram, X, Facebook, LinkedIn, Reddit, Twitch clips, Kick clips and Rumble. Same price, same cache.

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_days to reuse them for free.
Timeout: A request still running after about 25 seconds answers 202 with a job to poll (Batch and jobs).

Parameters#

Name	Type	Required	Description
`url`	URL	yes	Video URL on any supported platform. Accepted hosts: `youtube.com`, `youtu.be`, `tiktok.com`, `instagram.com`, `instagr.am`, `x.com`, `twitter.com`, `rumble.com`, `twitch.tv`, `kick.com`, `facebook.com`, `fb.com`, `fb.watch`, `linkedin.com`, `reddit.com`, `redd.it`.
`language`	string	no	Preferred caption language (BCP 47). Also accepted as `lang`.
`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 transcript_unavailable, which is free. Default `false`. Also accepted as `allowLongTranscription`.

Every request also accepts:

trim: true for a smaller response without null fields and extra.
raw: true to also get the platform's original object as raw.
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).

1curl -G "https://api.socialscrape.dev/v1/transcript" \2  -H "x-api-key: $SOCIALSCRAPE_API_KEY" \3  --data-urlencode "url=https://www.youtube.com/watch?v=dQw4w9WgXcQ"

1import os2import requests34params = {5    "url": "https://www.youtube.com/watch?v=dQw4w9WgXcQ",6}7res = requests.get(8    "https://api.socialscrape.dev/v1/transcript",9    headers={"x-api-key": os.environ["SOCIALSCRAPE_API_KEY"]},10    params=params,11)12body = res.json()1314if body["ok"]:15    print(body["data"])16else:17    print(body["error"]["code"], body["error"]["message"])

1const url = new URL("https://api.socialscrape.dev/v1/transcript");2url.search = new URLSearchParams({3  "url": "https://www.youtube.com/watch?v=dQw4w9WgXcQ"4}).toString();5const res = await fetch(url, {6  headers: { "x-api-key": process.env.SOCIALSCRAPE_API_KEY! },7});8const body = await res.json();910if (body.ok) {11  console.log(body.data);12} else {13  console.error(body.error.code, body.error.message);14}

1{2  "nodes": [3    {4      "name": "SocialScrape Transcript from any video URL",5      "type": "n8n-nodes-base.httpRequest",6      "typeVersion": 4.2,7      "position": [8        0,9        010      ],11      "parameters": {12        "method": "GET",13        "url": "https://api.socialscrape.dev/v1/transcript",14        "sendQuery": true,15        "queryParameters": {16          "parameters": [17            {18              "name": "url",19              "value": "https://www.youtube.com/watch?v=dQw4w9WgXcQ"20            }21          ]22        },23        "sendHeaders": true,24        "headerParameters": {25          "parameters": [26            {27              "name": "x-api-key",28              "value": "={{ $env.SOCIALSCRAPE_API_KEY }}"29            }30          ]31        }32      }33    }34  ],35  "connections": {}36}

Example response#

This is a sample with illustrative values. Status 200.

200 OKSample response

1{2  "ok": true,3  "credits_charged": 1,4  "credits_remaining": 4999,5  "cached": false,6  "cached_at": null,7  "request_id": "req_54e6289e14c7b0e7ad9acc2d",8  "data": {9    "object": "transcript",10    "platform": "youtube",11    "video_id": "dQw4w9WgXcQ",12    "url": "https://www.youtube.com/watch?v=dQw4w9WgXcQ",13    "language": "en",14    "source": "captions",15    "duration_seconds": 213.0,16    "text": "Example transcript text. This is illustrative, not the video's real captions.",17    "segments": [18      {19        "start": 0.0,20        "end": 4.0,21        "text": "Example transcript text."22      },23      {24        "start": 4.0,25        "end": 9.0,26        "text": "This is illustrative, not the video's real captions."27      }28    ],29    "available_languages": [30      "en"31    ],32    "extra": null33  },34  "cursor": null,35  "has_more": null36}

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).
`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.