Tweet Transcript

GET/v1/twitter/tweet/transcript1 credit

Transcribes the speech in a post's video with AI speech-to-text and returns the text with the video's duration.

01Query parameters

Name	Type	Description
urlrequired	string	The URL of a post with a video, e.g. `https://x.com/TheoVon/status/1916982720317821050`.
allow_long_transcriptionoptional	boolean	Only the exact value `true` allows videos longer than 120 seconds, at 10 credits per started minute.Default: `false`
cache_max_ageoptional	string	Accepted for compatibility; every call is fetched fresh and costs the normal price. Any other value is a free 400.Accepted values:`1d3d7d14d30d`

02Pricing

1 credit for a video up to 120 seconds. Longer videos need `allow_long_transcription=true` and cost 10 credits per started minute. A post without video, or a video with no speech, costs 0.

03Request

curl "https://api.scrapesocial.ai/v1/twitter/tweet/transcript?url=https%3A%2F%2Fx.com%2FTheoVon%2Fstatus%2F1916982720317821050" \
  -H "x-api-key: $SCRAPESOCIAL_KEY"

04Responses

Real answers from the API. Lists are shortened to 2 items.

GET /v1/twitter/tweet/transcript?url=https%3A%2F%2Fx.com%2FTheoVon%2Fstatus%2F1916982720317821050

{
  "success": true,
  "credits_remaining": 4980,
  "credits_charged": 1,
  "transcript": "Since you're kind of like a leader in innovation and technology in our world, you know, do you—how do you know that what your convictions are, how do you gauge if what your convictions are are the best for everybody, kind of? Like, how do you kind of figure that out, you know? It seems like such a challenge. I mean, look, at the end of the day, there are still a lot of options of things that peopl…",
  "duration_seconds": 84.39466666666667,
  "duration_minutes": 1.41
}

Common to every endpoint

Any route can answer these: a missing or wrong key, no credits left, the platform not answering, or a failure on our side. None of them costs credits.

GET /v1/cosmos/profile?handle=design

{
  "success": false,
  "message": "Invalid API key"
}

05Notes

The answer has `transcript`, `duration_seconds` and `duration_minutes`. A post without a video (a GIF counts as no video) returns 200 with `transcript: null` for 0 credits. A video over 120 seconds without `allow_long_transcription=true` is a free 400 that states the video's length.

06Errors & credits

Every error has success: false, a real HTTP status and costs no credits.

400missing_parameter
A required parameter is missing or invalid.
403private_account
The account is private or age-restricted.
404not_found
No such account.
503upstream_error
The platform did not answer; retry shortly.