---
title: "Get a video transcript"
method: GET
path: "/v1/youtube/video/transcript"
tags: ["YouTube"]
---

# Get a video transcript

`GET /v1/youtube/video/transcript`

## Request

- Base URL: `https://api.scrapeatlas.com`
- URL: `https://api.scrapeatlas.com/v1/youtube/video/transcript`
- Auth: API key in header `x-api-key`

Read the public caption track of a video or Short: the timed transcript (text, startMs, endMs, startTimeText), the plain text, the track's language name and every available caption track. The track is the last one whose language code matches the requested language (English by default), which prefers the auto-generated track when both exist. Without a matching track the transcript fields are null and the response is partial. Each successful request costs 1 account credit, including partial results. Failed requests cost 0 credits.

## Query parameters

- `url` string, required
- `language` string

## Response `200`

Inspect the response status and failure or coverage fields.

- union
  - object
    - `requestId` string, uuid, required
    - `accounting` object, required
      - `upstreamRequests` integer, required
      - `responseBytes` integer, required
      - `durationMs` number, required
    - `success` true, required
    - `status` 'success' | 'partial', required
    - `type` 'video', required
    - `url` string, uri, required
    - `transcript` object[], nullable, required
      - `text` string, required
      - `startMs` string, required
      - `endMs` string, required
      - `startTimeText` string, required
    - `transcript_only_text` string, nullable, required
    - `language` string, nullable, required
    - `videoId` string, required
    - `captionTracks` object[], required
      - `baseUrl` string, uri, required
      - `name` object, required
        - `simpleText` string, required
      - `vssId` string, required
      - `languageCode` string, required
      - `kind` string
      - `isTranslatable` boolean
      - `trackName` string
    - `sourceUrl` string, uri, required
    - `fetchedAt` string, date-time, required
    - `coverage` object, required
      - `source` 'public_page' | 'public_api', required
      - `complete` boolean, required
      - `warnings` string[], required
      - `order` 'newest_first' | 'oldest_first' | 'ranked' | 'relevance' | 'source_order'
      - `window` object
        - `since` string, date-time
        - `until` string, date-time
  - object
    - `requestId` string, uuid, required
    - `accounting` object, required
      - `upstreamRequests` integer, required
      - `responseBytes` integer, required
      - `durationMs` number, required
    - `success` false, required
    - `status` 'failed' | 'challenged', required
    - `failure` object, required
      - `code` 'invalid_request' | 'unauthorized' | 'not_found' | 'upstream_challenged' | 'upstream_rate_limited' | 'upstream_error' | 'unsupported_page' | 'restricted_page' | 'response_too_large' | 'unsafe_redirect' | 'request_limit' | 'timeout' | 'busy' | 'payload_too_complex' | 'invalid_continuation' | 'age_restricted', required
      - `message` string, required

## Other responses

- `400`: Request could not complete; inspect error or failure.code.
- `401`: Request could not complete; inspect error or failure.code.
- `402`: Request could not complete; inspect error or failure.code.
- `403`: Request could not complete; inspect error or failure.code.
- `404`: Request could not complete; inspect error or failure.code.
- `408`: Request could not complete; inspect error or failure.code.
- `413`: Request could not complete; inspect error or failure.code.
- `429`: Request could not complete; inspect error or failure.code.
- `500`: Request could not complete; inspect error or failure.code.
- `502`: Request could not complete; inspect error or failure.code.
- `503`: Request could not complete; inspect error or failure.code.
- `504`: Request could not complete; inspect error or failure.code.

---

[API](https://skmtc.dev/scrapeatlas/apis/scrapeatlas-api.md) · [All operations](https://skmtc.dev/scrapeatlas/apis/scrapeatlas-api/llms.txt) · [OpenAPI document](https://skmtc.dev/scrapeatlas/apis/scrapeatlas-api/revisions/9ba049316894?raw)