Insight Social
GET /v1/twitter/tweet/transcript

Twitter/X Tweet Transcript API

Returns the transcript of a video attached to a tweet, including auto-generated captions.

100 credits a call · single call · failed calls free · 10 free calls to start

curl "https://api.insightsocial.app/v1/twitter/tweet/transcript?url=https%3A%2F%2Fx.com%2FTheoVon%2Fstatus%2F1916982720317821050" \
-H "x-api-key: $INSIGHTSOCIAL_API_KEY"
200 OKJSON
{
"success": true,
"platform": "twitter",
"endpoint": "/v1/twitter/tweet/transcript",
"schema_version": "2",
"data": {
"transcript": {
"language": "<string | null>",
"text": "<string | null>",
"segments": "<array | null>"
}
},
"unavailable": [],
"credits_used": "<integer>"
}

When to use it

Use it when a tweet carries video and you need the spoken words; tweet returns the media attachment but not its speech.

Parameters

Query parameters for GET /v1/twitter/tweet/transcript. Send your key in the x-api-key header.

NameRequiredDescription
urlYesFull URL of the tweet containing a video

Response fields

The same unified schema every platform returns, so code written for Twitter/X works on the other eight. A field the platform did not provide is null and listed in unavailable.

FieldTypeNotes
languagestring | nullThe content's language as the platform states it, e.g. en, pt-BR. Detected languages come later (§7.1).
textstring | null
segmentsarray | null

Every field, error and example is in the Twitter/X Tweet Transcript API reference.

How much does the Twitter/X Tweet Transcript API cost?

100 credits per successful call.

  • Failed calls are free

    A call that errors or finds nothing costs 0 credits.

  • Know the price first

    Add dry_run=1 and the response quotes the call without making it. Nothing is charged.

  • One balance

    API calls and Chrome extension exports share the same credits, on the free plan too.

Twitter/X Tweet Transcript API: frequently asked questions

Send GET /v1/twitter/tweet/transcript with the url parameter and your key in the x-api-key header. Returns the transcript of a video attached to a tweet, including auto-generated captions.