# Spotify Album Tracks

Get album tracks in order. One page by default; ask for all=true to walk the whole album, where each page is a separate upstream lookup charged separately. The walk stops at 1,000 items or a 20-second budget, whichever comes first, and truncated=true says so.

- **Documentation:** [https://scrappa.co/docs/spotify-api/spotify_album_tracks](https://scrappa.co/docs/spotify-api/spotify_album_tracks)
- **API group:** Spotify API
- **Endpoint:** `GET https://scrappa.co/api/spotify/album/tracks`

## Authentication

Send your Scrappa API key in the `X-API-KEY` request header. Paid endpoints also support accountless x402 payments when called without an API key.

## Parameters

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `id` | string | Yes | <p>Spotify album id or full spotify:album: URI.</p> |
| `limit` | integer | No | <p>Maximum number of items to return.</p> |
| `all` | boolean | No | <p>Walk the whole list. Cannot be combined with limit. Each page is a separate upstream lookup and is charged separately; the walk stops at 1,000 items or a 20-second budget, whichever comes first, and truncated=true says so.</p> |

## Example response

```json
{
    "tracks": [
        {
            "track": {
                "uri": "spotify:track:6b5P51m8xx2XA6U7sdNZ5E"
            }
        },
        {
            "track": {
                "uri": "spotify:track:2K9Ovn1o2bTGqbsABGC6m3"
            }
        }
    ],
    "album_id": "4yP0hdKOZPNshxUOjY0cZj",
    "returned": 2,
    "truncated": true,
    "total_count": 14,
    "search_parameters": {
        "id": "4yP0hdKOZPNshxUOjY0cZj",
        "engine": "spotify_album_tracks"
    }
}
```

## Errors

| Status | Error | Description |
| --- | --- | --- |
| 404 | Not Found | No Spotify data exists for the requested id or chart key. Failed requests are never charged. |
| 422 | Validation Error | A required parameter is missing or invalid. See the errors object for the offending field. |
| 503 | Upstream Unavailable | Spotify could not be reached or returned an unusable response. This is a failed request and is never charged; it is safe to retry. |

## More Scrappa resources

- [API documentation](https://scrappa.co/docs)
- [Full LLM-readable API reference](https://scrappa.co/llms-full.txt)
- [OpenAPI specification](https://scrappa.co/docs/api.json)
- [Pricing](https://scrappa.co/pricing)