---
title: "List a playlist's videos in order"
method: GET
path: "/api/v1/playlist/videos"
---

# List a playlist's videos in order

`GET /api/v1/playlist/videos`

## Request

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

List a playlist's videos in order Cost: 1 credit.

## Query parameters

- `playlist` string, required
- `limit` integer

## Response `200`

OK

- VideoList
  - `title` string, nullable
  - `count` integer
  - `has_more` boolean: True whenever the result reached limit. No pagination; raise limit.
  - `results` object[]
    - `id` string
    - `url` string
    - `title` string
    - `channel` string, nullable
    - `published` string, nullable: ISO date; may be null when YouTube omits it.
    - `views` string, nullable
  - `billing` Billing: 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)
- `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)