Spotify API endpoint
Returns a Spotify artist's profile by artist URI, `open.spotify.com` URL or id: name, verified flag, follower count, monthly listeners (`monthlyUsers`), biography and images, plus top tracks, selected discography, related artists and artist playlists when Spotify returns them.
/spotify/artistReturns Spotify artist overview data.
uri: Spotify artist URI or open.spotify.com/artist/... URL.id: Spotify artist ID. Used when uri is omitted.The response includes artist profile data, image assets, top tracks, selected discography, related artists, and artist playlists when Spotify returns them. Invalid identifiers return 400; upstream failures return 503.
| Field | Filled in, of 10 checked | Values in the sample |
|---|---|---|
| uri | 10 | “spotify:track:3C0nOe05EIt1390bVABLyN” and 9 other values |
| title | 10 | “On The Floor” and 9 other values |
| imageUrl | 10 | i.scdn.co |
| images | 10 | median 3 entries |
| externalUrl | 10 | open.spotify.com |
| Parameter | Type | Required | Default | Description | Example |
|---|---|---|---|---|---|
| uri | string | No | Spotify artist URI or open.spotify.com artist URL | spotify:artist:0TnOYISbd1XYRBk9myaseg | |
| id | string | No | Spotify artist ID | 0TnOYISbd1XYRBk9myaseg | |
| x-api-key (header) | string | Yes | API key required |
curl -X GET "https://api.crawlora.net/api/v1/spotify/artist" \ -H "x-api-key: $CRAWLORA_API_KEY"
{
"code": 200,
"msg": "OK",
"data": {
"uri": "spotify:artist:0TnOYISbd1XYRBk9myaseg",
"name": "Pitbull",
"topTracks": [
{
"uri": "spotify:track:4vGg44GdCw3X8i8r01XJH0",
"title": "Example Track"
}
],
"meta": {
"operationName": "queryArtistOverview",
"fetchedAt": "2026-05-13T20:41:13Z"
}
}
}Request schema
No body schema
Response schema
#/definitions/spotify.artistResponseDoc
| Field | Type | Required | Enum | Bounds | Example | Description |
|---|---|---|---|---|---|---|
| code | integer | No | Code is the HTTP status code or a custom code used to indicate the result of the request @example 200 | |||
| data | spotify.ArtistResponse | No | ||||
| data.biography | string | No | Artist biography text. | |||
| data.discography | array | No | Selection of the artist's albums and releases. | |||
| data.discography[].description | string | No | The official podcast of comedian Joe Rogan. | Description text of the result. | ||
| data.discography[].externalUrl | string | No | https://open.spotify.com/show/4rOoJ6Egrf8K2IrywzwOMk | Link to the result on open.spotify.com. | ||
| data.discography[].imageUrl | string | No | https://i.scdn.co/image/ab67656300005f1f54e6837957803d762a3f4d2b | URL of the main image for the result. | ||
| data.discography[].images | array | No | Images available for the result, with their sizes. | |||
| data.discography[].images[].height | integer | No | 640 | Image height in pixels. | ||
| data.discography[].images[].url | string | No | https://i.scdn.co/image/ab6765630000ba8ab0484f8ee2933eceab32bac0 | URL of the image. | ||
| data.discography[].images[].width | integer | No | 640 | Image width in pixels. | ||
| data.discography[].publisher | string | No | Joe Rogan | Publisher or creator name of the result. | ||
| data.discography[].subtitle | string | No | Joe Rogan | Secondary line shown under the title, such as the artist or creator name. | ||
| data.discography[].title | string | No | The Joe Rogan Experience | Result title as Spotify shows it. | ||
| data.discography[].type | string | No | Podcast | Kind of result as Spotify labels it, for example `Podcast`. | ||
| data.discography[].uri | string | No | spotify:show:4rOoJ6Egrf8K2IrywzwOMk | Spotify URI of the result. | ||
| data.externalUrl | string | No | Link to the artist on open.spotify.com. | |||
| data.followers | integer | No | Number of Spotify followers the artist has. | |||
| data.id | string | No | Spotify ID of the artist. | |||
| data.imageUrl | string | No | URL of the main artist image. | |||
| data.images | array | No | Images available for the artist, with their sizes. | |||
| data.images[].height | integer | No | 640 | Image height in pixels. | ||
| data.images[].url | string | No | https://i.scdn.co/image/ab6765630000ba8ab0484f8ee2933eceab32bac0 | URL of the image. | ||
| data.images[].width | integer | No | 640 | Image width in pixels. | ||
| data.meta | object | No | Details about this response. | |||
| data.meta.appVersion | string | No | Version of the Spotify web player the data was read from. | |||
| data.meta.discographyCount | integer | No | Number of discography entries returned. | |||
| data.meta.fetchedAt | string | No | Time the data was fetched, in UTC (RFC 3339). | |||
| data.meta.operationName | string | No | Name of the Spotify web player operation that returned the data. | |||
| data.meta.playlistCount | integer | No | Number of playlists returned. | |||
| data.meta.relatedCount | integer | No | Number of related artists returned. | |||
| data.meta.topTrackCount | integer | No | Number of top tracks returned. | |||
| data.monthlyUsers | integer | No | Number of monthly listeners Spotify shows for the artist. | |||
| data.name | string | No | Artist name as Spotify shows it. | |||
| data.playlists | array | No | Playlists featuring the artist. | |||
| data.playlists[].description | string | No | The official podcast of comedian Joe Rogan. | Description text of the result. | ||
| data.playlists[].externalUrl | string | No | https://open.spotify.com/show/4rOoJ6Egrf8K2IrywzwOMk | Link to the result on open.spotify.com. | ||
| data.playlists[].imageUrl | string | No | https://i.scdn.co/image/ab67656300005f1f54e6837957803d762a3f4d2b | URL of the main image for the result. | ||
| data.playlists[].images | array | No | Images available for the result, with their sizes. | |||
| data.playlists[].images[].height | integer | No | 640 | Image height in pixels. | ||
| data.playlists[].images[].url | string | No | https://i.scdn.co/image/ab6765630000ba8ab0484f8ee2933eceab32bac0 | URL of the image. | ||
| data.playlists[].images[].width | integer | No | 640 | Image width in pixels. | ||
| data.playlists[].publisher | string | No | Joe Rogan | Publisher or creator name of the result. | ||
| data.playlists[].subtitle | string | No | Joe Rogan | Secondary line shown under the title, such as the artist or creator name. | ||
| data.playlists[].title | string | No | The Joe Rogan Experience | Result title as Spotify shows it. | ||
| data.playlists[].type | string | No | Podcast | Kind of result as Spotify labels it, for example `Podcast`. | ||
| data.playlists[].uri | string | No | spotify:show:4rOoJ6Egrf8K2IrywzwOMk | Spotify URI of the result. | ||
| data.related | array | No | Artists related to this artist. | |||
| data.related[].description | string | No | The official podcast of comedian Joe Rogan. | Description text of the result. | ||
| data.related[].externalUrl | string | No | https://open.spotify.com/show/4rOoJ6Egrf8K2IrywzwOMk | Link to the result on open.spotify.com. | ||
| data.related[].imageUrl | string | No | https://i.scdn.co/image/ab67656300005f1f54e6837957803d762a3f4d2b | URL of the main image for the result. | ||
| data.related[].images | array | No | Images available for the result, with their sizes. | |||
| data.related[].images[].height | integer | No | 640 | Image height in pixels. | ||
| data.related[].images[].url | string | No | https://i.scdn.co/image/ab6765630000ba8ab0484f8ee2933eceab32bac0 | URL of the image. | ||
| data.related[].images[].width | integer | No | 640 | Image width in pixels. | ||
| data.related[].publisher | string | No | Joe Rogan | Publisher or creator name of the result. | ||
| data.related[].subtitle | string | No | Joe Rogan | Secondary line shown under the title, such as the artist or creator name. | ||
| data.related[].title | string | No | The Joe Rogan Experience | Result title as Spotify shows it. | ||
| data.related[].type | string | No | Podcast | Kind of result as Spotify labels it, for example `Podcast`. | ||
| data.related[].uri | string | No | spotify:show:4rOoJ6Egrf8K2IrywzwOMk | Spotify URI of the result. | ||
| data.shareUrl | string | No | Link to the artist that Spotify offers for sharing. | |||
| data.topTracks | array | No | Most popular tracks of the artist. | |||
| data.topTracks[].description | string | No | The official podcast of comedian Joe Rogan. | Description text of the result. | ||
| data.topTracks[].externalUrl | string | No | https://open.spotify.com/show/4rOoJ6Egrf8K2IrywzwOMk | Link to the result on open.spotify.com. | ||
| data.topTracks[].imageUrl | string | No | https://i.scdn.co/image/ab67656300005f1f54e6837957803d762a3f4d2b | URL of the main image for the result. | ||
| data.topTracks[].images | array | No | Images available for the result, with their sizes. | |||
| data.topTracks[].images[].height | integer | No | 640 | Image height in pixels. | ||
| data.topTracks[].images[].url | string | No | https://i.scdn.co/image/ab6765630000ba8ab0484f8ee2933eceab32bac0 | URL of the image. | ||
| data.topTracks[].images[].width | integer | No | 640 | Image width in pixels. | ||
| data.topTracks[].publisher | string | No | Joe Rogan | Publisher or creator name of the result. | ||
| data.topTracks[].subtitle | string | No | Joe Rogan | Secondary line shown under the title, such as the artist or creator name. | ||
| data.topTracks[].title | string | No | The Joe Rogan Experience | Result title as Spotify shows it. | ||
| data.topTracks[].type | string | No | Podcast | Kind of result as Spotify labels it, for example `Podcast`. | ||
| data.topTracks[].uri | string | No | spotify:show:4rOoJ6Egrf8K2IrywzwOMk | Spotify URI of the result. | ||
| data.type | string | No | Kind of item as Spotify labels it, for example `Artist`. | |||
| data.uri | string | No | Spotify URI of the artist. | |||
| data.verified | boolean | No | Whether Spotify shows the artist as verified. | |||
| msg | unknown | No | Msg is the message that describes the result of the request @example "Request successful" |
| Status | Description | Schema |
|---|---|---|
| 400 | Bad Request | #/definitions/app.Response |
| 429 | Too Many Requests | #/definitions/app.Response |
| 503 | Service Unavailable | #/definitions/app.Response |
Use environment variables for secrets and keep Crawlora API keys server-side.
curl -X GET "https://api.crawlora.net/api/v1/spotify/artist" \
-H "x-api-key: $CRAWLORA_API_KEY"