> ## Documentation Index
> Fetch the complete documentation index at: https://deepline.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# ScrapeCreators: Spotify Playlist

> Retrieves public Spotify playlist metadata and up to 50 tracks by playlist id or URL. Includes inputs, outputs, SDK V2 examples, and Deepline cost.

Retrieves public Spotify playlist metadata and up to 50 tracks by playlist id or URL.

> [!NOTE]
>
> Tool ID: `scrapecreators_spotify_playlist`

## Run this action

Use the TypeScript SDK for one call. Use `ctx.tools.execute(...)` inside a Play for durable calls, scheduled calls, or CSV processing.

```ts theme={"languages":{"custom":["/languages/deepline-prompt.json"]}}
import { Deepline } from 'deepline';

const deepline = await Deepline.connect();
const result = await deepline.tools.execute(
  'scrapecreators_spotify_playlist',
  {
    "id": "id_123",
    "url": "https://example.com",
    "cursor": "cursor_123"
  },
);

console.log(result.toolResponse.raw);
```

### CLI

```bash theme={"languages":{"custom":["/languages/deepline-prompt.json"]}}
deepline tools execute scrapecreators_spotify_playlist --input '{
  "id": "id_123",
  "url": "https://example.com",
  "cursor": "cursor_123"
}' --json
```

## Example response

The static output schema lacks the details for a reliable example. Use `deepline describe scrapecreators_spotify_playlist --json` for the complete live contract.

## Input reference

Retrieves public Spotify playlist metadata and up to 50 tracks by playlist id or URL. For playlists with more tracks, pass the returned cursor into the next request until cursor is null.

| Name | Type | Required | Default | Details |
| - | - | - | - | - |
| `payload.id` | `string` | No | — | Spotify playlist id. If you'd prefer to use the URL instead, you can use the url parameter instead. |
| `payload.url` | `string` | No | — | Spotify playlist URL. If you'd prefer to use the id instead, you can use the id parameter instead. |
| `payload.cursor` | `string` | No | — | Cursor returned by the previous response. Omit it for the first page. |

<details>
  <summary>Show raw input schema</summary>

  ### Input JSON Schema

  ```json theme={"languages":{"custom":["/languages/deepline-prompt.json"]}}
  {
    "type": "object",
    "description": "Retrieves public Spotify playlist metadata and up to 50 tracks by playlist id or URL. For playlists with more tracks, pass the returned cursor into the next request until cursor is null.",
    "properties": {
      "id": {
        "type": "string",
        "description": "Spotify playlist id. If you'd prefer to use the URL instead, you can use the url parameter instead."
      },
      "url": {
        "type": "string",
        "description": "Spotify playlist URL. If you'd prefer to use the id instead, you can use the id parameter instead."
      },
      "cursor": {
        "type": "string",
        "description": "Cursor returned by the previous response. Omit it for the first page."
      }
    },
    "required": [],
    "additionalProperties": false
  }
  ```
</details>

## Output reference

Standard tool result payload.

| Name | Type | Required | Default | Details |
| - | - | - | - | - |
| `result.data` | `unknown` | Yes | — | Provider response payload. |
| `result.meta` | `object` | No | — | Additional response metadata (status, paging). |

<details>
  <summary>Show raw output schema</summary>

  ### Output JSON Schema

  ```json theme={"languages":{"custom":["/languages/deepline-prompt.json"]}}
  {
    "type": "object",
    "description": "Standard tool result payload.",
    "properties": {
      "data": {
        "description": "Provider response payload."
      },
      "meta": {
        "type": "object",
        "description": "Additional response metadata (status, paging).",
        "additionalProperties": true
      }
    },
    "required": [
      "data"
    ],
    "additionalProperties": false
  }
  ```
</details>

## Deepline cost

* Pricing model: `fixed` (per call).
* Estimated Deepline credits: `0.02` per pricing unit.

## Related documentation

* [ScrapeCreators provider guide](https://deepline.com/docs/providers/scrapecreators/guide.md)
* [SDK V2 quickstart](https://deepline.com/docs/sdk-v2/quickstart.md)
* [SDK reference](https://deepline.com/docs/sdk-v2/sdk-reference.md)
* [Run tools across a CSV](https://deepline.com/docs/sdk-v2/batch-csv.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.