X Tweet Transcript API
Scrape X Tweet Transcript data with one API call. Returns the spoken words from a video attached to a tweet, auto-generated captions included. Costs 10 credits per call, the most expensive endpoint on this platform: `twitter/tweet` returns the media attachment itself for 1 credit, and this returns what is said in it. A tweet with no video, or a video with no speech, is a 404 with `error.details.reason: no_captions` and is not charged, because X answers those two identically. Videos up to 10 minutes (600 seconds) are supported; a longer one returns 400 INVALID_REQUEST with `error.details.reason: video_too_long` and `max_seconds`, also free. Every one of these outcomes is deterministic, so retrying returns the same answer.
Last updated October 2026Maintained by the SocialCrawl team
Returns the transcript of a video attached to a tweet, including auto-generated captions.
Use it when a tweet carries video and you need the spoken words; tweet returns the media attachment but not its speech.
Searching 68 platforms in parallel
What can you do with the Tweet Transcript API?
The Tweet Transcript endpoint gives you structured X data with computed fields in a single request. No scraping infrastructure to build or maintain.
Example Request
curl -H "x-api-key: YOUR_API_KEY" \
"https://www.socialcrawl.dev/v1/twitter/tweet/transcript?url=https%3A%2F%2Fx.com%2FTheoVon%2Fstatus%2F1916982720317821050"import requests
response = requests.get(
"https://www.socialcrawl.dev/v1/twitter/tweet/transcript",
params={
'url': 'https://x.com/TheoVon/status/1916982720317821050',
},
headers={"x-api-key": "YOUR_API_KEY"},
)
data = response.json()const response = await fetch(
"https://www.socialcrawl.dev/v1/twitter/tweet/transcript?url=https%3A%2F%2Fx.com%2FTheoVon%2Fstatus%2F1916982720317821050",
{
headers: { "x-api-key": "YOUR_API_KEY" },
},
);
const data = await response.json();Parameters
| Parameter | Required | Description |
|---|---|---|
| url | Yes | Full URL of the tweet containing a video |
What does the X Tweet Transcript API return?
Every response follows one unified schema. Here is a real, unmodified response body, so you can see the exact fields you get back before spending a credit.
Example response
{
"success": true,
"platform": "twitter",
"endpoint": "/v1/twitter/tweet/transcript",
"data": {
"transcript": "Since you're kind of like a leader in innovation and technology in our world, you know? Um, 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, um, there's still a lot of options of things that people can do. Just because I build something doesn't mean that people are going to use it. Actually a lot of the things that I build like some some of them work, some of them don't and like, I think part of the reason why the company has been successful is because, you know, maybe we have a slightly higher hit rate of things working than others. But if we do something that doesn't work, then in general, people aren't going to use it and then the future doesn't go in that direction. So, I see, so you're saying it's up to the user more. Yeah, I mean, look, it's always served me well to generally have faith in people and believe that people are smart and can make good decisions for themselves. And whenever we try to like adopt some sort of like attitude of, \"Oh, we must know better than them.\" It's like, we're like, we're the people building technology, that's when you lose. So I I I tend to just think that at the end of the day, yeah, I mean, I think people are smarter than than a lot of people think, and I think ultimately drive the direction that society goes in."
},
"credits_used": 0,
"request_id": "req_example000000",
"cached": true,
"credits_remaining": 9999,
"source": "captured",
"captured_at": "2026-10-02T12:52:23.126Z",
"redacted": true
}Live sample illustrating the unified response shape. Field values reflect the record you query.
How does the X Tweet Transcript API work?
Send a GET request with your API key and get back clean, structured JSON in our unified schema. Supported computed fields are populated when the source provides the required inputs.
Method
GET
Response
JSON
How do you scrape social media data in seconds?
The fastest social media scraping API for developers. Scrape profiles, posts, comments, and analytics from 68 platforms covering 10B+ monthly active users.
One schema, every platform
Query 68 platforms with identical response structures. Write your integration once.
Computed fields, not just scraped
When an endpoint supports these metrics and the source provides the required inputs, the normalized record includes engagement_rate, estimated_reach, content_category, and language. Ready to use.
See your data before you code
Visual Data Explorer. Paste any URL, get rich result cards, sortable tables, CSV export.
import requests
response = requests.get(
'https://www.socialcrawl.dev/v1/tiktok/profile',
params={'handle': 'charlidamelio'},
headers={'x-api-key': 'sc_YOUR_API_KEY'}
)
data = response.json(){
"success": true,
"platform": "tiktok",
"data": {
"author": {
"username": "charlidamelio",
"followers": 152400000
},
"engagement": {
"likes": 12400000000,
"engagement_rate": 0.087
},
"metadata": {
"language": "en",
"content_category": "lifestyle"
}
}
}Have a question? We got answers
Find answers to frequently asked questions about SocialCrawl's API, pricing, and capabilities.
Contact usHow do I get a transcript from a Twitter video?
What tweets does the transcript endpoint support?
How much does a tweet transcript cost?
Does the transcript include timestamps?
What language does the transcript return?
Ask AI about SocialCrawl
Ready to scrape X Tweet Transcript data?
Get your API key and start pulling X data in under 60 seconds.
