# listyoutubeplaylists: List YouTube Playlists

> listyoutubeplaylists (List YouTube Playlists) is a 1001fx API function in the group YouTube: POST https://api.1001fx.com/youtube/listyoutubeplaylists, 3 credits per call. It works in Make, n8n, scripts and AI agents as a plain HTTP call.

**Deprecated:** this function will be removed in a future release.

Returns a collection of playlists that match the API request parameters.

- This service is provided by an external service provider: YouTube. The data of the call is sent to the provider. [More about service providers](https://1001fx.com/functions#serviceproviders)

- Group: YouTube
- Endpoint: `POST https://api.1001fx.com/youtube/listyoutubeplaylists`
- Authentication: header `X-API-KEY: YOURSECRETAPIKEY`
- Content type: application/json
- Credits: 3 credits per call
- Ready-made in: none, use an HTTP request
- Service provider: YouTube
- Docs: https://1001fx.com/functions/listyoutubeplaylists

## Parameters

- `credentialKey` (string, required) – 1001fx Credential Key: Your 1001fx credential key. See https://1001fx.com/app/credentials/list
- `ids` (array<string>, optional) – Playlist IDs: Comma seperated list of playlist IDs.
- `channelId` (string, optional) – Channel ID: This value indicates that the API should only return the specified channels playlists.
- `mine` (boolean, optional) – Mine: Set this parameters value to true to instruct the API to only return playlists owned by the authenticated user.
- `maxResults` (number, optional, default `5`, min 1, max 50) – Max Results: Defines how many comment threads to retrieve. Defaults to 5.
- `pageToken` (string, optional) – Page Token: The pageToken parameter identifies a specific page in the result set that should be returned. In an API response, the nextPageToken and prevPageToken properties identify other pages that could be retrieved.
- `hl` (string, optional, default `en`) – HL: The hl parameter specifies the language that should be used for text values in the API response. The default value is en. See https://1001fx.com/functions/listyoutubei18nlanguages.

## Example: Playlists of a channel

```bash
curl -X POST 'https://api.1001fx.com/youtube/listyoutubeplaylists' \
  -H 'X-API-KEY: YOURSECRETAPIKEY' \
  -H 'Content-Type: application/json' \
  -d '{"credentialKey":"yourCredentialKey","channelId":"UCFV937jVrmyxiR5NhILQlTQ","mine":false,"maxResults":5,"hl":"en"}'
```
