# YouTube Playlist API Reference

Canonical: https://monsterapi.co/docs/api/youtube-playlist

Read the YouTube Playlist reference. Review parameters, response fields, examples, and current credit prices.

OpenAPI specification: [YouTube](https://monsterapi.co/docs/openapi/platforms/youtube.yaml).

---

Current operation prices: [public catalog](https://monsterapi.co/account/api/v1/public/api-prices). Prices use credits per request.

---

# YouTube: Playlist videos

`GET /youtube/api/playlist/{id}`

Documentation: https://monsterapi.co/docs/api/youtube#playlist-videos

Operation ID: `youtube_playlist_videos`

Returns one page of playlist information and videos. Pass next_cursor as cursor to this path with the same playlist ID.

## Authentication

Send your billing API key in the `Authorization: Bearer <YOUR_API_KEY>` header. Your account login is separate.

## Inputs

- `id` (path, required): Playlist ID from a YouTube URL list parameter or items[].id of type playlist in GET /search.

- `cursor` (query, optional): next_cursor from GET /playlist/{id}, for the same playlist.

## Responses

- 200:

- 400:

Refused at the gateway: the request target, path and query string together, is longer than 8,192 bytes; or the headers, the target counted among them, exceed 16,384 bytes or 64 fields

- 401: #/components/responses/GatewayUnauthorized

- 402: #/components/responses/GatewayPaymentRequired

- 403: #/components/responses/GatewayForbidden

- 404:

- 405: `method_not_allowed`: the endpoint answers GET alone, and any other method, HEAD included, is refused

Refused at the gateway: the path exists, but no operation on it takes the method of the request, HEAD included; `Allow` names the methods that do

- 409: #/components/responses/GatewayConflict

- 429: #/components/responses/GatewayTooManyRequests

- 500:

- 501:

- 503:

Refused at the gateway: the check could not complete, the account is suspended, or the platform did not answer; each may pass later, and `Retry-After` comes only when the platform did not answer

## Credits

Check the live price in the documentation before sending. Platform 2xx and 4xx responses can use credits, including empty data. Gateway refusals and 5xx responses do not use credits. Each pagination request is a separate call.

https://monsterapi.co/docs/pricing

## Request template

Replace path placeholders and add the required query parameters from the Inputs section before sending.

```shell

curl --get 'https://api.monsterapi.co/youtube/api/playlist/{id}' \
  -H 'Authorization: Bearer <YOUR_API_KEY>'

```