# Sources and options

> Supported video links, captions or AI transcription, speaker labels and language options.

Canonical: https://transcript1.com/docs/sources-and-options
Last updated: 2026-10-20

Transcribe a YouTube, X, TikTok, Instagram, Facebook or Bluesky link, or upload a file. The table below also lists additional supported public recordings and their link forms. Use `source`, `diarize` and `language` to select the transcript source, speaker labels and language. All three are optional fields in the request body of `POST /v1/transcriptions`.

## Supported platforms

Pass the link in `url`. The `platform` field is optional; the API detects it from the link. If you supply it, it must match the link.

| Platform | Accepted links |
|---|---|
| YouTube (`youtube`) | Video URLs listed below. |
| X (`x`) | Video posts on `x.com` or `twitter.com`, such as `https://x.com/user/status/1234567890`. |
| TikTok (`tiktok`) | Video posts on `tiktok.com`, plus short links on `vm.tiktok.com`, `vt.tiktok.com` or `www.tiktok.com/t/`. |
| Instagram (`instagram`) | Reels and video posts on `instagram.com`: `/reel/`, `/reels/`, `/p/` or `/tv/`, including user-prefixed reel and post links. |
| Facebook (`facebook`) | Video and reel links on `facebook.com`, including watch links, plus `fb.watch`, `/share/v/` and `/share/r/` short links. |
| Bluesky (`bluesky`) | Video posts on `bsky.app`, such as `https://bsky.app/profile/user.example/post/3l3w4b5c6d7e2`. |
| [Twitch](https://transcript1.com/features/twitch-transcript) (`twitch`) | Completed VODs on `twitch.tv/videos/<id>` or `/<channel>/v/<id>` (`video` also accepted); clips on `clips.twitch.tv/<slug>` or `twitch.tv/<channel>/clip/<slug>` and `/clip/<slug>`. Hosts: `twitch.tv`, `www`, `m`, `go`, and `clips.twitch.tv`. |
| [Dailymotion](https://transcript1.com/features/dailymotion-transcript) (`dailymotion`) | `dailymotion.com/video/<id>` (optional `_title`), `/embed/video/<id>`, or `dai.ly/<id>`. Also `www.dailymotion.com` and `touch.dailymotion.com`. |
| [Pinterest](https://transcript1.com/features/pinterest-video-transcript) (`pinterest`) | Native video pins on `pinterest.com` or `www.pinterest.com`: `/pin/<id>/` or `/pin/<slug>--<id>/`. The first native video block is used; external embeds, images, boards, `pin.it` and regional domains are not supported. |
| [LinkedIn](https://transcript1.com/features/linkedin-video-transcript) (`linkedin`) | Public video posts on `linkedin.com` or `www.linkedin.com`: `/posts/<slug>-<activity-id>-<four-character-suffix>` or `/feed/update/urn:li:activity:<id>/`. Not profiles, learning, events or `lnkd.in`. |
| [Snapchat Spotlight](https://transcript1.com/features/snapchat-spotlight-transcript) (`snapchat`) | Spotlight videos on `snapchat.com` or `www.snapchat.com`: `/spotlight/<id>`. Not stories or profiles. |

The five additional platforms require HTTPS, no credentials and no custom ports. Public recorded individual media only: no private or login-required posts, live or processing streams, profiles, feeds or collections. No account cookies are supplied. URL time parameters do not trim the media. Twitch clips and Snapchat Spotlight may return opaque `media_id` strings; keep them unchanged rather than deriving IDs from URLs.

Only public posts are supported on X, TikTok, Instagram, Facebook and Bluesky. If a post has several videos, transcript1 uses the first video only. Profiles, stories, live pages and TikTok photo posts are not supported. A post that requires a logged-in account fails with `login_required`; a video without a sound track fails with `no_audio`. Neither is charged.

YouTube, X, TikTok, Bluesky, Dailymotion and LinkedIn support captions when a usable original-language track exists. Instagram, Facebook, Twitch, Pinterest and Snapchat use AI speech-to-text with `auto` or `stt` and reject `captions`. Caption availability varies by video. All platforms and uploads have the same per-minute price, billed on measured length. Short links are accepted only as listed above. Existing social share links without a post id at submission are not matched to earlier transcriptions; prefer the full post link when you need reuse.

| Caption source | Retrieval and timing |
|---|---|
| YouTube and X | Existing caption tracks; only auto-generated YouTube captions provide word timings. |
| TikTok | Available native VTT or SRT captions; segment timing only. |
| Bluesky | Native video caption tracks on the supported trusted PDS; not arbitrary federated hosts or quoted/external videos. Segment timing only. |
| Dailymotion | Direct SRT captions only, not caption playlists. Segment timing only; identified en-auto/fr-auto tracks report auto_generated. |
| LinkedIn | Public native video posts only, not LinkedIn Learning. Available VTT tracks have segment timing only. |

## Supported YouTube URL formats

Pass a video URL in `url`. You can omit `platform` or set it to `youtube`. These forms are accepted, with or without `www.`:

| Form | Example |
|---|---|
| Watch page | `https://www.youtube.com/watch?v=dQw4w9WgXcQ` |
| Short link | `https://youtu.be/dQw4w9WgXcQ` |
| Shorts | `https://www.youtube.com/shorts/dQw4w9WgXcQ` |
| Embed | `https://www.youtube.com/embed/dQw4w9WgXcQ` |
| Live | `https://www.youtube.com/live/dQw4w9WgXcQ` |
| Mobile and music hosts | `https://m.youtube.com/watch?v=dQw4w9WgXcQ`, `https://music.youtube.com/watch?v=dQw4w9WgXcQ` |

Extra query parameters such as `t`, `list` and `si` are ignored, and every form of one video is treated as the same video. The URL must be a full URL: a bare 11-character video id is rejected. Channel pages, playlist-only links and unsupported links return `422 invalid_url`. An unknown `platform` value returns `422 unsupported_platform` with the list of `supported_platforms`.

Only public and unlisted videos can be fetched. Private, age-restricted and live videos fail with `media_private`, `age_restricted` and `live_stream`. For a file you own, use an [upload](https://transcript1.com/docs/uploads).

## source

`source` decides where the transcript comes from.

| Value | Behavior |
|---|---|
| `auto` (default) | Use usable original-language captions on YouTube, X, TikTok, Bluesky, Dailymotion and LinkedIn first, otherwise transcribe the audio with AI speech-to-text. |
| `captions` | Retrieve captions on the caption-capable platforms only; never download audio or use AI speech-to-text. If the video has no usable track the transcription fails with `no_captions` and nothing is charged. A caption content fetch failure reports `fetch_failed`. Other link platforms reject this option with `422 invalid_request`. |
| `stt` | Always transcribe the audio with AI speech-to-text. |

Uploaded files are always transcribed with speech-to-text. For an upload, `source` may be `auto` or `stt`; `captions` returns `422 invalid_request`.

A usable caption track must match the requested language (or the video's original language when `language` is `auto`). On YouTube it must be creator-uploaded or generated by YouTube in that language. Auto-translated tracks are never used. Creator captions take priority, followed by tracks of unknown origin, then auto-generated captions. Unknown origin is not evidence of creator authorship. X uses available VTT caption tracks, with segment timing and no word timings, even for auto-generated captions. Auto may fall back to STT for unavailable or unparseable caption content, not for route, storage or programming failures. `stt` always bypasses captions.

## diarize

`diarize` adds speaker labels. It defaults to `false`.

- Speaker labels need speech-to-text. With `source` set to `auto`, `diarize: true` skips captions and goes straight to speech-to-text.
- `source: "captions"` together with `diarize: true` is rejected with `422 invalid_request`.
- Labels look like `Speaker 1` and `Speaker 2`. They appear in `transcript.speakers`, in each segment's `speaker` field and as a `Speaker 1: ` prefix in the `text` and `srt` formats (a `<v Speaker 1>` voice tag in `vtt`).

```json
{ "platform": "youtube", "url": "https://youtu.be/dQw4w9WgXcQ", "source": "stt", "diarize": true }
```

## language

`language` is `auto` (the default) or a two-letter ISO 639-1 code such as `en`, `de` or `es`.

- For captions it selects the caption track language. With `auto`, transcript1 picks the video's original language.
- For speech-to-text it is passed to the speech-to-text provider as a language hint. With `auto`, the language is identified for you, and each segment carries its own `language`.

The transcription object reports the dominant language in `language`.

## Transcript source and output

`transcript_source` identifies how the transcript was produced: `youtube_captions`, `x_captions`, `tiktok_captions`, `bluesky_captions`, `dailymotion_captions`, `linkedin_captions` or `speech_to_text`. For captions, `caption_kind` is `manual`, `auto_generated` or `null` when the origin is unknown; null must not be labeled creator-uploaded.

| | `youtube_captions`, `caption_kind` `manual` | `youtube_captions`, `caption_kind` `auto_generated` | `speech_to_text` |
|---|---|---|---|
| Segments | One per caption cue | One per caption cue | Grouped on speaker change, language change, sentence-final punctuation or a 15-second cap |
| Word timings with `include=words` | None (`words` is `null`) | Word start times; each word ends where the next begins | Word start and end times with `confidence` |
| Speaker labels | No | No | Yes, when `diarize` is `true` |
| Language | The track language | The track language | Per segment |

Caption text is kept as YouTube published it, including tags such as `[Music]`. Speech-to-text accepts media up to 5 hours; longer media fails with `media_too_long`.

X captions (`x_captions`), TikTok, Bluesky, Dailymotion and LinkedIn captions have segment timing only: `include=words` returns `words: null` for each segment, including auto-generated tracks. They do not provide speaker labels. Use `source: "stt"` for AI word timings or `diarize: true` with `auto` or `stt` for speaker labels.

## Price

Captions and speech-to-text cost the same: one credit per media minute, rounded up. The choice only changes where the transcript comes from, not what you pay. See [Billing and limits](https://transcript1.com/docs/billing-and-limits).
