---
title: "Get a video's transcript"
method: GET
path: "/api/v1/transcript"
---

# Get a video's transcript

`GET /api/v1/transcript`

## Request

- Base URL: `https://bulktranscripts.co`
- URL: `https://bulktranscripts.co/api/v1/transcript`
- Auth: one of:
  - HTTP bearer
  - API key in header `X-API-Key`

Get a video's transcript Cost: 1 credit on first library addition; repeat reads are free.

## Query parameters

- `video` string, required
- `language` string
- `format` string
- `segments` string
- `timestamps` string
- `fresh` string

## Response `200`

OK

- Transcript
  - `video_id` string, required
  - `url` string, required
  - `title` string, required
  - `channel` string, nullable
  - `duration` integer, nullable
  - `duration_text` string, nullable
  - `upload_date` string, nullable
  - `language` string
  - `source` 'manual_caption' | 'auto_caption'
  - `cached` boolean
  - `word_count` integer
  - `text` string, required
  - `paragraphs` string[], required
  - `segments` Segment[]: Omitted when segments=0.
    - `text` string
    - `start` number
    - `duration` number
  - `billing` Billing, required: Present on every credited response. When billing is disabled on a self-hosted install only enabled/unlimited are set.
    - `enabled` boolean
    - `unlimited` boolean
    - `kind` 'anon' | 'license' | 'admin'
    - `remaining` integer
    - `used` integer
    - `granted` integer
    - `freeLimit` integer
    - `creditsCharged` integer

## Other responses

- `400`: Bad request (invalid_input, resolution_failed, or empty_source)
- `401`: Unauthorized (missing_api_key, invalid_api_key, or invalid_token)
- `402`: Out of credits (out_of_credits; carries purchase_url and reconnect_steps)
- `404`: Not found (no_transcript (video has no captions; not charged) or not_found)
- `429`: Rate limited (rate_limited; honour the Retry-After header (seconds))

---

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