SocialCrawl
Scrape

Get the words in a video

Read what is said and what is written on screen, in videos and posts, from one call

A video holds words in two places: what people say, and what is written on screen. Each has its own calls. This page lists them, prices one for free and says what happens when a video has no words to read.

Price a transcript for free

cURL
curl -G "https://www.socialcrawl.dev/v1/utility/estimate" \
  -H "x-api-key: sc_your_key_here" \
  --data-urlencode "id=tiktok/post/transcript" \
  --data-urlencode "url=https://www.tiktok.com/@stoolpresidente/video/7499229683859426602"
Response (trimmed)
{
  "success": true,
  "data": {
    "id": "tiktok/post/transcript",
    "valid": true,
    "hold": 10,
    "pricing": "flat",
    "formula": "10 credits per call, flat."
  },
  "credits_used": 0
}

The estimate costs nothing. A transcript call is priced per video, so a long video costs the same as a short one.

What is said

The transcript endpoints return the spoken words of a video:

Transcript endpoints
PlatformEndpointPathCredits
FacebookGet a Facebook Ad Library video ad transcript/v1/facebook/adlibrary/ad/transcript10
FacebookGet Facebook video transcript/v1/facebook/post/transcript10
InstagramGet Instagram media transcript/v1/instagram/media/transcript10
LinkedInGet a LinkedIn post video transcript/v1/linkedin/post/transcript10
RedditGet a Reddit video post transcript/v1/reddit/post/transcript10
RumbleGet a Rumble video transcript/v1/rumble/video/transcript10
TikTokGet TikTok video transcript/v1/tiktok/post/transcript10
Twitter/XGet Twitter video transcript/v1/twitter/tweet/transcript10
YouTubeUp to 100 YouTube video ids → one transcript per row, failed ids refunded./v1/youtube/transcripts3-300 (metered)
YouTubeGet YouTube video transcript/v1/youtube/video/transcript3

On TikTok, use_ai_as_fallback=true transcribes the audio when the video has no caption track, at the same price. Video transcription wraps these calls in one function.

What is written on screen

Creators often put text on the video itself, which no caption or transcript carries. These endpoints read it:

On-screen text endpoints
PlatformEndpointPathCredits
InstagramGet Instagram post on-screen text/v1/instagram/media/screen-text5-10 (metered)
TikTokGet TikTok video on-screen text/v1/tiktok/video/screen-text5-10 (metered)

By default a TikTok video is read from its cover frame. Send frames=all to read the whole video. The answer then adds a timeline with the second each block of text first appears. The on-screen text cookbook shows a full run.

When there is no transcript

A video with no captions and no speech, or one that was deleted, returns 404 RESOURCE_NOT_FOUND and is refunded. The error says why, and error handling lists each reason. A video longer than AI transcription covers is refunded too. The section below gives the length limits and the price of each platform.

Transcripts cost the same at any length

Each transcript call charges a flat price when it succeeds, whatever the video's length:

EndpointPrice
/v1/tiktok/post/transcript10 credits
/v1/instagram/media/transcript10 credits
/v1/facebook/post/transcript10 credits
/v1/twitter/tweet/transcript10 credits
/v1/youtube/video/transcript3 credits

On TikTok, use_ai_as_fallback=true transcribes the audio when the video has no caption track, at the same price. AI transcription covers videos up to 10 minutes (600 seconds), and Facebook Ad Library ad transcripts cover up to 2 minutes. For an X video over 10 minutes, /v1/twitter/tweet/transcript returns the captions X publishes for it when there are any. A longer video with no such captions is refunded, like a video with no speech or a deleted one.

/v1/youtube/video/subtitles (1 credit) lists a video's caption tracks, each with its language and a download URL. /v1/youtube/video/transcript returns the caption text itself, with timestamps.

Many videos at once

POST /v1/youtube/transcripts takes a list of YouTube video ids and returns one row per video. You pay only for the transcripts that came back. Batch covers it and the other list endpoints. For another platform, background jobs run many calls to one endpoint as one job.

Next steps