# Spotify Search

Search Spotify for tracks, albums, artists, playlists, podcasts, episodes and genres. Every populated section of the search response is returned.

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

## 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 |
| --- | --- | --- | --- |
| `q` | string | Yes | <p>Search terms, for example "daft punk".</p> |
| `limit` | integer | No | <p>Results per section. Maximum 50.</p> |
| `offset` | integer | No | <p>Result offset.</p> |

## Example response

```json
{
    "limit": 20,
    "query": "daft punk",
    "albums": {
        "items": [
            {
                "data": {
                    "uri": "spotify:album:2noRn2Aes5aoNVsU6iWThc",
                    "date": {
                        "year": 2001
                    },
                    "name": "Discovery",
                    "type": "ALBUM",
                    "artists": {
                        "items": [
                            {
                                "uri": "spotify:artist:4tZwfgrHOc3mvqYlEYSvVi",
                                "profile": {
                                    "name": "Daft Punk"
                                },
                                "onPlatformReputationTrait": {
                                    "verification": {
                                        "aiPersona": null
                                    }
                                }
                            }
                        ]
                    },
                    "coverArt": {
                        "sources": [
                            {
                                "url": "https://i.scdn.co/image/ab67616d00001e021e81bff9807a9e629fce5ade",
                                "width": 300,
                                "height": 300
                            },
                            {
                                "url": "https://i.scdn.co/image/ab67616d000048511e81bff9807a9e629fce5ade",
                                "width": 64,
                                "height": 64
                            },
                            {
                                "url": "https://i.scdn.co/image/ab67616d0000b2731e81bff9807a9e629fce5ade",
                                "width": 640,
                                "height": 640
                            }
                        ],
                        "extractedColors": {
                            "colorDark": {
                                "hex": "#302040",
                                "isFallback": false
                            }
                        }
                    },
                    "__typename": "Album",
                    "playability": {
                        "reason": "PLAYABLE",
                        "playable": true
                    },
                    "visualIdentity": {
                        "squareCoverImage": {
                            "__typename": "VisualIdentityImage",
                            "extractedColorSet": {
                                "minContrast": {
                                    "textBase": {
                                        "red": 255,
                                        "blue": 255,
                                        "alpha": 255,
                                        "green": 255
                                    },
                                    "textSubdued": {
                                        "red": 255,
                                        "blue": 255,
                                        "alpha": 255,
                                        "green": 255
                                    },
                                    "backgroundBase": {
                                        "red": 48,
                                        "blue": 64,
                                        "alpha": 255,
                                        "green": 32
                                    },
                                    "textBrightAccent": {
                                        "red": 255,
                                        "blue": 255,
                                        "alpha": 255,
                                        "green": 255
                                    },
                                    "backgroundTintedBase": {
                                        "red": 87,
                                        "blue": 106,
                                        "alpha": 255,
                                        "green": 71
                                    }
                                },
                                "highContrast": {
                                    "textBase": {
                                        "red": 255,
                                        "blue": 255,
                                        "alpha": 255,
                                        "green": 255
                                    },
                                    "textSubdued": {
                                        "red": 217,
                                        "blue": 239,
                                        "alpha": 255,
                                        "green": 198
                                    },
                                    "backgroundBase": {
                                        "red": 48,
                                        "blue": 64,
                                        "alpha": 255,
                                        "green": 32
                                    },
                                    "textBrightAccent": {
                                        "red": 255,
                                        "blue": 255,
                                        "alpha": 255,
                                        "green": 255
                                    },
                                    "backgroundTintedBase": {
                                        "red": 87,
                                        "blue": 106,
                                        "alpha": 255,
                                        "green": 71
                                    }
                                },
                                "higherContrast": {
                                    "textBase": {
                                        "red": 255,
                                        "blue": 255,
                                        "alpha": 255,
                                        "green": 255
                                    },
                                    "textSubdued": {
                                        "red": 217,
                                        "blue": 239,
                                        "alpha": 255,
                                        "green": 198
                                    },
                                    "backgroundBase": {
                                        "red": 48,
                                        "blue": 64,
                                        "alpha": 255,
                                        "green": 32
                                    },
                                    "textBrightAccent": {
                                        "red": 30,
                                        "blue": 96,
                                        "alpha": 255,
                                        "green": 215
                                    },
                                    "backgroundTintedBase": {
                                        "red": 87,
                                        "blue": 106,
                                        "alpha": 255,
                                        "green": 71
                                    }
                                },
                                "encoreBaseSetTextColor": {
                                    "red": 198,
                                    "blue": 220,
                                    "alpha": 255,
                                    "green": 179
                                }
                            }
                        }
                    },
                    "isAlbumPreRelease": false,
                    "preReleaseEndDateTime": null
                },
                "__typename": "AlbumResponseWrapper"
            }
        ],
        "totalCount": 25
    },
    "genres": {
        "items": [
            null
        ],
        "totalCount": 0
    },
    "offset": 0,
    "tracks": {
        "items": [
            {
                "item": {
                    "data": {
                        "id": "69kOkLUCkxIZYexIgSG8rq",
                        "uri": "spotify:track:69kOkLUCkxIZYexIgSG8rq",
                        "name": "Get Lucky (feat. Pharrell Williams and Nile Rodgers)",
                        "artists": {
                            "items": [
                                {
                                    "uri": "spotify:artist:4tZwfgrHOc3mvqYlEYSvVi",
                                    "profile": {
                                        "name": "Daft Punk"
                                    },
                                    "onPlatformReputationTrait": {
                                        "verification": {
                                            "aiPersona": null
                                        }
                                    }
                                },
                                {
                                    "uri": "spotify:artist:2RdwBSPQiwcmiDo9kixcl8",
                                    "profile": {
                                        "name": "Pharrell Williams"
                                    },
                                    "onPlatformReputationTrait": {
                                        "verification": {
                                            "aiPersona": null
                                        }
                                    }
                                },
                                {
                                    "uri": "spotify:artist:3yDIp0kaq9EFKe07X1X2rz",
                                    "profile": {
                                        "name": "Nile Rodgers"
                                    },
                                    "onPlatformReputationTrait": {
                                        "verification": {
                                            "aiPersona": null
                                        }
                                    }
                                }
                            ]
                        },
                        "duration": {
                            "totalMilliseconds": 369626
                        },
                        "__typename": "Track",
                        "playability": {
                            "reason": "PLAYABLE",
                            "playable": true
                        },
                        "albumOfTrack": {
                            "id": "4m2880jivSbbyEGAKfITCa",
                            "uri": "spotify:album:4m2880jivSbbyEGAKfITCa",
                            "name": "Random Access Memories",
                            "coverArt": {
                                "sources": [
                                    {
                                        "url": "https://i.scdn.co/image/ab67616d00001e029b9b36b0e22870b9f542d937",
                                        "width": 300,
                                        "height": 300
                                    },
                                    {
                                        "url": "https://i.scdn.co/image/ab67616d000048519b9b36b0e22870b9f542d937",
                                        "width": 64,
                                        "height": 64
                                    },
                                    {
                                        "url": "https://i.scdn.co/image/ab67616d0000b2739b9b36b0e22870b9f542d937",
                                        "width": 640,
                                        "height": 640
                                    }
                                ],
                                "extractedColors": {
                                    "colorDark": {
                                        "hex": "#6B778D",
                                        "isFallback": false
                                    }
                                }
                            },
                            "visualIdentity": {
                                "squareCoverImage": {
                                    "__typename": "VisualIdentityImage",
                                    "extractedColorSet": {
                                        "minContrast": {
                                            "textBase": {
                                                "red": 255,
                                                "blue": 255,
                                                "alpha": 255,
                                                "green": 255
                                            },
                                            "textSubdued": {
                                                "red": 255,
                                                "blue": 255,
                                                "alpha": 255,
                                                "green": 255
                                            },
                                            "backgroundBase": {
                                                "red": 138,
                                                "blue": 185,
                                                "alpha": 255,
                                                "green": 153
                                            },
                                            "textBrightAccent": {
                                                "red": 255,
                                                "blue": 255,
                                                "alpha": 255,
                                                "green": 255
                                            },
                                            "backgroundTintedBase": {
                                                "red": 114,
                                                "blue": 159,
                                                "alpha": 255,
                                                "green": 129
                                            }
                                        },
                                        "highContrast": {
                                            "textBase": {
                                                "red": 255,
                                                "blue": 255,
                                                "alpha": 255,
                                                "green": 255
                                            },
                                            "textSubdued": {
                                                "red": 189,
                                                "blue": 239,
                                                "alpha": 255,
                                                "green": 206
                                            },
                                            "backgroundBase": {
                                                "red": 69,
                                                "blue": 112,
                                                "alpha": 255,
                                                "green": 83
                                            },
                                            "textBrightAccent": {
                                                "red": 255,
                                                "blue": 255,
                                                "alpha": 255,
                                                "green": 255
                                            },
                                            "backgroundTintedBase": {
                                                "red": 38,
                                                "blue": 77,
                                                "alpha": 255,
                                                "green": 51
                                            }
                                        },
                                        "higherContrast": {
                                            "textBase": {
                                                "red": 255,
                                                "blue": 255,
                                                "alpha": 255,
                                                "green": 255
                                            },
                                            "textSubdued": {
                                                "red": 189,
                                                "blue": 239,
                                                "alpha": 255,
                                                "green": 206
                                            },
                                            "backgroundBase": {
                                                "red": 40,
                                                "blue": 79,
                                                "alpha": 255,
                                                "green": 53
                                            },
                                            "textBrightAccent": {
                                                "red": 30,
                                                "blue": 96,
                                                "alpha": 255,
                                                "green": 215
                                            },
                                            "backgroundTintedBase": {
                                                "red": 72,
                                                "blue": 114,
                                                "alpha": 255,
                                                "green": 86
                                            }
                                        },
                                        "encoreBaseSetTextColor": {
                                            "red": 171,
                                            "blue": 220,
                                            "alpha": 255,
                                            "green": 187
                                        }
                                    }
                                }
                            }
                        },
                        "contentRating": {
                            "label": "NONE"
                        },
                        "associationsV3": {
                            "audioAssociations": {
                                "totalCount": 0
                            },
                            "videoAssociations": {
                                "totalCount": 0
                            }
                        },
                        "trackMediaType": "AUDIO",
                        "visualIdentity": {
                            "sixteenByNineCoverImage": null
                        }
                    },
                    "__typename": "TrackResponseWrapper"
                },
                "matchedFields": []
            }
        ],
        "totalCount": 24
    },
    "artists": {
        "items": [
            {
                "data": {
                    "uri": "spotify:artist:4tZwfgrHOc3mvqYlEYSvVi",
                    "profile": {
                        "name": "Daft Punk"
                    },
                    "visuals": {
                        "avatarImage": {
                            "sources": [
                                {
                                    "url": "https://i.scdn.co/image/ab6761610000e5ebd3aa7cc0e419b6c459b08e8e",
                                    "width": 640,
                                    "height": 640
                                },
                                {
                                    "url": "https://i.scdn.co/image/ab6761610000f178d3aa7cc0e419b6c459b08e8e",
                                    "width": 160,
                                    "height": 160
                                },
                                {
                                    "url": "https://i.scdn.co/image/ab67616100005174d3aa7cc0e419b6c459b08e8e",
                                    "width": 320,
                                    "height": 320
                                }
                            ],
                            "extractedColors": {
                                "colorDark": {
                                    "hex": "#777777",
                                    "isFallback": false
                                }
                            }
                        }
                    },
                    "__typename": "Artist",
                    "visualIdentity": {
                        "squareCoverImage": {
                            "__typename": "VisualIdentityImage",
                            "extractedColorSet": {
                                "minContrast": {
                                    "textBase": {
                                        "red": 255,
                                        "blue": 255,
                                        "alpha": 255,
                                        "green": 255
                                    },
                                    "textSubdued": {
                                        "red": 255,
                                        "blue": 255,
                                        "alpha": 255,
                                        "green": 255
                                    },
                                    "backgroundBase": {
                                        "red": 153,
                                        "blue": 153,
                                        "alpha": 255,
                                        "green": 153
                                    },
                                    "textBrightAccent": {
                                        "red": 255,
                                        "blue": 255,
                                        "alpha": 255,
                                        "green": 255
                                    },
                                    "backgroundTintedBase": {
                                        "red": 128,
                                        "blue": 128,
                                        "alpha": 255,
                                        "green": 128
                                    }
                                },
                                "highContrast": {
                                    "textBase": {
                                        "red": 255,
                                        "blue": 255,
                                        "alpha": 255,
                                        "green": 255
                                    },
                                    "textSubdued": {
                                        "red": 205,
                                        "blue": 205,
                                        "alpha": 255,
                                        "green": 205
                                    },
                                    "backgroundBase": {
                                        "red": 83,
                                        "blue": 83,
                                        "alpha": 255,
                                        "green": 83
                                    },
                                    "textBrightAccent": {
                                        "red": 255,
                                        "blue": 255,
                                        "alpha": 255,
                                        "green": 255
                                    },
                                    "backgroundTintedBase": {
                                        "red": 51,
                                        "blue": 51,
                                        "alpha": 255,
                                        "green": 51
                                    }
                                },
                                "higherContrast": {
                                    "textBase": {
                                        "red": 255,
                                        "blue": 255,
                                        "alpha": 255,
                                        "green": 255
                                    },
                                    "textSubdued": {
                                        "red": 205,
                                        "blue": 205,
                                        "alpha": 255,
                                        "green": 205
                                    },
                                    "backgroundBase": {
                                        "red": 53,
                                        "blue": 53,
                                        "alpha": 255,
                                        "green": 53
                                    },
                                    "textBrightAccent": {
                                        "red": 30,
                                        "blue": 96,
                                        "alpha": 255,
                                        "green": 215
                                    },
                                    "backgroundTintedBase": {
                                        "red": 86,
                                        "blue": 86,
                                        "alpha": 255,
                                        "green": 86
                                    }
                                },
                                "encoreBaseSetTextColor": {
                                    "red": 232,
                                    "blue": 232,
                                    "alpha": 255,
                                    "green": 232
                                }
                            }
                        }
                    },
                    "onPlatformReputationTrait": {
                        "verification": {
                            "aiPersona": null,
                            "isVerified": true
                        }
                    }
                },
                "__typename": "ArtistResponseWrapper"
            }
        ],
        "totalCount": 20
    },
    "episodes": {
        "items": [
            {
                "data": {
                    "uri": "spotify:episode:61lFljZo00mXmbYkMt9Pmr",
                    "name": "E1 - Daft Punk: Robots With A Human Touch",
                    "coverArt": {
                        "sources": [
                            {
                                "url": "https://i.scdn.co/image/ab6765630000f68d1d2936e2becef82b900b4ff8",
                                "width": 64,
                                "height": 64
                            },
                            {
                                "url": "https://i.scdn.co/image/ab67656300005f1f1d2936e2becef82b900b4ff8",
                                "width": 300,
                                "height": 300
                            },
                            {
                                "url": "https://i.scdn.co/image/ab6765630000ba8a1d2936e2becef82b900b4ff8",
                                "width": 640,
                                "height": 640
                            }
                        ],
                        "extractedColors": {
                            "colorDark": {
                                "hex": "#72777C",
                                "isFallback": false
                            }
                        }
                    },
                    "duration": {
                        "totalMilliseconds": 2061909
                    },
                    "podcastV2": {
                        "data": {
                            "uri": "spotify:show:2b025hq3gJ17tQdxS3aV43",
                            "name": "Dissect",
                            "coverArt": {
                                "sources": [
                                    {
                                        "url": "https://i.scdn.co/image/ab6765630000f68d9b2ae3640834a0477f101733",
                                        "width": 64,
                                        "height": 64
                                    },
                                    {
                                        "url": "https://i.scdn.co/image/ab67656300005f1f9b2ae3640834a0477f101733",
                                        "width": 300,
                                        "height": 300
                                    },
                                    {
                                        "url": "https://i.scdn.co/image/ab6765630000ba8a9b2ae3640834a0477f101733",
                                        "width": 640,
                                        "height": 640
                                    }
                                ]
                            },
                            "mediaType": "MIXED",
                            "publisher": {
                                "name": "Spotify Studios"
                            },
                            "__typename": "Podcast"
                        },
                        "__typename": "PodcastResponseWrapper"
                    },
                    "__typename": "Episode",
                    "mediaTypes": [
                        "AUDIO",
                        "VIDEO"
                    ],
                    "description": "Our season-long dissection of Daft Punk begins now! In episode one, we trace Thomas Bangalter and Guy-Manuel de Homem-Christo\u2019s origins in Paris - from their rock band Darlin\u2019 to their discovery of electronic music and first single \u201cThe New Wave.\u201d Then we break down their breakthrough track \u201cDa Funk,\u201d revealing what it shares with Beethoven\u2019s most famous symphony and how to build its iconic synth sound from scratch. Follow @dissectpodcast on Instagram, Twitter, or TikTok. Host: Cole Cuchna Video Editor: Kevin Pooler Additional Editing: Iulia Ciobanu Additional Production: Justin Sayles Theme Music: Birocratic Learn more about your ad choices. Visit podcastchoices.com/adchoices",
                    "playability": {
                        "reason": "PLAYABLE"
                    },
                    "playedState": {
                        "state": "NOT_STARTED",
                        "playPositionMilliseconds": 0
                    },
                    "releaseDate": {
                        "isoString": "2026-03-17T10:01:00Z",
                        "precision": "MINUTE"
                    },
                    "restrictions": {
                        "paywallContent": false
                    },
                    "contentRating": {
                        "label": "NONE"
                    },
                    "visualIdentity": {
                        "squareCoverImage": {
                            "__typename": "VisualIdentityImage",
                            "extractedColorSet": {
                                "minContrast": {
                                    "textBase": {
                                        "red": 255,
                                        "blue": 255,
                                        "alpha": 255,
                                        "green": 255
                                    },
                                    "textSubdued": {
                                        "red": 255,
                                        "blue": 255,
                                        "alpha": 255,
                                        "green": 255
                                    },
                                    "backgroundBase": {
                                        "red": 146,
                                        "blue": 161,
                                        "alpha": 255,
                                        "green": 154
                                    },
                                    "textBrightAccent": {
                                        "red": 255,
                                        "blue": 255,
                                        "alpha": 255,
                                        "green": 255
                                    },
                                    "backgroundTintedBase": {
                                        "red": 122,
                                        "blue": 137,
                                        "alpha": 255,
                                        "green": 129
                                    }
                                },
                                "highContrast": {
                                    "textBase": {
                                        "red": 255,
                                        "blue": 255,
                                        "alpha": 255,
                                        "green": 255
                                    },
                                    "textSubdued": {
                                        "red": 198,
                                        "blue": 214,
                                        "alpha": 255,
                                        "green": 206
                                    },
                                    "backgroundBase": {
                                        "red": 77,
                                        "blue": 91,
                                        "alpha": 255,
                                        "green": 84
                                    },
                                    "textBrightAccent": {
                                        "red": 255,
                                        "blue": 255,
                                        "alpha": 255,
                                        "green": 255
                                    },
                                    "backgroundTintedBase": {
                                        "red": 45,
                                        "blue": 58,
                                        "alpha": 255,
                                        "green": 52
                                    }
                                },
                                "higherContrast": {
                                    "textBase": {
                                        "red": 255,
                                        "blue": 255,
                                        "alpha": 255,
                                        "green": 255
                                    },
                                    "textSubdued": {
                                        "red": 198,
                                        "blue": 214,
                                        "alpha": 255,
                                        "green": 206
                                    },
                                    "backgroundBase": {
                                        "red": 48,
                                        "blue": 60,
                                        "alpha": 255,
                                        "green": 54
                                    },
                                    "textBrightAccent": {
                                        "red": 30,
                                        "blue": 96,
                                        "alpha": 255,
                                        "green": 215
                                    },
                                    "backgroundTintedBase": {
                                        "red": 80,
                                        "blue": 94,
                                        "alpha": 255,
                                        "green": 87
                                    }
                                },
                                "encoreBaseSetTextColor": {
                                    "red": 192,
                                    "blue": 208,
                                    "alpha": 255,
                                    "green": 200
                                }
                            }
                        }
                    },
                    "gatedEntityRelations": [],
                    "videoPreviewThumbnail": {
                        "__typename": "VideoThumbnailImage",
                        "imagePreview": {
                            "data": {
                                "sources": [
                                    {
                                        "url": "https://image-cdn-ak.spotifycdn.com/image/ab6772ab000015be291bd80e2cec8a2f5dad503e",
                                        "maxWidth": 640,
                                        "maxHeight": 360
                                    },
                                    {
                                        "url": "https://image-cdn-ak.spotifycdn.com/image/ab6772ab00001692291bd80e2cec8a2f5dad503e",
                                        "maxWidth": 1280,
                                        "maxHeight": 720
                                    }
                                ],
                                "__typename": "ImageV2"
                            }
                        }
                    }
                },
                "__typename": "EpisodeResponseWrapper"
            }
        ],
        "totalCount": 20
    },
    "podcasts": {
        "items": [
            {
                "data": {
                    "uri": "spotify:show:7BJuiIp6JWJa8HBVIZCGua",
                    "name": "Daft Punk",
                    "topics": {
                        "items": [
                            {
                                "uri": "spotify:genre:music_interviews_podcasts-page",
                                "title": "Music",
                                "__typename": "PodcastTopic"
                            }
                        ]
                    },
                    "coverArt": {
                        "sources": [
                            {
                                "url": "https://i.scdn.co/image/ab6765630000f68d8bab886089ff549e2a30cea2",
                                "width": 64,
                                "height": 64
                            },
                            {
                                "url": "https://i.scdn.co/image/ab67656300005f1f8bab886089ff549e2a30cea2",
                                "width": 300,
                                "height": 300
                            },
                            {
                                "url": "https://i.scdn.co/image/ab6765630000ba8a8bab886089ff549e2a30cea2",
                                "width": 640,
                                "height": 640
                            }
                        ],
                        "extractedColors": {
                            "colorDark": {
                                "hex": "#387090",
                                "isFallback": false
                            }
                        }
                    },
                    "mediaType": "AUDIO",
                    "publisher": {
                        "name": "Gabo Jolly"
                    },
                    "__typename": "Podcast",
                    "visualIdentity": {
                        "squareCoverImage": {
                            "__typename": "VisualIdentityImage",
                            "extractedColorSet": {
                                "minContrast": {
                                    "textBase": {
                                        "red": 255,
                                        "blue": 255,
                                        "alpha": 255,
                                        "green": 255
                                    },
                                    "textSubdued": {
                                        "red": 255,
                                        "blue": 255,
                                        "alpha": 255,
                                        "green": 255
                                    },
                                    "backgroundBase": {
                                        "red": 56,
                                        "blue": 144,
                                        "alpha": 255,
                                        "green": 112
                                    },
                                    "textBrightAccent": {
                                        "red": 255,
                                        "blue": 255,
                                        "alpha": 255,
                                        "green": 255
                                    },
                                    "backgroundTintedBase": {
                                        "red": 23,
                                        "blue": 113,
                                        "alpha": 255,
                                        "green": 82
                                    }
                                },
                                "highContrast": {
                                    "textBase": {
                                        "red": 255,
                                        "blue": 255,
                                        "alpha": 255,
                                        "green": 255
                                    },
                                    "textSubdued": {
                                        "red": 155,
                                        "blue": 248,
                                        "alpha": 255,
                                        "green": 213
                                    },
                                    "backgroundBase": {
                                        "red": 30,
                                        "blue": 119,
                                        "alpha": 255,
                                        "green": 88
                                    },
                                    "textBrightAccent": {
                                        "red": 255,
                                        "blue": 255,
                                        "alpha": 255,
                                        "green": 255
                                    },
                                    "backgroundTintedBase": {
                                        "red": 0,
                                        "blue": 82,
                                        "alpha": 255,
                                        "green": 53
                                    }
                                },
                                "higherContrast": {
                                    "textBase": {
                                        "red": 255,
                                        "blue": 255,
                                        "alpha": 255,
                                        "green": 255
                                    },
                                    "textSubdued": {
                                        "red": 155,
                                        "blue": 248,
                                        "alpha": 255,
                                        "green": 213
                                    },
                                    "backgroundBase": {
                                        "red": 0,
                                        "blue": 84,
                                        "alpha": 255,
                                        "green": 55
                                    },
                                    "textBrightAccent": {
                                        "red": 30,
                                        "blue": 96,
                                        "alpha": 255,
                                        "green": 215
                                    },
                                    "backgroundTintedBase": {
                                        "red": 42,
                                        "blue": 121,
                                        "alpha": 255,
                                        "green": 90
                                    }
                                },
                                "encoreBaseSetTextColor": {
                                    "red": 136,
                                    "blue": 229,
                                    "alpha": 255,
                                    "green": 194
                                }
                            }
                        }
                    }
                },
                "__typename": "PodcastResponseWrapper"
            }
        ],
        "totalCount": 20
    },
    "playlists": {
        "items": [
            {
                "data": {
                    "uri": "spotify:playlist:2jTy5QwqWJ1ZUv2XeJPYbn",
                    "name": "Daft Punk Greatest Hits",
                    "format": "",
                    "images": {
                        "items": [
                            {
                                "sources": [
                                    {
                                        "url": "https://image-cdn-fa.spotifycdn.com/image/ab67706c0000d72cbb071380835cf25eafa2f681",
                                        "width": null,
                                        "height": null
                                    }
                                ],
                                "extractedColors": {
                                    "colorDark": {
                                        "hex": "#180858",
                                        "isFallback": false
                                    }
                                }
                            }
                        ]
                    },
                    "ownerV2": {
                        "data": {
                            "uri": "spotify:user:brunejos",
                            "name": "Red Franzen",
                            "avatar": {
                                "sources": [
                                    {
                                        "url": "https://i.scdn.co/image/ab67757000003b8221b0217a2544bb8532533056",
                                        "width": 64,
                                        "height": 64
                                    },
                                    {
                                        "url": "https://i.scdn.co/image/ab6775700000ee8521b0217a2544bb8532533056",
                                        "width": 300,
                                        "height": 300
                                    }
                                ]
                            },
                            "username": "brunejos",
                            "__typename": "User",
                            "socialHandle": null
                        },
                        "__typename": "UserResponseWrapper"
                    },
                    "__typename": "Playlist",
                    "attributes": [],
                    "description": "Best hits of this awesome band!",
                    "visualIdentity": {
                        "squareCoverImage": {
                            "__typename": "VisualIdentityImage",
                            "extractedColorSet": {
                                "minContrast": {
                                    "textBase": {
                                        "red": 255,
                                        "blue": 255,
                                        "alpha": 255,
                                        "green": 255
                                    },
                                    "textSubdued": {
                                        "red": 255,
                                        "blue": 255,
                                        "alpha": 255,
                                        "green": 255
                                    },
                                    "backgroundBase": {
                                        "red": 24,
                                        "blue": 88,
                                        "alpha": 255,
                                        "green": 8
                                    },
                                    "textBrightAccent": {
                                        "red": 255,
                                        "blue": 255,
                                        "alpha": 255,
                                        "green": 255
                                    },
                                    "backgroundTintedBase": {
                                        "red": 64,
                                        "blue": 144,
                                        "alpha": 255,
                                        "green": 64
                                    }
                                },
                                "highContrast": {
                                    "textBase": {
                                        "red": 255,
                                        "blue": 255,
                                        "alpha": 255,
                                        "green": 255
                                    },
                                    "textSubdued": {
                                        "red": 195,
                                        "blue": 255,
                                        "alpha": 255,
                                        "green": 202
                                    },
                                    "backgroundBase": {
                                        "red": 24,
                                        "blue": 88,
                                        "alpha": 255,
                                        "green": 8
                                    },
                                    "textBrightAccent": {
                                        "red": 255,
                                        "blue": 255,
                                        "alpha": 255,
                                        "green": 255
                                    },
                                    "backgroundTintedBase": {
                                        "red": 64,
                                        "blue": 144,
                                        "alpha": 255,
                                        "green": 64
                                    }
                                },
                                "higherContrast": {
                                    "textBase": {
                                        "red": 255,
                                        "blue": 255,
                                        "alpha": 255,
                                        "green": 255
                                    },
                                    "textSubdued": {
                                        "red": 195,
                                        "blue": 255,
                                        "alpha": 255,
                                        "green": 202
                                    },
                                    "backgroundBase": {
                                        "red": 24,
                                        "blue": 88,
                                        "alpha": 255,
                                        "green": 8
                                    },
                                    "textBrightAccent": {
                                        "red": 30,
                                        "blue": 96,
                                        "alpha": 255,
                                        "green": 215
                                    },
                                    "backgroundTintedBase": {
                                        "red": 64,
                                        "blue": 144,
                                        "alpha": 255,
                                        "green": 64
                                    }
                                },
                                "encoreBaseSetTextColor": {
                                    "red": 173,
                                    "blue": 255,
                                    "alpha": 255,
                                    "green": 182
                                }
                            }
                        }
                    }
                },
                "__typename": "PlaylistResponseWrapper"
            }
        ],
        "totalCount": 31
    },
    "search_parameters": {
        "q": "daft punk",
        "limit": 20,
        "engine": "spotify_search",
        "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)
