# X Tweet Transcript API (https://www.socialcrawl.dev/platforms/twitter/tweet-transcript)

> Returns the transcript of a video attached to a tweet. Supports auto-generated captions.

TL;DR: `GET /v1/twitter/tweet/transcript` costs 10 credits per call and returns SocialCrawl's unified JSON schema. Single x-api-key auth, 100 free credits on signup.

## Parameters

| Parameter | Required | Description |
| --- | --- | --- |
| `url` | yes | Full URL of the tweet containing a video |

## Code example

```bash
curl "https://www.socialcrawl.dev/v1/twitter/tweet/transcript?url=https%3A%2F%2Fx.com%2FTheoVon%2Fstatus%2F1916982720317821050" \
  -H "x-api-key: sc_YOUR_API_KEY"
```

## FAQ

### How do I get a transcript from a Twitter video?

Send a GET request to /v1/twitter/tweet/transcript with the tweet URL in the url parameter. SocialCrawl returns the auto-generated captions for videos attached to that tweet, in timed text format with precise start and end timestamps per segment.

### What tweets does the transcript endpoint support?

Any public tweet containing a video — original video posts, quote tweets with video, or replies with video attachments. GIFs and image-only tweets return an empty transcript since there's no audio track to caption.

### How much does a tweet transcript cost?

Ten credits per request on the premium tier. Transcripts are premium-priced because SocialCrawl runs the full caption extraction pipeline on every request. New accounts get 100 free credits — enough to try 10 transcripts before paying.

### Does the transcript include timestamps?

Yes. Each caption segment returns with start and end timestamps (in seconds), so you can build click-to-seek UIs, search within video, or feed timecoded transcripts into analytics and AI pipelines directly.

### What language does the transcript return?

Whatever language the video's auto-generated caption track detects. SocialCrawl passes the captions through as-is without translation. Combine with a translation API if you need to localize transcripts for search or content workflows.

See the full X API: https://www.socialcrawl.dev/platforms/twitter

## Pricing

- Standard endpoints: 1 credit per call
- Advanced endpoints: 5 credits per call
- Premium endpoints: 10 credits per call
- 100 free credits on signup, no credit card required. Cached responses cost 0 credits. Credit packs never expire.
- Full pricing: https://www.socialcrawl.dev/pricing

## Explore with AI

Questions this API answers, phrased for an AI assistant:

- How to get video transcripts from tweets
- Twitter video caption API with timestamps