# Spotify Artist Discography

Get an artist's releases, paginated across albums, singles, compilations and appearances.

- **Documentation:** [https://scrappa.co/docs/spotify-api/spotify_artist_discography](https://scrappa.co/docs/spotify-api/spotify_artist_discography)
- **API group:** Spotify API
- **Endpoint:** `GET https://scrappa.co/api/spotify/artist/discography`

## 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 artist id or full spotify:artist: URI.</p> |
| `limit` | integer | No | <p>Releases per page.</p> |
| `offset` | integer | No | <p>Release offset.</p> |

## Example response

```json
{
    "__typename": "Artist",
    "discography": {
        "all": {
            "items": [
                {
                    "releases": {
                        "items": [
                            {
                                "id": "5AFf68gtvNgGLZarsyEEL8",
                                "uri": "spotify:album:5AFf68gtvNgGLZarsyEEL8",
                                "date": {
                                    "year": 2023,
                                    "isoString": "2023-11-17T00:00:00Z",
                                    "precision": "DAY"
                                },
                                "name": "Random Access Memories (Drumless Edition)",
                                "type": "ALBUM",
                                "tracks": {
                                    "totalCount": 13
                                },
                                "coverArt": {
                                    "sources": [
                                        {
                                            "url": "https://i.scdn.co/image/ab67616d00001e02d1ec82bc061a90006584aa9b",
                                            "width": 300,
                                            "height": 300
                                        },
                                        {
                                            "url": "https://i.scdn.co/image/ab67616d00004851d1ec82bc061a90006584aa9b",
                                            "width": 64,
                                            "height": 64
                                        },
                                        {
                                            "url": "https://i.scdn.co/image/ab67616d0000b273d1ec82bc061a90006584aa9b",
                                            "width": 640,
                                            "height": 640
                                        }
                                    ]
                                },
                                "playability": {
                                    "reason": "PLAYABLE",
                                    "playable": true
                                },
                                "sharingInfo": {
                                    "shareId": "EZPJlUEEQValmX3IiKkZbw",
                                    "shareUrl": "https://open.spotify.com/album/5AFf68gtvNgGLZarsyEEL8?si=EZPJlUEEQValmX3IiKkZbw"
                                }
                            }
                        ]
                    }
                },
                {
                    "releases": {
                        "items": [
                            {
                                "id": "4mAhdh996uW5SnnFKXUmC0",
                                "uri": "spotify:album:4mAhdh996uW5SnnFKXUmC0",
                                "date": {
                                    "year": 2023,
                                    "isoString": "2023-05-12T00:00:00Z",
                                    "precision": "DAY"
                                },
                                "name": "Random Access Memories (10th Anniversary Edition)",
                                "type": "ALBUM",
                                "tracks": {
                                    "totalCount": 22
                                },
                                "coverArt": {
                                    "sources": [
                                        {
                                            "url": "https://i.scdn.co/image/ab67616d00001e027a311579a8814f7683f25a17",
                                            "width": 300,
                                            "height": 300
                                        },
                                        {
                                            "url": "https://i.scdn.co/image/ab67616d000048517a311579a8814f7683f25a17",
                                            "width": 64,
                                            "height": 64
                                        },
                                        {
                                            "url": "https://i.scdn.co/image/ab67616d0000b2737a311579a8814f7683f25a17",
                                            "width": 640,
                                            "height": 640
                                        }
                                    ]
                                },
                                "playability": {
                                    "reason": "PLAYABLE",
                                    "playable": true
                                },
                                "sharingInfo": {
                                    "shareId": "fsCZiowMSxOM2puhGtSP4g",
                                    "shareUrl": "https://open.spotify.com/album/4mAhdh996uW5SnnFKXUmC0?si=fsCZiowMSxOM2puhGtSP4g"
                                }
                            }
                        ]
                    }
                }
            ],
            "totalCount": 37
        }
    },
    "search_parameters": {
        "id": "4tZwfgrHOc3mvqYlEYSvVi",
        "limit": 50,
        "engine": "spotify_artist_discography",
        "offset": 0
    }
}
```

## 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)