Start with 100 free credits. No card needed. Get an API key

X video transcript API

AI transcription of the video in a post.

100 free credits. No card needed.

x.com/coinbase/st...

Sent with the link

Sample
Cost
1 credit
Fields
11
Cached
30 days
Example transcript text. This is...Text
enLanguage
x.com/yashsrivasta7a/status/2111731581702...Link

One transcript a request

Each request1 credit
Fields in each transcript11
A failed requestFree
A cached repeatFree

What you get in each transcript

The whole textEvery line joined into one text, next to the timed lines.
Timed linesEach line with its start and end, in seconds.
Video idVideo id as X (Twitter) gives it.
LengthHow long it runs, in seconds.
LanguageThe language code, such as en.
LinkIts link, such as x.com/yashsrivasta7a/stat....

What you can build with it

A video post's speech as text. Pass a post with a video and get its speech as text with timed segments, for search, quotes or a summary. The sample's 45 second video comes back as one segment.

Fields on this transcriptSample
source
ai
duration_seconds
45
language
en

Read from the audio every time. The transcript is made from the audio of the post's first video, so source always reads ai, and the language is the one heard in it.

Fields on this transcriptSample
video_id
2111731581702598777
source
ai
Content repurposing

A budget for long clips. A video up to 2 minutes costs 1 credit. Past that it needs allow_long_transcription=true and costs 5 credits per started minute of the whole video, so a 3 minute clip costs 15.

Length and languageSample
duration_seconds
45
language
en

From a key to JSON.

01Get a keySign up and get 100 free credits. No card needed.
02Send the linkPass url (x.com/coinbase/status/206697087...).
03Read the JSONOne transcript comes back in data.
Request and response

The request. GET /v1/twitter/tweet/transcript

curl -G "https://api.socialscrape.dev/v1/twitter/tweet/transcript" \
  --data-urlencode "url=https://x.com/coinbase/status/2066970874016645585" \
  -H "x-api-key: $SOCIALSCRAPE_API_KEY"
See every parameter in the docs

The response. A sample, in the shape every call returns.

200 OKSample values
{
  "ok": true,
  "credits_charged": 1,
  "data": {
    "text": "Example transcript text. This is...",
    "duration_seconds": 45,
    "url": "https://x.com/yashsrivasta7a/stat...",
    "video_id": "2111731581702598777",
    "language": "en",
    "source": "ai",
    "segments": [ ... ]
  }
}
AI agents
MCP

Ask in plain words. Ask your agent for X video transcript in plain words, and the SocialScrape MCP server makes the call.

SocialScrape MCPSample

Get the X video transcript for x.com/coinbase/status/206697087...

X video transcript · 1 credit

Here is the transcript: "Example transcript text. This is...".

Seconds45
Segments1
Words11
Set up the MCP server
Good to know
01

One tool call

X video transcript, given the link.

02

Same price as the API

1 credit a call; a repeat within 30 days is free.

03

Runs on your machine

Your key stays in your agent's settings.

Pay only for data you get.

Failed requests and cached repeats are free.

RequestCredits
Captions, when the video has them1 credit
AI transcription up to 2 minutes1 credit
Longer, each started minute of the video5 credits
A failed requestFree
Starter

1,000 credits

$13 one time

Get an API key
  • $13.00 per 1,000 credits
  • Credits never expire
  • No subscription
GrowthMost popular

25,000 credits

$55 one time

Get an API key
  • $2.20 per 1,000 credits
  • Credits never expire
  • No subscription
Scale

230,000 credits

$349 one time

Get an API key
  • $1.52 per 1,000 credits
  • Credits never expire
  • No subscription
New accounts start with 100 credits.See pricing

Questions, answered.

Common questions

Which X posts can be transcribed?

Posts with a video. A post without one, or with an animated GIF, which has no audio, answers transcript_unavailable, free.

What does a long X video answer without allow_long_transcription?

invalid_params, with the cost named in the message, and nothing is charged.

What does it return?

Videos over 2 minutes need allow_long_transcription=true and cost 5 credits per started minute of the whole video. Posts without video, and animated GIFs, answer transcript_unavailable (free). The transcript has up to 11 fields, and the sample fills video_id, url, language, source, duration_seconds, text and segments.

What do I send?

Send one of url or id.

url: Post URL (x.com/<user>/status/<id>).

id: Post id.

allow_long_transcription: 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.

Which errors can it return?

invalid_params, unsupported_url, not_found and transcript_unavailable. None is charged, and the errors list says which to retry.

Is there an SDK call for it?

client.twitter.tweet_transcript(...) in Python and client.twitter.tweetTranscript() in TypeScript.

Get started

Start pulling social data.

100 free credits. No card needed.