Spotify

Spotify catalog search (tracks, artists, albums, playlists, podcasts, episodes, audiobooks, users, genres, authors); full public detail for an artist (profile, monthly listeners, top cities, top tracks, related artists, concerts, music videos), an artist's discography, an album, a track with its play count, credits and preview, a playlist with its tracks, a podcast or audiobook with its episodes or chapters, an episode, a concert with its ticket offers, and a venue; recommendations for a track, episode or podcast; and the browse and genre pages, the home feed, each country's charts and the concert feed for a city.

Call these actions with your String API key; see Authentication. Every call answers with the envelope described in Responses & errors, whose data holds the rows below.

Site: spotify
Version: 1.0.0
Reads from: open.spotify.com

Action	Description	Listed price
`search`	Search Spotify's catalog as the web player's search does, across tracks, artists, albums, playlists, podcasts, episodes, audiobooks, users, genres and authors, or only the types asked for. Each row is one result with its type, rank, id, link, name and image, plus what that type carries: a track's artists, album, duration and explicit flag; an artist's verified badge; an album's type and release date; a playlist's owner and description; a podcast's publisher; an episode's show and date; an audiobook's authors; a genre's image; an author's biography. Spotify serves up to 1,000 results per type.	Billed per request at your plan's rates
`artist`	Read each Spotify artist's public page: name, verified badge, biography, avatar, header and gallery images, followers, monthly listeners, world rank, top cities by listeners, external links (Instagram, Wikipedia and others), top tracks with play counts, popular and latest releases, the pinned item, how many albums, singles, compilations and appearances the artist has, every related artist (Fans also like), Spotify's playlists featuring the artist, the playlists listeners discovered them on, the artist's own playlists, upcoming concerts and music videos. The discography action lists the releases themselves.	Billed per request at your plan's rates
`discography`	List a Spotify artist's releases, newest first: every album, single, EP and compilation, or one of those groups, or the other artists' releases they appear on. Each row is a release: name, type, release date, track count, cover image and link. Read a release's tracks with the album action.	Billed per request at your plan's rates
`album`	Read each Spotify album, single, EP or compilation: name, type, artists, release date, label, copyright and distribution lines, whether it is still a pre-release and when it comes out, cover image, disc and track counts, and every track with its artists, duration, explicit flag and play count.	Billed per request at your plan's rates
`track`	Read each Spotify track: name, every credited artist, album, duration, explicit flag, all-time play count, track and disc number, the release's type, date, track count, copyright and distribution lines, a 30-second preview URL, and every credit (performers, writers, producers) with who supplied it.	Billed per request at your plan's rates
`playlist`	Read a Spotify playlist: name, description, owner, follower count, cover image and total length, and its tracks in order (up to 10,000), each with artists, album, duration, explicit flag, play count, and who added it and when.	Billed per request at your plan's rates
`show`	Read a Spotify podcast or audiobook: name, publisher, description, cover, explicit flag, media type, listener rating, topics or genres, an audiobook's authors, narrators, publish date, length and price, and the podcast's episodes newest first or the audiobook's chapters in order (up to 3,000), each with its description, duration, release date and playability.	Billed per request at your plan's rates
`episode`	Read each Spotify podcast episode or audiobook chapter: name, show notes, duration, release date, explicit flag, playability, audio or video, cover, public preview link, and the show it belongs to.	Billed per request at your plan's rates
`recommendations`	Read what Spotify recommends alongside each track, podcast episode or podcast, as the web player's More like this shelves list it: for a track, similar tracks (with play counts) and albums; for an episode, similar episodes; for a podcast, similar podcasts. Each row is one recommendation with its type, rank, id, link, name and image, plus what that type carries, and the entity it is recommended for.	Billed per request at your plan's rates
`concert`	Read each Spotify concert or festival page: title, start time, doors, the artists on the bill, the venue with its city, country and coordinates, genre tags, related dates, and every ticket offer with its seller, link, sale type, sale window and price where shown. The artist action lists an artist's concerts; the concerts action lists a city's.	Billed per request at your plan's rates
`venue`	Read each Spotify venue page: name, address, city, country, genre tags, and its upcoming concerts with their date, title and bill.	Billed per request at your plan's rates
`concerts`	List the upcoming concerts near a city as the web player's Live Events feed does, soonest first: each concert's title, start time, venue, city and bill, and whether Spotify counts it among the city's popular events. The concert action reads one in full.	Billed per request at your plan's rates
`browse`	Read Spotify's Browse all grid of categories, or one genre or category page (Music, Pop, Podcasts and the rest) shelf by shelf, for a chosen market: each row is one item on a shelf (a playlist, album, artist, podcast, episode or sub-category) with the shelf's title, its rank on the shelf, and what that type carries.	Billed per request at your plan's rates
`home`	Read the home feed Spotify shows a logged-out visitor in a chosen market: trending songs, popular artists, albums and radio, featured charts and the rest, shelf by shelf. Each row is one item with its shelf's title, its rank on the shelf, and what its type carries.	Billed per request at your plan's rates
`charts`	Read each country's charts page on Spotify: its chart playlists (Top Songs and Top 50 for the country and the world, which the playlist action reads track by track), and its top 50 trending songs, popular artists and popular albums, in rank order. Each row is one item with its shelf, rank and country.	Billed per request at your plan's rates

`search`

Search Spotify's catalog as the web player's search does, across tracks, artists, albums, playlists, podcasts, episodes, audiobooks, users, genres and authors, or only the types asked for. Each row is one result with its type, rank, id, link, name and image, plus what that type carries: a track's artists, album, duration and explicit flag; an artist's verified badge; an album's type and release date; a playlist's owner and description; a podcast's publisher; an episode's show and date; an audiobook's authors; a genre's image; an author's biography. Spotify serves up to 1,000 results per type.

POST https://request.usestring.ai/v1/integrations/spotify/search

Input

Unknown fields are rejected.

Field	Type	Description
`query`	string	Required. What to search for, as typed in Spotify's search box. At least 1 character.
`types`	`tracks` `artists` `albums` `playlists` `podcasts` `episodes` `audiobooks` `users` `genres` `authors`[] \| null	Which result types to return: tracks, artists, albums, playlists, podcasts, episodes, audiobooks, users, genres, authors. Defaults to every type but users, genres and authors.
`limit`	integer	The most results to return per type, 1 to 1000. Defaults to 20. From 1 to 1000.

Output

data is an array of rows, one per result. Each row has:

Field	Type	Description
`type`	string	track, artist, album, playlist, podcast, episode, audiobook, user, genre or author; browse shelves also list category.
`position`	integer	The result's rank within its type, from 1.
`id`	string	The result's Spotify id.
`uri`	string	—
`url`	string	The result's open.spotify.com page.
`name`	string	—
`artists`	object[] \| null	A track's or album's artists. May be absent.
`artists[].id`	string	The entity's Spotify id.
`artists[].uri`	string	The entity's spotify: URI, such as spotify:artist:2Z9KL8Zmqx5Sg3cd7Fldhl.
`artists[].url`	string	The entity's open.spotify.com page.
`artists[].name`	string	—
`album`	object \| null	The release a track is on. May be absent.
`album.id`	string	The entity's Spotify id.
`album.uri`	string	The entity's spotify: URI, such as spotify:artist:2Z9KL8Zmqx5Sg3cd7Fldhl.
`album.url`	string	The entity's open.spotify.com page.
`album.name`	string	—
`albumType`	string \| null	An album's type: ALBUM, SINGLE, EP or COMPILATION. May be absent.
`releaseDate`	string \| null	An album's or episode's release date, as precise as Spotify states it. May be absent.
`durationMs`	integer \| null	A track's or episode's length. May be absent.
`explicit`	boolean \| null	Whether a track or episode is marked explicit. May be absent.
`verified`	boolean \| null	Whether an artist is verified. May be absent.
`owner`	object \| null	A playlist's owner. May be absent.
`owner.id`	string	The entity's Spotify id.
`owner.uri`	string	The entity's spotify: URI, such as spotify:artist:2Z9KL8Zmqx5Sg3cd7Fldhl.
`owner.url`	string	The entity's open.spotify.com page.
`owner.name`	string	—
`description`	string \| null	A playlist's, episode's or audiobook's description, or an author's biography, as plain text. May be absent.
`publisher`	string \| null	A podcast's publisher. May be absent.
`show`	object \| null	The podcast an episode belongs to. May be absent.
`show.id`	string	The entity's Spotify id.
`show.uri`	string	The entity's spotify: URI, such as spotify:artist:2Z9KL8Zmqx5Sg3cd7Fldhl.
`show.url`	string	The entity's open.spotify.com page.
`show.name`	string	—
`authors`	string[] \| null	An audiobook's authors. May be absent.
`imageUrl`	string \| null	The result's largest image: cover art, avatar or playlist image.

Example

curl https://request.usestring.ai/v1/integrations/spotify/search \
  -H "Authorization: Bearer $STRING_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "query": "olexesh",
    "limit": 3
  }'

data starts with these rows:

[
  {
    "type": "track",
    "position": 1,
    "id": "1Uzw62WP2caOIgoIvDobzd",
    "uri": "spotify:track:1Uzw62WP2caOIgoIvDobzd",
    "url": "https://open.spotify.com/track/1Uzw62WP2caOIgoIvDobzd",
    "name": "RSQ8",
    "artists": [
      {
        "id": "2Z9KL8Zmqx5Sg3cd7Fldhl",
        "uri": "spotify:artist:2Z9KL8Zmqx5Sg3cd7Fldhl",
        "url": "https://open.spotify.com/artist/2Z9KL8Zmqx5Sg3cd7Fldhl",
        "name": "Olexesh"
      }
    ],
    "album": {
      "id": "76oMginyxsvashZtY39mxy",
      "uri": "spotify:album:76oMginyxsvashZtY39mxy",
      "url": "https://open.spotify.com/album/76oMginyxsvashZtY39mxy",
      "name": "RSQ8"
    },
    "durationMs": 118762,
    "explicit": true,
    "imageUrl": "https://i.scdn.co/image/ab67616d0000b273b21efcee8b5bf33bb78939b3"
  },
  {
    "type": "track",
    "position": 2,
    "id": "0ORPjGGxa63KdRCqrX3JgN",
    "uri": "spotify:track:0ORPjGGxa63KdRCqrX3JgN",
    "url": "https://open.spotify.com/track/0ORPjGGxa63KdRCqrX3JgN",
    "name": "Matador",
    "artists": [
      {
        "id": "2Z9KL8Zmqx5Sg3cd7Fldhl",
        "uri": "spotify:artist:2Z9KL8Zmqx5Sg3cd7Fldhl",
        "url": "https://open.spotify.com/artist/2Z9KL8Zmqx5Sg3cd7Fldhl",
        "name": "Olexesh"
      }
    ],
    "album": {
      "id": "2pEXPJWLSkZFEW7dOXa2pu",
      "uri": "spotify:album:2pEXPJWLSkZFEW7dOXa2pu",
      "url": "https://open.spotify.com/album/2pEXPJWLSkZFEW7dOXa2pu",
      "name": "Matador"
    },
    "durationMs": 139474,
    "explicit": true,
    "imageUrl": "https://i.scdn.co/image/ab67616d0000b2732c5342b9f25d10dad6b3ae33"
  }
]

Requests and billing

Requests: 1 Web Access request per result page, plus up to 1 setup request per call.
Billing: passthrough. Each request the action makes bills at its own rate on your plan; there is no separate charge for the action. See Pricing.

`artist`

Read each Spotify artist's public page: name, verified badge, biography, avatar, header and gallery images, followers, monthly listeners, world rank, top cities by listeners, external links (Instagram, Wikipedia and others), top tracks with play counts, popular and latest releases, the pinned item, how many albums, singles, compilations and appearances the artist has, every related artist (Fans also like), Spotify's playlists featuring the artist, the playlists listeners discovered them on, the artist's own playlists, upcoming concerts and music videos. The discography action lists the releases themselves.

POST https://request.usestring.ai/v1/integrations/spotify/artist

Input

Unknown fields are rejected.

Field	Type	Description
`items`	string[]	Required. Spotify artists: open.spotify.com/artist links (share links with ?si= work), spotify:artist: URIs, or bare 22-character artist ids. 1 to 300 entries.

Output

data is an array of rows, one per result. Each row has:

Field	Type	Description
`id`	string	The artist's Spotify id.
`uri`	string	—
`url`	string	The artist's open.spotify.com page.
`name`	string	—
`verified`	boolean	—
`biography`	string \| null	The artist's About text, as plain text.
`avatarUrl`	string \| null	—
`headerImageUrl`	string \| null	The wide banner image at the top of the artist's page.
`galleryUrls`	string[]	The artist's About gallery images, largest size.
`followers`	integer \| null	—
`monthlyListeners`	integer \| null	—
`worldRank`	integer \| null	The artist's world rank by monthly listeners, when Spotify ranks the artist; null otherwise.
`topCities`	object[]	The cities most of the artist's monthly listeners are in, most first.
`topCities[].city`	string	—
`topCities[].region`	string	The city's region code, such as BE for Berlin.
`topCities[].country`	string	ISO 3166-1 alpha-2 country code.
`topCities[].listeners`	integer	Monthly listeners in this city.
`externalLinks`	object[]	—
`externalLinks[].name`	string	What the link is, as Spotify names it, such as INSTAGRAM, WIKIPEDIA or FACEBOOK.
`externalLinks[].url`	string	—
`topTracks`	object[]	The artist's popular tracks, most played first, with play counts.
`topTracks[].id`	string	The track's Spotify id.
`topTracks[].uri`	string	—
`topTracks[].url`	string	The track's open.spotify.com page.
`topTracks[].name`	string	—
`topTracks[].artists`	object[] \| null	The track's credited artists, main artist first.
`topTracks[].artists[].id`	string	The entity's Spotify id.
`topTracks[].artists[].uri`	string	The entity's spotify: URI, such as spotify:artist:2Z9KL8Zmqx5Sg3cd7Fldhl.
`topTracks[].artists[].url`	string	The entity's open.spotify.com page.
`topTracks[].artists[].name`	string	—
`topTracks[].album`	object \| null	The release the track is on; absent inside an album's own track list. May be absent.
`topTracks[].album.id`	string	The entity's Spotify id.
`topTracks[].album.uri`	string	The entity's spotify: URI, such as spotify:artist:2Z9KL8Zmqx5Sg3cd7Fldhl.
`topTracks[].album.url`	string	The entity's open.spotify.com page.
`topTracks[].album.name`	string	—
`topTracks[].durationMs`	integer \| null	—
`topTracks[].playCount`	integer \| null	Spotify's all-time play count for the track, as the web player shows it; null where Spotify shows none.
`topTracks[].explicit`	boolean	—
`topTracks[].playable`	boolean \| null	Whether Spotify will play the track in the region the request ran from.
`topTracks[].trackNumber`	integer \| null	The track's position on its disc. May be absent.
`topTracks[].discNumber`	integer \| null	May be absent.
`topTracks[].imageUrl`	string \| null	The largest cover image of the track's release. May be absent.
`topTracks[].addedAt`	string \| null	When the track was added to the playlist (playlist tracks only) May be absent.
`topTracks[].addedBy`	object \| null	The user who added the track (playlist tracks only, where Spotify shows one) May be absent.
`topTracks[].addedBy.id`	string	The entity's Spotify id.
`topTracks[].addedBy.uri`	string	The entity's spotify: URI, such as spotify:artist:2Z9KL8Zmqx5Sg3cd7Fldhl.
`topTracks[].addedBy.url`	string	The entity's open.spotify.com page.
`topTracks[].addedBy.name`	string	—
`popularReleases`	object[]	The releases the artist page's Popular releases shelf shows.
`popularReleases[].id`	string	The release's Spotify album id.
`popularReleases[].uri`	string	—
`popularReleases[].url`	string	The release's open.spotify.com page.
`popularReleases[].name`	string	—
`popularReleases[].type`	string	ALBUM, SINGLE, EP or COMPILATION, as Spotify labels the release.
`popularReleases[].group`	string	Which discography list the row came from: albums, singles, compilations or appears_on (discography action only) May be absent.
`popularReleases[].releaseDate`	string \| null	As precise as Spotify states it: 2024, 2024-05 or 2024-05-17.
`popularReleases[].trackCount`	integer \| null	—
`popularReleases[].label`	string \| null	—
`popularReleases[].artists`	object[] \| null	The release's own artists, where Spotify lists them (appears_on releases) May be absent.
`popularReleases[].artists[].id`	string	The entity's Spotify id.
`popularReleases[].artists[].uri`	string	The entity's spotify: URI, such as spotify:artist:2Z9KL8Zmqx5Sg3cd7Fldhl.
`popularReleases[].artists[].url`	string	The entity's open.spotify.com page.
`popularReleases[].artists[].name`	string	—
`popularReleases[].playable`	boolean \| null	—
`popularReleases[].imageUrl`	string \| null	The largest cover image.
`latestRelease`	object \| null	The artist's newest release, when the page shows one.
`latestRelease.id`	string	The release's Spotify album id.
`latestRelease.uri`	string	—
`latestRelease.url`	string	The release's open.spotify.com page.
`latestRelease.name`	string	—
`latestRelease.type`	string	ALBUM, SINGLE, EP or COMPILATION, as Spotify labels the release.
`latestRelease.group`	string	Which discography list the row came from: albums, singles, compilations or appears_on (discography action only) May be absent.
`latestRelease.releaseDate`	string \| null	As precise as Spotify states it: 2024, 2024-05 or 2024-05-17.
`latestRelease.trackCount`	integer \| null	—
`latestRelease.label`	string \| null	—
`latestRelease.artists`	object[] \| null	The release's own artists, where Spotify lists them (appears_on releases) May be absent.
`latestRelease.artists[].id`	string	The entity's Spotify id.
`latestRelease.artists[].uri`	string	The entity's spotify: URI, such as spotify:artist:2Z9KL8Zmqx5Sg3cd7Fldhl.
`latestRelease.artists[].url`	string	The entity's open.spotify.com page.
`latestRelease.artists[].name`	string	—
`latestRelease.playable`	boolean \| null	—
`latestRelease.imageUrl`	string \| null	The largest cover image.
`pinned`	object \| null	—
`pinned.type`	string	What is pinned, such as ALBUM, PLAYLIST or CONCERT.
`pinned.uri`	string	—
`pinned.url`	string	—
`pinned.title`	string	—
`pinned.subtitle`	string \| null	—
`pinned.comment`	string \| null	The artist's own note on the pin.
`discography`	object	How many releases the artist has per group; the discography action lists them.
`discography.albums`	integer	—
`discography.singles`	integer	Singles and EPs.
`discography.compilations`	integer	—
`discography.appearsOn`	integer	Other artists' releases this artist appears on.
`relatedArtists`	object[]	Fans also like: every related artist Spotify lists, up to 40.
`relatedArtists[].id`	string	—
`relatedArtists[].uri`	string	—
`relatedArtists[].url`	string	—
`relatedArtists[].name`	string	—
`relatedArtists[].imageUrl`	string \| null	—
`featuringPlaylists`	object[]	Spotify's own playlists built around the artist, such as This Is <artist>.
`featuringPlaylists[].id`	string	—
`featuringPlaylists[].uri`	string	—
`featuringPlaylists[].url`	string	—
`featuringPlaylists[].name`	string	—
`featuringPlaylists[].owner`	string \| null	The playlist owner's display name, such as Spotify for an editorial playlist.
`featuringPlaylists[].description`	string \| null	—
`featuringPlaylists[].imageUrl`	string \| null	—
`discoveredOnPlaylists`	object[]	Playlists listeners found the artist on, up to the 50 Spotify serves.
`discoveredOnPlaylists[].id`	string	—
`discoveredOnPlaylists[].uri`	string	—
`discoveredOnPlaylists[].url`	string	—
`discoveredOnPlaylists[].name`	string	—
`discoveredOnPlaylists[].owner`	string \| null	The playlist owner's display name, such as Spotify for an editorial playlist.
`discoveredOnPlaylists[].description`	string \| null	—
`discoveredOnPlaylists[].imageUrl`	string \| null	—
`artistPlaylists`	object[]	Playlists the artist made themselves, as the page's Artist Playlists shelf lists them.
`artistPlaylists[].id`	string	—
`artistPlaylists[].uri`	string	—
`artistPlaylists[].url`	string	—
`artistPlaylists[].name`	string	—
`artistPlaylists[].owner`	string \| null	The playlist owner's display name, such as Spotify for an editorial playlist.
`artistPlaylists[].description`	string \| null	—
`artistPlaylists[].imageUrl`	string \| null	—
`concerts`	object[]	The artist's upcoming concerts and festivals, soonest first; the concert action reads one in full.
`concerts[].id`	string	The concert's Spotify id.
`concerts[].uri`	string	—
`concerts[].url`	string	The concert's open.spotify.com page.
`concerts[].title`	string	—
`concerts[].startDate`	string \| null	When the concert starts, as an ISO 8601 timestamp in the venue's offset where Spotify gives one.
`concerts[].festival`	boolean \| null	Whether the event is a festival.
`concerts[].venue`	string \| null	The venue's name.
`concerts[].city`	string \| null	—
`concerts[].artists`	object[] \| null	The artists on the bill, where the listing names them.
`concerts[].artists[].id`	string	The entity's Spotify id.
`concerts[].artists[].uri`	string	The entity's spotify: URI, such as spotify:artist:2Z9KL8Zmqx5Sg3cd7Fldhl.
`concerts[].artists[].url`	string	The entity's open.spotify.com page.
`concerts[].artists[].name`	string	—
`musicVideos`	object[]	The artist's music videos, up to the first 100.
`musicVideos[].id`	string	The track's Spotify id.
`musicVideos[].uri`	string	—
`musicVideos[].url`	string	The track's open.spotify.com page.
`musicVideos[].name`	string	—
`musicVideos[].artists`	object[] \| null	The track's credited artists, main artist first.
`musicVideos[].artists[].id`	string	The entity's Spotify id.
`musicVideos[].artists[].uri`	string	The entity's spotify: URI, such as spotify:artist:2Z9KL8Zmqx5Sg3cd7Fldhl.
`musicVideos[].artists[].url`	string	The entity's open.spotify.com page.
`musicVideos[].artists[].name`	string	—
`musicVideos[].album`	object \| null	The release the track is on; absent inside an album's own track list. May be absent.
`musicVideos[].album.id`	string	The entity's Spotify id.
`musicVideos[].album.uri`	string	The entity's spotify: URI, such as spotify:artist:2Z9KL8Zmqx5Sg3cd7Fldhl.
`musicVideos[].album.url`	string	The entity's open.spotify.com page.
`musicVideos[].album.name`	string	—
`musicVideos[].durationMs`	integer \| null	—
`musicVideos[].playCount`	integer \| null	Spotify's all-time play count for the track, as the web player shows it; null where Spotify shows none.
`musicVideos[].explicit`	boolean	—
`musicVideos[].playable`	boolean \| null	Whether Spotify will play the track in the region the request ran from.
`musicVideos[].trackNumber`	integer \| null	The track's position on its disc. May be absent.
`musicVideos[].discNumber`	integer \| null	May be absent.
`musicVideos[].imageUrl`	string \| null	The largest cover image of the track's release. May be absent.
`musicVideos[].addedAt`	string \| null	When the track was added to the playlist (playlist tracks only) May be absent.
`musicVideos[].addedBy`	object \| null	The user who added the track (playlist tracks only, where Spotify shows one) May be absent.
`musicVideos[].addedBy.id`	string	The entity's Spotify id.
`musicVideos[].addedBy.uri`	string	The entity's spotify: URI, such as spotify:artist:2Z9KL8Zmqx5Sg3cd7Fldhl.
`musicVideos[].addedBy.url`	string	The entity's open.spotify.com page.
`musicVideos[].addedBy.name`	string	—

Example

curl https://request.usestring.ai/v1/integrations/spotify/artist \
  -H "Authorization: Bearer $STRING_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "items": ["https://open.spotify.com/artist/2Z9KL8Zmqx5Sg3cd7Fldhl?si=KZqly8SHSUGXSSEfd847vQ"]
  }'

data starts with these rows:

[
  {
    "id": "2Z9KL8Zmqx5Sg3cd7Fldhl",
    "uri": "spotify:artist:2Z9KL8Zmqx5Sg3cd7Fldhl",
    "url": "https://open.spotify.com/artist/2Z9KL8Zmqx5Sg3cd7Fldhl",
    "name": "Olexesh",
    "verified": true,
    "biography": "Olexesh steht mit seinem Namen für Arbeitsmoral wie kaum ein anderer Künstler im deutschsprachigen Raum, denn schon seit seinem Debüt-Mixtape \"Authentic Athletic\" im Jahr 2012 veröffentlicht er in reg…",
    "avatarUrl": "https://i.scdn.co/image/ab6761610000e5eb740c43b584f7ccc36e621915",
    "headerImageUrl": "https://image-cdn-fa.spotifycdn.com/image/ab6761860000eab1c5060061cb1fdef53a5ef33c",
    "galleryUrls": ["https://i.scdn.co/image/00b4706c723405c3cc9b542b5bf0d98275a6d65d", "https://i.scdn.co/image/aa2bc44099ccae6a5c3c2ed09ed7fd938dc754d3"],
    "followers": 1005926,
    "monthlyListeners": 2146255,
    "worldRank": null,
    "topCities": [
      {
        "city": "Frankfurt am Main",
        "region": "HE",
        "country": "DE",
        "listeners": 206517
      },
      {
        "city": "Stuttgart",
        "region": "BW",
        "country": "DE",
        "listeners": 179225
      },
      {
        "city": "Berlin",
        "region": "BE",
        "country": "DE",
        "listeners": 170126
      }
    ],
    "externalLinks": [
      {
        "name": "FACEBOOK",
        "url": "https://facebook.com/olexesh64"
      },
      {
        "name": "INSTAGRAM",
        "url": "https://instagram.com/olexesh"
      },
      {
        "name": "TWITTER",
        "url": "https://twitter.com/olexesh64"
      },
      {
        "name": "WIKIPEDIA",
        "url": "https://de.wikipedia.org/wiki/Olexesh"
      }
    ],
    "topTracks": [
      {
        "id": "1IMa0Il4w988MwZCUcISix",
        "uri": "spotify:track:1IMa0Il4w988MwZCUcISix",
        "url": "https://open.spotify.com/track/1IMa0Il4w988MwZCUcISix",
        "name": "bissu dumm ¿ MEGALODON REMIX",
        "artists": [
          {
            "id": "1aS5tqEs9ci5P9KD9tZWa6",
            "uri": "spotify:artist:1aS5tqEs9ci5P9KD9tZWa6",
            "url": "https://open.spotify.com/artist/1aS5tqEs9ci5P9KD9tZWa6",
            "name": "Bonez MC"
          },
          {
            "id": "5PIdjtNMwJgYituTP77U3X",
            "uri": "spotify:artist:5PIdjtNMwJgYituTP77U3X",
            "url": "https://open.spotify.com/artist/5PIdjtNMwJgYituTP77U3X",
            "name": "Nate57"
          },
          {
            "id": "5dM0ApSI0k1TcOseiik0sY",
            "uri": "spotify:artist:5dM0ApSI0k1TcOseiik0sY",
            "url": "https://open.spotify.com/artist/5dM0ApSI0k1TcOseiik0sY",
            "name": "JUGGLERZ"
          },
          {
            "id": "6JOYrJkaS8ZKxLoUdNNdWr",
            "uri": "spotify:artist:6JOYrJkaS8ZKxLoUdNNdWr",
            "url": "https://open.spotify.com/artist/6JOYrJkaS8ZKxLoUdNNdWr",
            "name": "AchtVier"
          },
          {
            "id": "3803JqLnUACUJcuCLmK3xz",
            "uri": "spotify:artist:3803JqLnUACUJcuCLmK3xz",
            "url": "https://open.spotify.com/artist/3803JqLnUACUJcuCLmK3xz",
            "name": "AK 33"
          },
          {
            "id": "07SFzTMeYf5P8Rd32a9Zzw",
            "uri": "spotify:artist:07SFzTMeYf5P8Rd32a9Zzw",
            "url": "https://open.spotify.com/artist/07SFzTMeYf5P8Rd32a9Zzw",
            "name": "AK AUSSERKONTROLLE"
          },
          {
            "id": "7LQLsKs1Qulq0BxYdhRnBU",
            "uri": "spotify:artist:7LQLsKs1Qulq0BxYdhRnBU",
            "url": "https://open.spotify.com/artist/7LQLsKs1Qulq0BxYdhRnBU",
            "name": "AZAD"
          },
          {
            "id": "18Zq5h68TQ6kurXzRNHJDo",
            "uri": "spotify:artist:18Zq5h68TQ6kurXzRNHJDo",
            "url": "https://open.spotify.com/artist/18Zq5h68TQ6kurXzRNHJDo",
            "name": "Big Toe"
          },
          {
            "id": "0ZqNAlpzFTJI4tyK4UwJE2",
            "uri": "spotify:artist:0ZqNAlpzFTJI4tyK4UwJE2",
            "url": "https://open.spotify.com/artist/0ZqNAlpzFTJI4tyK4UwJE2",
            "name": "CANEY030"
          },
          {
            "id": "48Fq6GV3S6on56TxSBu5NO",
            "uri": "spotify:artist:48Fq6GV3S6on56TxSBu5NO",
            "url": "https://open.spotify.com/artist/48Fq6GV3S6on56TxSBu5NO",
            "name": "Celo & Abdi"
          }
        ],
        "album": {
          "id": "1QsNFGsyAsJ7jBx5inCQ4F",
          "uri": "spotify:album:1QsNFGsyAsJ7jBx5inCQ4F",
          "url": "https://open.spotify.com/album/1QsNFGsyAsJ7jBx5inCQ4F",
          "name": ""
        },
        "durationMs": 1114155,
        "playCount": 30543188,
        "explicit": true,
        "playable": true,
        "discNumber": 1,
        "imageUrl": "https://i.scdn.co/image/ab67616d00001e025e61fce2d6ebbfcc58958a82"
      },
      {
        "id": "517KruG9El8AA65Mdwa8cr",
        "uri": "spotify:track:517KruG9El8AA65Mdwa8cr",
        "url": "https://open.spotify.com/track/517KruG9El8AA65Mdwa8cr",
        "name": "Player Player",
        "artists": [
          {
            "id": "1KGwASmnB2xhGcJGt9epDc",
            "uri": "spotify:artist:1KGwASmnB2xhGcJGt9epDc",
            "url": "https://open.spotify.com/artist/1KGwASmnB2xhGcJGt9epDc",
            "name": "Tom Hengst"
          },
          {
            "id": "2Z9KL8Zmqx5Sg3cd7Fldhl",
            "uri": "spotify:artist:2Z9KL8Zmqx5Sg3cd7Fldhl",
            "url": "https://open.spotify.com/artist/2Z9KL8Zmqx5Sg3cd7Fldhl",
            "name": "Olexesh"
          }
        ],
        "album": {
          "id": "5fDFd8qgF7uo9WFRNPN0XJ",
          "uri": "spotify:album:5fDFd8qgF7uo9WFRNPN0XJ",
          "url": "https://open.spotify.com/album/5fDFd8qgF7uo9WFRNPN0XJ",
          "name": ""
        },
        "durationMs": 121901,
        "playCount": 495690,
        "explicit": true,
        "playable": true,
        "discNumber": 1,
        "imageUrl": "https://i.scdn.co/image/ab67616d00001e020b2480e5f1758ffc8630645c"
      }
    ],
    "popularReleases": [
      {
        "id": "4LQ5ixaCrXeoA6MpGpGIv0",
        "uri": "spotify:album:4LQ5ixaCrXeoA6MpGpGIv0",
        "url": "https://open.spotify.com/album/4LQ5ixaCrXeoA6MpGpGIv0",
        "name": "Augen Husky 3",
        "type": "ALBUM",
        "releaseDate": "2026-08-27",
        "trackCount": 16,
        "label": "385ideal",
        "playable": true,
        "imageUrl": "https://i.scdn.co/image/ab67616d0000b273a1c696b95d29cf7b348eb689"
      },
      {
        "id": "5fDFd8qgF7uo9WFRNPN0XJ",
        "uri": "spotify:album:5fDFd8qgF7uo9WFRNPN0XJ",
        "url": "https://open.spotify.com/album/5fDFd8qgF7uo9WFRNPN0XJ",
        "name": "Player Player",
        "type": "SINGLE",
        "releaseDate": "2026-10-22",
        "trackCount": 6,
        "label": "Urban",
        "playable": true,
        "imageUrl": "https://i.scdn.co/image/ab67616d0000b2730b2480e5f1758ffc8630645c"
      }
    ],
    "latestRelease": {
      "id": "5fDFd8qgF7uo9WFRNPN0XJ",
      "uri": "spotify:album:5fDFd8qgF7uo9WFRNPN0XJ",
      "url": "https://open.spotify.com/album/5fDFd8qgF7uo9WFRNPN0XJ",
      "name": "Player Player",
      "type": "SINGLE",
      "releaseDate": "2026-10-22",
      "trackCount": 6,
      "label": "Urban",
      "playable": true,
      "imageUrl": "https://i.scdn.co/image/ab67616d0000b2730b2480e5f1758ffc8630645c"
    },
    "pinned": {
      "type": "ALBUM",
      "uri": "spotify:album:4LQ5ixaCrXeoA6MpGpGIv0",
      "url": "https://open.spotify.com/album/4LQ5ixaCrXeoA6MpGpGIv0",
      "title": "Augen Husky 3",
      "subtitle": "Album",
      "comment": "AUGEN HUSKY 3 OUT NOW "
    },
    "discography": {
      "albums": 13,
      "singles": 157,
      "compilations": 0,
      "appearsOn": 224
    },
    "relatedArtists": [
      {
        "id": "07SFzTMeYf5P8Rd32a9Zzw",
        "uri": "spotify:artist:07SFzTMeYf5P8Rd32a9Zzw",
        "url": "https://open.spotify.com/artist/07SFzTMeYf5P8Rd32a9Zzw",
        "name": "AK AUSSERKONTROLLE",
        "imageUrl": "https://i.scdn.co/image/ab6761610000e5eb2a234069b7b3af67b888b1d3"
      },
      {
        "id": "4VuARVJiWGsH2msKTdsKdQ",
        "uri": "spotify:artist:4VuARVJiWGsH2msKTdsKdQ",
        "url": "https://open.spotify.com/artist/4VuARVJiWGsH2msKTdsKdQ",
        "name": "Veysel",
        "imageUrl": "https://i.scdn.co/image/ab6761610000e5ebcf7b218496065a8e537edd73"
      },
      {
        "id": "0AfMiUTAbsDPQSCXmBva4y",
        "uri": "spotify:artist:0AfMiUTAbsDPQSCXmBva4y",
        "url": "https://open.spotify.com/artist/0AfMiUTAbsDPQSCXmBva4y",
        "name": "Mucco",
        "imageUrl": "https://i.scdn.co/image/ab6761610000e5eb475d055ae88090e39498e976"
      }
    ],
    "featuringPlaylists": [
      {
        "id": "37i9dQZF1DZ06evO1IVRT2",
        "uri": "spotify:playlist:37i9dQZF1DZ06evO1IVRT2",
        "url": "https://open.spotify.com/playlist/37i9dQZF1DZ06evO1IVRT2",
        "name": "This Is Olexesh",
        "owner": "Spotify",
        "description": "This is Olexesh. The essential tracks, all in one playlist.",
        "imageUrl": "https://pickasso.spotifycdn.com/image/ab67c0de0000deef/dt/v1/img/thisisv3/2Z9KL8Zmqx5Sg3cd7Fldhl/en"
      }
    ],
    "discoveredOnPlaylists": [
      {
        "id": "37i9dQZF1DZ06evO1IVRT2",
        "uri": "spotify:playlist:37i9dQZF1DZ06evO1IVRT2",
        "url": "https://open.spotify.com/playlist/37i9dQZF1DZ06evO1IVRT2",
        "name": "This Is Olexesh",
        "owner": "Spotify",
        "description": "This is Olexesh. The essential tracks, all in one playlist.",
        "imageUrl": "https://pickasso.spotifycdn.com/image/ab67c0de0000deef/dt/v1/img/thisisv3/2Z9KL8Zmqx5Sg3cd7Fldhl/en"
      },
      {
        "id": "3EIC2YmoiAYlfyCyV9vtHD",
        "uri": "spotify:playlist:3EIC2YmoiAYlfyCyV9vtHD",
        "url": "https://open.spotify.com/playlist/3EIC2YmoiAYlfyCyV9vtHD",
        "name": "Alte Deutschrap banger ",
        "owner": "jana.mce",
        "description": null,
        "imageUrl": "https://image-cdn-fa.spotifycdn.com/image/ab67706c0000d72cf36cf39d86a183e869452f6f"
      }
    ],
    "artistPlaylists": [],
    "concerts": [],
    "musicVideos": [
      {
        "id": "4r2W5xrKK9uALgINoHybxm",
        "uri": "spotify:track:4r2W5xrKK9uALgINoHybxm",
        "url": "https://open.spotify.com/track/4r2W5xrKK9uALgINoHybxm",
        "name": "9mm Bang",
        "artists": [
          {
            "id": "2Z9KL8Zmqx5Sg3cd7Fldhl",
            "uri": "spotify:artist:2Z9KL8Zmqx5Sg3cd7Fldhl",
            "url": "https://open.spotify.com/artist/2Z9KL8Zmqx5Sg3cd7Fldhl",
            "name": "Olexesh"
          }
        ],
        "album": {
          "id": "02vJnv2tDvEUjgxsWjUrQk",
          "uri": "spotify:album:02vJnv2tDvEUjgxsWjUrQk",
          "url": "https://open.spotify.com/album/02vJnv2tDvEUjgxsWjUrQk",
          "name": ""
        },
        "durationMs": null,
        "playCount": null,
        "explicit": true,
        "playable": null,
        "imageUrl": "https://i.scdn.co/image/ab6742d3000053b7a7914cf1c706759be0dd4449"
      },
      {
        "id": "6zMbnFsRhM5u8YqJwGRtLx",
        "uri": "spotify:track:6zMbnFsRhM5u8YqJwGRtLx",
        "url": "https://open.spotify.com/track/6zMbnFsRhM5u8YqJwGRtLx",
        "name": "Fantasia",
        "artists": [
          {
            "id": "2Z9KL8Zmqx5Sg3cd7Fldhl",
            "uri": "spotify:artist:2Z9KL8Zmqx5Sg3cd7Fldhl",
            "url": "https://open.spotify.com/artist/2Z9KL8Zmqx5Sg3cd7Fldhl",
            "name": "Olexesh"
          },
          {
            "id": "0JQ4vokBBqHxHzRb36fSWN",
            "uri": "spotify:artist:0JQ4vokBBqHxHzRb36fSWN",
            "url": "https://open.spotify.com/artist/0JQ4vokBBqHxHzRb36fSWN",
            "name": "Devito"
          }
        ],
        "album": {
          "id": "5C3R1mFgNYB9NcSpCRyoOB",
          "uri": "spotify:album:5C3R1mFgNYB9NcSpCRyoOB",
          "url": "https://open.spotify.com/album/5C3R1mFgNYB9NcSpCRyoOB",
          "name": ""
        },
        "durationMs": null,
        "playCount": null,
        "explicit": true,
        "playable": null,
        "imageUrl": "https://i.scdn.co/image/ab6742d3000053b7bc71115258e2ce81b0e86f3f"
      }
    ]
  }
]

Requests and billing

Requests: 5 Web Access requests per entry in items, plus up to 1 setup request per call.
Billing: passthrough. Each request the action makes bills at its own rate on your plan; there is no separate charge for the action. See Pricing.

`discography`

List a Spotify artist's releases, newest first: every album, single, EP and compilation, or one of those groups, or the other artists' releases they appear on. Each row is a release: name, type, release date, track count, cover image and link. Read a release's tracks with the album action.

POST https://request.usestring.ai/v1/integrations/spotify/discography

Input

Unknown fields are rejected.

Field	Type	Description
`artist`	string	Required. A Spotify artist: an open.spotify.com/artist link, a spotify:artist: URI or a bare artist id. At least 1 character.
`group`	`all` `albums` `singles` `compilations` `appears_on`	all (the default: albums, singles and compilations together, newest first), albums, singles (singles and EPs), compilations, or appears_on (other artists' releases this artist is on)
`limit`	integer	The most releases to return, 1 to 2000. Defaults to 100. From 1 to 2000.

Output

data is an array of rows, one per result. Each row has:

Field	Type	Description
`id`	string	The release's Spotify album id.
`uri`	string	—
`url`	string	The release's open.spotify.com page.
`name`	string	—
`type`	string	ALBUM, SINGLE, EP or COMPILATION, as Spotify labels the release.
`group`	string	Which discography list the row came from: albums, singles, compilations or appears_on (discography action only) May be absent.
`releaseDate`	string \| null	As precise as Spotify states it: 2024, 2024-05 or 2024-05-17.
`trackCount`	integer \| null	—
`label`	string \| null	—
`artists`	object[] \| null	The release's own artists, where Spotify lists them (appears_on releases) May be absent.
`artists[].id`	string	The entity's Spotify id.
`artists[].uri`	string	The entity's spotify: URI, such as spotify:artist:2Z9KL8Zmqx5Sg3cd7Fldhl.
`artists[].url`	string	The entity's open.spotify.com page.
`artists[].name`	string	—
`playable`	boolean \| null	—
`imageUrl`	string \| null	The largest cover image.

Example

curl https://request.usestring.ai/v1/integrations/spotify/discography \
  -H "Authorization: Bearer $STRING_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "artist": "spotify:artist:2Z9KL8Zmqx5Sg3cd7Fldhl",
    "group": "albums",
    "limit": 20
  }'

data starts with these rows:

[
  {
    "id": "4LQ5ixaCrXeoA6MpGpGIv0",
    "uri": "spotify:album:4LQ5ixaCrXeoA6MpGpGIv0",
    "url": "https://open.spotify.com/album/4LQ5ixaCrXeoA6MpGpGIv0",
    "name": "Augen Husky 3",
    "type": "ALBUM",
    "group": "albums",
    "releaseDate": "2026-08-27",
    "trackCount": 16,
    "label": null,
    "playable": true,
    "imageUrl": "https://i.scdn.co/image/ab67616d0000b273a1c696b95d29cf7b348eb689"
  },
  {
    "id": "3eQOQdNO7pdkzIAREBHrfA",
    "uri": "spotify:album:3eQOQdNO7pdkzIAREBHrfA",
    "url": "https://open.spotify.com/album/3eQOQdNO7pdkzIAREBHrfA",
    "name": "Beluga",
    "type": "ALBUM",
    "group": "albums",
    "releaseDate": "2025-11-27",
    "trackCount": 16,
    "label": null,
    "playable": true,
    "imageUrl": "https://i.scdn.co/image/ab67616d0000b27322c920e9e7a16c9dad502f61"
  }
]

Requests and billing

Requests: 1 Web Access request per result page, plus up to 1 setup request per call.
Billing: passthrough. Each request the action makes bills at its own rate on your plan; there is no separate charge for the action. See Pricing.

`album`

Read each Spotify album, single, EP or compilation: name, type, artists, release date, label, copyright and distribution lines, whether it is still a pre-release and when it comes out, cover image, disc and track counts, and every track with its artists, duration, explicit flag and play count.

POST https://request.usestring.ai/v1/integrations/spotify/album

Input

Unknown fields are rejected.

Field	Type	Description
`items`	string[]	Required. Spotify releases: open.spotify.com/album links, spotify:album: URIs, or bare album ids. 1 to 300 entries.

Output

data is an array of rows, one per result. Each row has:

Field	Type	Description
`id`	string	The release's Spotify album id.
`uri`	string	—
`url`	string	—
`name`	string	—
`type`	string	ALBUM, SINGLE, EP or COMPILATION.
`artists`	object[]	—
`artists[].id`	string	The entity's Spotify id.
`artists[].uri`	string	The entity's spotify: URI, such as spotify:artist:2Z9KL8Zmqx5Sg3cd7Fldhl.
`artists[].url`	string	The entity's open.spotify.com page.
`artists[].name`	string	—
`releaseDate`	string \| null	As precise as Spotify states it: 2024, 2024-05 or 2024-05-17.
`label`	string \| null	—
`copyrights`	string[]	The release's copyright lines, © and ℗.
`distributionLine`	string \| null	The release's courtesy line, such as Distributed by Vertigo/Capitol.
`preRelease`	boolean	Whether the release is announced but not out yet (a countdown page)
`preReleaseEnd`	string \| null	When a pre-release comes out, as an ISO 8601 timestamp.
`playable`	boolean \| null	—
`imageUrl`	string \| null	The largest cover image.
`discCount`	integer	—
`trackCount`	integer	—
`tracks`	object[]	Every track in disc and track order, with play counts.
`tracks[].id`	string	The track's Spotify id.
`tracks[].uri`	string	—
`tracks[].url`	string	The track's open.spotify.com page.
`tracks[].name`	string	—
`tracks[].artists`	object[] \| null	The track's credited artists, main artist first.
`tracks[].artists[].id`	string	The entity's Spotify id.
`tracks[].artists[].uri`	string	The entity's spotify: URI, such as spotify:artist:2Z9KL8Zmqx5Sg3cd7Fldhl.
`tracks[].artists[].url`	string	The entity's open.spotify.com page.
`tracks[].artists[].name`	string	—
`tracks[].album`	object \| null	The release the track is on; absent inside an album's own track list. May be absent.
`tracks[].album.id`	string	The entity's Spotify id.
`tracks[].album.uri`	string	The entity's spotify: URI, such as spotify:artist:2Z9KL8Zmqx5Sg3cd7Fldhl.
`tracks[].album.url`	string	The entity's open.spotify.com page.
`tracks[].album.name`	string	—
`tracks[].durationMs`	integer \| null	—
`tracks[].playCount`	integer \| null	Spotify's all-time play count for the track, as the web player shows it; null where Spotify shows none.
`tracks[].explicit`	boolean	—
`tracks[].playable`	boolean \| null	Whether Spotify will play the track in the region the request ran from.
`tracks[].trackNumber`	integer \| null	The track's position on its disc. May be absent.
`tracks[].discNumber`	integer \| null	May be absent.
`tracks[].imageUrl`	string \| null	The largest cover image of the track's release. May be absent.
`tracks[].addedAt`	string \| null	When the track was added to the playlist (playlist tracks only) May be absent.
`tracks[].addedBy`	object \| null	The user who added the track (playlist tracks only, where Spotify shows one) May be absent.
`tracks[].addedBy.id`	string	The entity's Spotify id.
`tracks[].addedBy.uri`	string	The entity's spotify: URI, such as spotify:artist:2Z9KL8Zmqx5Sg3cd7Fldhl.
`tracks[].addedBy.url`	string	The entity's open.spotify.com page.
`tracks[].addedBy.name`	string	—

Example

curl https://request.usestring.ai/v1/integrations/spotify/album \
  -H "Authorization: Bearer $STRING_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "items": ["https://open.spotify.com/album/4LQ5ixaCrXeoA6MpGpGIv0"]
  }'

data starts with these rows:

[
  {
    "id": "4LQ5ixaCrXeoA6MpGpGIv0",
    "uri": "spotify:album:4LQ5ixaCrXeoA6MpGpGIv0",
    "url": "https://open.spotify.com/album/4LQ5ixaCrXeoA6MpGpGIv0",
    "name": "Augen Husky 3",
    "type": "ALBUM",
    "artists": [
      {
        "id": "2Z9KL8Zmqx5Sg3cd7Fldhl",
        "uri": "spotify:artist:2Z9KL8Zmqx5Sg3cd7Fldhl",
        "url": "https://open.spotify.com/artist/2Z9KL8Zmqx5Sg3cd7Fldhl",
        "name": "Olexesh"
      }
    ],
    "releaseDate": "2026-08-27",
    "label": "385ideal",
    "copyrights": ["© 2026 385idéal", "℗ 2026 385idéal"],
    "distributionLine": "Distributed by URBAN",
    "preRelease": false,
    "preReleaseEnd": null,
    "playable": true,
    "imageUrl": "https://i.scdn.co/image/ab67616d0000b273a1c696b95d29cf7b348eb689",
    "discCount": 1,
    "trackCount": 16,
    "tracks": [
      {
        "id": "1XAuwWQleVbRigRPS8ZUBM",
        "uri": "spotify:track:1XAuwWQleVbRigRPS8ZUBM",
        "url": "https://open.spotify.com/track/1XAuwWQleVbRigRPS8ZUBM",
        "name": "Es hat sich gelohnt",
        "artists": [
          {
            "id": "2Z9KL8Zmqx5Sg3cd7Fldhl",
            "uri": "spotify:artist:2Z9KL8Zmqx5Sg3cd7Fldhl",
            "url": "https://open.spotify.com/artist/2Z9KL8Zmqx5Sg3cd7Fldhl",
            "name": "Olexesh"
          },
          {
            "id": "5tlNJfV9UIpgnbWmvUEFu7",
            "uri": "spotify:artist:5tlNJfV9UIpgnbWmvUEFu7",
            "url": "https://open.spotify.com/artist/5tlNJfV9UIpgnbWmvUEFu7",
            "name": "Gentleman"
          }
        ],
        "durationMs": 144200,
        "playCount": 220129,
        "explicit": true,
        "playable": true,
        "trackNumber": 1,
        "discNumber": 1
      },
      {
        "id": "7JHnYqWVUUSzMce9HzrUvT",
        "uri": "spotify:track:7JHnYqWVUUSzMce9HzrUvT",
        "url": "https://open.spotify.com/track/7JHnYqWVUUSzMce9HzrUvT",
        "name": "Enta Eih",
        "artists": [
          {
            "id": "2Z9KL8Zmqx5Sg3cd7Fldhl",
            "uri": "spotify:artist:2Z9KL8Zmqx5Sg3cd7Fldhl",
            "url": "https://open.spotify.com/artist/2Z9KL8Zmqx5Sg3cd7Fldhl",
            "name": "Olexesh"
          },
          {
            "id": "0Dvx6p8JDyzeOPGmaCIH1L",
            "uri": "spotify:artist:0Dvx6p8JDyzeOPGmaCIH1L",
            "url": "https://open.spotify.com/artist/0Dvx6p8JDyzeOPGmaCIH1L",
            "name": "RAF Camora"
          },
          {
            "id": "3Kjc55uLpIjQpszI0wRUQ3",
            "uri": "spotify:artist:3Kjc55uLpIjQpszI0wRUQ3",
            "url": "https://open.spotify.com/artist/3Kjc55uLpIjQpszI0wRUQ3",
            "name": "SOSA."
          }
        ],
        "durationMs": 198601,
        "playCount": 2100166,
        "explicit": true,
        "playable": true,
        "trackNumber": 2,
        "discNumber": 1
      },
      {
        "id": "6fnwopuQphbc8oKjwGb3Tz",
        "uri": "spotify:track:6fnwopuQphbc8oKjwGb3Tz",
        "url": "https://open.spotify.com/track/6fnwopuQphbc8oKjwGb3Tz",
        "name": "Cartier",
        "artists": [
          {
            "id": "2Z9KL8Zmqx5Sg3cd7Fldhl",
            "uri": "spotify:artist:2Z9KL8Zmqx5Sg3cd7Fldhl",
            "url": "https://open.spotify.com/artist/2Z9KL8Zmqx5Sg3cd7Fldhl",
            "name": "Olexesh"
          },
          {
            "id": "0AfMiUTAbsDPQSCXmBva4y",
            "uri": "spotify:artist:0AfMiUTAbsDPQSCXmBva4y",
            "url": "https://open.spotify.com/artist/0AfMiUTAbsDPQSCXmBva4y",
            "name": "Mucco"
          }
        ],
        "durationMs": 171519,
        "playCount": 4561258,
        "explicit": true,
        "playable": true,
        "trackNumber": 3,
        "discNumber": 1
      }
    ]
  }
]

Requests and billing

Requests: 1–4 Web Access requests per entry in items, plus up to 1 setup request per call.
Billing: passthrough. Each request the action makes bills at its own rate on your plan; there is no separate charge for the action. See Pricing.

`track`

Read each Spotify track: name, every credited artist, album, duration, explicit flag, all-time play count, track and disc number, the release's type, date, track count, copyright and distribution lines, a 30-second preview URL, and every credit (performers, writers, producers) with who supplied it.

POST https://request.usestring.ai/v1/integrations/spotify/track

Input

Unknown fields are rejected.

Field	Type	Description
`items`	string[]	Required. Spotify tracks: open.spotify.com/track links, spotify:track: URIs, or bare track ids. 1 to 300 entries.

Output

data is an array of rows, one per result. Each row has:

Field	Type	Description
`id`	string	The track's Spotify id.
`uri`	string	—
`url`	string	The track's open.spotify.com page.
`name`	string	—
`artists`	object[] \| null	The track's credited artists, main artist first.
`artists[].id`	string	The entity's Spotify id.
`artists[].uri`	string	The entity's spotify: URI, such as spotify:artist:2Z9KL8Zmqx5Sg3cd7Fldhl.
`artists[].url`	string	The entity's open.spotify.com page.
`artists[].name`	string	—
`album`	object \| null	The release the track is on; absent inside an album's own track list. May be absent.
`album.id`	string	The entity's Spotify id.
`album.uri`	string	The entity's spotify: URI, such as spotify:artist:2Z9KL8Zmqx5Sg3cd7Fldhl.
`album.url`	string	The entity's open.spotify.com page.
`album.name`	string	—
`durationMs`	integer \| null	—
`playCount`	integer \| null	Spotify's all-time play count for the track, as the web player shows it; null where Spotify shows none.
`explicit`	boolean	—
`playable`	boolean \| null	Whether Spotify will play the track in the region the request ran from.
`trackNumber`	integer \| null	The track's position on its disc. May be absent.
`discNumber`	integer \| null	May be absent.
`imageUrl`	string \| null	The largest cover image of the track's release. May be absent.
`addedAt`	string \| null	When the track was added to the playlist (playlist tracks only) May be absent.
`addedBy`	object \| null	The user who added the track (playlist tracks only, where Spotify shows one) May be absent.
`addedBy.id`	string	The entity's Spotify id.
`addedBy.uri`	string	The entity's spotify: URI, such as spotify:artist:2Z9KL8Zmqx5Sg3cd7Fldhl.
`addedBy.url`	string	The entity's open.spotify.com page.
`addedBy.name`	string	—
`albumType`	string \| null	ALBUM, SINGLE, EP or COMPILATION: the type of the release the track is on.
`releaseDate`	string \| null	The release's date, as precise as Spotify states it.
`albumTrackCount`	integer \| null	—
`copyrights`	string[]	The release's copyright lines.
`distributionLine`	string \| null	The release's courtesy line, such as Distributed by Vertigo/Capitol.
`previewUrl`	string \| null	A 30-second MP3 preview of the track, where Spotify offers one.
`credits`	object[]	The track's credits as the web player's Credits panel lists them: performers, writers, producers and others.
`credits[].name`	string	—
`credits[].role`	string	The credit as Spotify words it, such as Main Artist, Composer or Producer.
`credits[].group`	string	The Credits panel group the role is listed under, such as Artist, Composition & Lyrics or Production & Engineering.
`credits[].artist`	object \| null	The contributor's Spotify artist page, when they have one.
`credits[].artist.id`	string	The entity's Spotify id.
`credits[].artist.uri`	string	The entity's spotify: URI, such as spotify:artist:2Z9KL8Zmqx5Sg3cd7Fldhl.
`credits[].artist.url`	string	The entity's open.spotify.com page.
`credits[].artist.name`	string	—
`sources`	string[]	Who supplied the credits, such as the label.

Example

curl https://request.usestring.ai/v1/integrations/spotify/track \
  -H "Authorization: Bearer $STRING_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "items": ["spotify:track:1IMa0Il4w988MwZCUcISix", "https://open.spotify.com/track/7bxaFZ1O3cHkgLKMsdC3xR"]
  }'

data starts with these rows:

[
  {
    "id": "1IMa0Il4w988MwZCUcISix",
    "uri": "spotify:track:1IMa0Il4w988MwZCUcISix",
    "url": "https://open.spotify.com/track/1IMa0Il4w988MwZCUcISix",
    "name": "bissu dumm ¿ MEGALODON REMIX",
    "artists": [
      {
        "id": "1aS5tqEs9ci5P9KD9tZWa6",
        "uri": "spotify:artist:1aS5tqEs9ci5P9KD9tZWa6",
        "url": "https://open.spotify.com/artist/1aS5tqEs9ci5P9KD9tZWa6",
        "name": "Bonez MC"
      },
      {
        "id": "5PIdjtNMwJgYituTP77U3X",
        "uri": "spotify:artist:5PIdjtNMwJgYituTP77U3X",
        "url": "https://open.spotify.com/artist/5PIdjtNMwJgYituTP77U3X",
        "name": "Nate57"
      },
      {
        "id": "5dM0ApSI0k1TcOseiik0sY",
        "uri": "spotify:artist:5dM0ApSI0k1TcOseiik0sY",
        "url": "https://open.spotify.com/artist/5dM0ApSI0k1TcOseiik0sY",
        "name": "JUGGLERZ"
      },
      {
        "id": "6JOYrJkaS8ZKxLoUdNNdWr",
        "uri": "spotify:artist:6JOYrJkaS8ZKxLoUdNNdWr",
        "url": "https://open.spotify.com/artist/6JOYrJkaS8ZKxLoUdNNdWr",
        "name": "AchtVier"
      },
      {
        "id": "3803JqLnUACUJcuCLmK3xz",
        "uri": "spotify:artist:3803JqLnUACUJcuCLmK3xz",
        "url": "https://open.spotify.com/artist/3803JqLnUACUJcuCLmK3xz",
        "name": "AK 33"
      },
      {
        "id": "07SFzTMeYf5P8Rd32a9Zzw",
        "uri": "spotify:artist:07SFzTMeYf5P8Rd32a9Zzw",
        "url": "https://open.spotify.com/artist/07SFzTMeYf5P8Rd32a9Zzw",
        "name": "AK AUSSERKONTROLLE"
      },
      {
        "id": "7LQLsKs1Qulq0BxYdhRnBU",
        "uri": "spotify:artist:7LQLsKs1Qulq0BxYdhRnBU",
        "url": "https://open.spotify.com/artist/7LQLsKs1Qulq0BxYdhRnBU",
        "name": "AZAD"
      },
      {
        "id": "18Zq5h68TQ6kurXzRNHJDo",
        "uri": "spotify:artist:18Zq5h68TQ6kurXzRNHJDo",
        "url": "https://open.spotify.com/artist/18Zq5h68TQ6kurXzRNHJDo",
        "name": "Big Toe"
      },
      {
        "id": "0ZqNAlpzFTJI4tyK4UwJE2",
        "uri": "spotify:artist:0ZqNAlpzFTJI4tyK4UwJE2",
        "url": "https://open.spotify.com/artist/0ZqNAlpzFTJI4tyK4UwJE2",
        "name": "CANEY030"
      },
      {
        "id": "48Fq6GV3S6on56TxSBu5NO",
        "uri": "spotify:artist:48Fq6GV3S6on56TxSBu5NO",
        "url": "https://open.spotify.com/artist/48Fq6GV3S6on56TxSBu5NO",
        "name": "Celo & Abdi"
      },
      {
        "id": "27ERI8hVciwqhL2mYZMaqu",
        "uri": "spotify:artist:27ERI8hVciwqhL2mYZMaqu",
        "url": "https://open.spotify.com/artist/27ERI8hVciwqhL2mYZMaqu",
        "name": "Crackaveli"
      }
    ],
    "album": {
      "id": "1QsNFGsyAsJ7jBx5inCQ4F",
      "uri": "spotify:album:1QsNFGsyAsJ7jBx5inCQ4F",
      "url": "https://open.spotify.com/album/1QsNFGsyAsJ7jBx5inCQ4F",
      "name": "bissu dumm ¿ MEGALODON REMIX"
    },
    "durationMs": 1114155,
    "playCount": 30543188,
    "explicit": true,
    "playable": true,
    "trackNumber": 1,
    "imageUrl": "https://i.scdn.co/image/ab67616d0000b2735e61fce2d6ebbfcc58958a82",
    "albumType": "SINGLE",
    "releaseDate": "2025-04-16",
    "albumTrackCount": 1,
    "copyrights": ["© 2025 187 Strassenbande", "℗ 2025 187 Strassenbande"],
    "distributionLine": "Distributed by Vertigo/Capitol",
    "previewUrl": null,
    "credits": [
      {
        "name": "Bonez MC",
        "role": "Main Artist",
        "group": "Artist",
        "artist": {
          "id": "1aS5tqEs9ci5P9KD9tZWa6",
          "uri": "spotify:artist:1aS5tqEs9ci5P9KD9tZWa6",
          "url": "https://open.spotify.com/artist/1aS5tqEs9ci5P9KD9tZWa6",
          "name": "Bonez MC"
        }
      },
      {
        "name": "Nate57",
        "role": "Main Artist",
        "group": "Artist",
        "artist": {
          "id": "5PIdjtNMwJgYituTP77U3X",
          "uri": "spotify:artist:5PIdjtNMwJgYituTP77U3X",
          "url": "https://open.spotify.com/artist/5PIdjtNMwJgYituTP77U3X",
          "name": "Nate57"
        }
      },
      {
        "name": "JUGGLERZ",
        "role": "Main Artist",
        "group": "Artist",
        "artist": {
          "id": "5dM0ApSI0k1TcOseiik0sY",
          "uri": "spotify:artist:5dM0ApSI0k1TcOseiik0sY",
          "url": "https://open.spotify.com/artist/5dM0ApSI0k1TcOseiik0sY",
          "name": "JUGGLERZ"
        }
      },
      {
        "name": "AchtVier",
        "role": "Main Artist",
        "group": "Artist",
        "artist": {
          "id": "6JOYrJkaS8ZKxLoUdNNdWr",
          "uri": "spotify:artist:6JOYrJkaS8ZKxLoUdNNdWr",
          "url": "https://open.spotify.com/artist/6JOYrJkaS8ZKxLoUdNNdWr",
          "name": "AchtVier"
        }
      }
    ],
    "sources": ["187 Strassenbande & Vertigo/Capitol"]
  },
  {
    "id": "7bxaFZ1O3cHkgLKMsdC3xR",
    "uri": "spotify:track:7bxaFZ1O3cHkgLKMsdC3xR",
    "url": "https://open.spotify.com/track/7bxaFZ1O3cHkgLKMsdC3xR",
    "name": "Loser",
    "artists": [
      {
        "id": "5INjqkS1o8h1imAzPqGZBb",
        "uri": "spotify:artist:5INjqkS1o8h1imAzPqGZBb",
        "url": "https://open.spotify.com/artist/5INjqkS1o8h1imAzPqGZBb",
        "name": "Tame Impala"
      }
    ],
    "album": {
      "id": "5WulAOx9ilWy1h8UGZ1gkI",
      "uri": "spotify:album:5WulAOx9ilWy1h8UGZ1gkI",
      "url": "https://open.spotify.com/album/5WulAOx9ilWy1h8UGZ1gkI",
      "name": "Deadbeat"
    },
    "durationMs": 223069,
    "playCount": 377723975,
    "explicit": true,
    "playable": true,
    "trackNumber": 4,
    "imageUrl": "https://i.scdn.co/image/ab67616d0000b273208500450dcd0fd294d7bd3b",
    "albumType": "ALBUM",
    "releaseDate": "2025-10-17",
    "albumTrackCount": 12,
    "copyrights": ["(P) 2025 Columbia Records, a Division of Sony Music Entertainment, under exclusive license from Tame Impala"],
    "distributionLine": null,
    "previewUrl": "https://p.scdn.co/mp3-preview/0015e9347a45b62215447eba657b2fc3ce279d2d",
    "credits": [
      {
        "name": "Tame Impala",
        "role": "Main Artist",
        "group": "Artist",
        "artist": {
          "id": "5INjqkS1o8h1imAzPqGZBb",
          "uri": "spotify:artist:5INjqkS1o8h1imAzPqGZBb",
          "url": "https://open.spotify.com/artist/5INjqkS1o8h1imAzPqGZBb",
          "name": "Tame Impala"
        }
      },
      {
        "name": "Kevin Parker",
        "role": "Composer",
        "group": "Composition & Lyrics",
        "artist": {
          "id": "6Eqw62GtvNihP6LzluYS8s",
          "uri": "spotify:artist:6Eqw62GtvNihP6LzluYS8s",
          "url": "https://open.spotify.com/artist/6Eqw62GtvNihP6LzluYS8s",
          "name": "Kevin Parker"
        }
      },
      {
        "name": "Kevin Parker",
        "role": "Lyricist",
        "group": "Composition & Lyrics",
        "artist": {
          "id": "6Eqw62GtvNihP6LzluYS8s",
          "uri": "spotify:artist:6Eqw62GtvNihP6LzluYS8s",
          "url": "https://open.spotify.com/artist/6Eqw62GtvNihP6LzluYS8s",
          "name": "Kevin Parker"
        }
      },
      {
        "name": "Kevin Parker",
        "role": "Mixing Engineer",
        "group": "Production & Engineering",
        "artist": {
          "id": "6Eqw62GtvNihP6LzluYS8s",
          "uri": "spotify:artist:6Eqw62GtvNihP6LzluYS8s",
          "url": "https://open.spotify.com/artist/6Eqw62GtvNihP6LzluYS8s",
          "name": "Kevin Parker"
        }
      }
    ],
    "sources": ["Columbia"]
  }
]

Requests and billing

Requests: 3 Web Access requests per entry in items, plus up to 1 setup request per call.
Billing: passthrough. Each request the action makes bills at its own rate on your plan; there is no separate charge for the action. See Pricing.

`playlist`

Read a Spotify playlist: name, description, owner, follower count, cover image and total length, and its tracks in order (up to 10,000), each with artists, album, duration, explicit flag, play count, and who added it and when.

POST https://request.usestring.ai/v1/integrations/spotify/playlist

Input

Unknown fields are rejected.

Field	Type	Description
`playlist`	string	Required. A Spotify playlist: an open.spotify.com/playlist link, a spotify:playlist: URI or a bare playlist id. At least 1 character.
`limit`	integer	The most tracks to return, in playlist order, 1 to 10000. Defaults to 100. From 1 to 10000.

Output

data is an array of rows, one per result. Each row has:

Field	Type	Description
`id`	string	The playlist's Spotify id.
`uri`	string	—
`url`	string	—
`name`	string	—
`description`	string \| null	The playlist's description, as plain text.
`owner`	object \| null	The user who owns the playlist; Spotify itself for an editorial playlist.
`owner.id`	string	The entity's Spotify id.
`owner.uri`	string	The entity's spotify: URI, such as spotify:artist:2Z9KL8Zmqx5Sg3cd7Fldhl.
`owner.url`	string	The entity's open.spotify.com page.
`owner.name`	string	—
`followers`	integer \| null	How many users saved the playlist.
`imageUrl`	string \| null	—
`trackCount`	integer	How many entries the playlist holds in all, which can exceed the tracks returned.
`tracks`	object[]	The playlist's tracks in order, up to limit, with who added each and when. Podcast episodes and local files in the playlist are left out.
`tracks[].id`	string	The track's Spotify id.
`tracks[].uri`	string	—
`tracks[].url`	string	The track's open.spotify.com page.
`tracks[].name`	string	—
`tracks[].artists`	object[] \| null	The track's credited artists, main artist first.
`tracks[].artists[].id`	string	The entity's Spotify id.
`tracks[].artists[].uri`	string	The entity's spotify: URI, such as spotify:artist:2Z9KL8Zmqx5Sg3cd7Fldhl.
`tracks[].artists[].url`	string	The entity's open.spotify.com page.
`tracks[].artists[].name`	string	—
`tracks[].album`	object \| null	The release the track is on; absent inside an album's own track list. May be absent.
`tracks[].album.id`	string	The entity's Spotify id.
`tracks[].album.uri`	string	The entity's spotify: URI, such as spotify:artist:2Z9KL8Zmqx5Sg3cd7Fldhl.
`tracks[].album.url`	string	The entity's open.spotify.com page.
`tracks[].album.name`	string	—
`tracks[].durationMs`	integer \| null	—
`tracks[].playCount`	integer \| null	Spotify's all-time play count for the track, as the web player shows it; null where Spotify shows none.
`tracks[].explicit`	boolean	—
`tracks[].playable`	boolean \| null	Whether Spotify will play the track in the region the request ran from.
`tracks[].trackNumber`	integer \| null	The track's position on its disc. May be absent.
`tracks[].discNumber`	integer \| null	May be absent.
`tracks[].imageUrl`	string \| null	The largest cover image of the track's release. May be absent.
`tracks[].addedAt`	string \| null	When the track was added to the playlist (playlist tracks only) May be absent.
`tracks[].addedBy`	object \| null	The user who added the track (playlist tracks only, where Spotify shows one) May be absent.
`tracks[].addedBy.id`	string	The entity's Spotify id.
`tracks[].addedBy.uri`	string	The entity's spotify: URI, such as spotify:artist:2Z9KL8Zmqx5Sg3cd7Fldhl.
`tracks[].addedBy.url`	string	The entity's open.spotify.com page.
`tracks[].addedBy.name`	string	—

Example

curl https://request.usestring.ai/v1/integrations/spotify/playlist \
  -H "Authorization: Bearer $STRING_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "playlist": "https://open.spotify.com/playlist/37i9dQZF1DXcBWIGoYBM5M",
    "limit": 50
  }'

data starts with these rows:

[
  {
    "id": "37i9dQZF1DXcBWIGoYBM5M",
    "uri": "spotify:playlist:37i9dQZF1DXcBWIGoYBM5M",
    "url": "https://open.spotify.com/playlist/37i9dQZF1DXcBWIGoYBM5M",
    "name": "Today’s Top Hits",
    "description": "The hottest 50. Cover: Tame Impala",
    "owner": {
      "id": "spotify",
      "uri": "spotify:user:spotify",
      "url": "https://open.spotify.com/user/spotify",
      "name": "Spotify"
    },
    "followers": 33626593,
    "imageUrl": "https://i.scdn.co/image/ab67706f00000002960019ea66cba66a44fdd4c2",
    "trackCount": 50,
    "tracks": [
      {
        "id": "7bxaFZ1O3cHkgLKMsdC3xR",
        "uri": "spotify:track:7bxaFZ1O3cHkgLKMsdC3xR",
        "url": "https://open.spotify.com/track/7bxaFZ1O3cHkgLKMsdC3xR",
        "name": "Loser",
        "artists": [
          {
            "id": "5INjqkS1o8h1imAzPqGZBb",
            "uri": "spotify:artist:5INjqkS1o8h1imAzPqGZBb",
            "url": "https://open.spotify.com/artist/5INjqkS1o8h1imAzPqGZBb",
            "name": "Tame Impala"
          }
        ],
        "album": {
          "id": "5WulAOx9ilWy1h8UGZ1gkI",
          "uri": "spotify:album:5WulAOx9ilWy1h8UGZ1gkI",
          "url": "https://open.spotify.com/album/5WulAOx9ilWy1h8UGZ1gkI",
          "name": "Deadbeat"
        },
        "durationMs": 223069,
        "playCount": 377723975,
        "explicit": true,
        "playable": true,
        "trackNumber": 4,
        "discNumber": 1,
        "imageUrl": "https://i.scdn.co/image/ab67616d0000b273208500450dcd0fd294d7bd3b",
        "addedAt": "2026-08-07T04:02:23.096Z"
      },
      {
        "id": "2sFepQNyl1WjpROruP8bJ0",
        "uri": "spotify:track:2sFepQNyl1WjpROruP8bJ0",
        "url": "https://open.spotify.com/track/2sFepQNyl1WjpROruP8bJ0",
        "name": "Housewife",
        "artists": [
          {
            "id": "45dkTj5sMRSjrmBSBeiHym",
            "uri": "spotify:artist:45dkTj5sMRSjrmBSBeiHym",
            "url": "https://open.spotify.com/artist/45dkTj5sMRSjrmBSBeiHym",
            "name": "Tate McRae"
          }
        ],
        "album": {
          "id": "6JvmSyocXef7RZDZFaymNl",
          "uri": "spotify:album:6JvmSyocXef7RZDZFaymNl",
          "url": "https://open.spotify.com/album/6JvmSyocXef7RZDZFaymNl",
          "name": "Housewife"
        },
        "durationMs": 208810,
        "playCount": 126614045,
        "explicit": false,
        "playable": true,
        "trackNumber": 1,
        "discNumber": 1,
        "imageUrl": "https://i.scdn.co/image/ab67616d0000b273f2d3185e46b03c243f60ce53",
        "addedAt": "2026-10-16T04:01:13.791Z"
      },
      {
        "id": "70cHKK8bHAfJrOGVnfRG9J",
        "uri": "spotify:track:70cHKK8bHAfJrOGVnfRG9J",
        "url": "https://open.spotify.com/track/70cHKK8bHAfJrOGVnfRG9J",
        "name": "Nicole Kidman",
        "artists": [
          {
            "id": "2qanRMyA5bNuTvz1dK45OP",
            "uri": "spotify:artist:2qanRMyA5bNuTvz1dK45OP",
            "url": "https://open.spotify.com/artist/2qanRMyA5bNuTvz1dK45OP",
            "name": "ADÉLA"
          }
        ],
        "album": {
          "id": "2yDFVH9CeOHt0sc9eI0aBs",
          "uri": "spotify:album:2yDFVH9CeOHt0sc9eI0aBs",
          "url": "https://open.spotify.com/album/2yDFVH9CeOHt0sc9eI0aBs",
          "name": "PRIMA"
        },
        "durationMs": 181270,
        "playCount": 242466927,
        "explicit": true,
        "playable": true,
        "trackNumber": 2,
        "discNumber": 1,
        "imageUrl": "https://i.scdn.co/image/ab67616d0000b273ac9d5d5263e9f03802d6864c",
        "addedAt": "2026-09-11T04:01:53.033Z"
      }
    ]
  }
]

Requests and billing

Requests: 1 Web Access request per result page, plus up to 1 setup request per call.
Billing: passthrough. Each request the action makes bills at its own rate on your plan; there is no separate charge for the action. See Pricing.

`show`

Read a Spotify podcast or audiobook: name, publisher, description, cover, explicit flag, media type, listener rating, topics or genres, an audiobook's authors, narrators, publish date, length and price, and the podcast's episodes newest first or the audiobook's chapters in order (up to 3,000), each with its description, duration, release date and playability.

POST https://request.usestring.ai/v1/integrations/spotify/show

Input

Unknown fields are rejected.

Field	Type	Description
`show`	string	Required. A Spotify podcast or audiobook: an open.spotify.com/show link, a spotify:show: URI or a bare show id. At least 1 character.
`limit`	integer	The most episodes (newest first) or chapters (in order) to return, 1 to 3000. Defaults to 50. From 1 to 3000.

Output

data is an array of rows, one per result. Each row has:

Field	Type	Description
`id`	string	The show's Spotify id.
`uri`	string	—
`url`	string	—
`type`	string	podcast or audiobook.
`name`	string	—
`publisher`	string \| null	—
`description`	string \| null	The show's description, as plain text.
`imageUrl`	string \| null	—
`explicit`	boolean	—
`mediaType`	string \| null	AUDIO, VIDEO or MIXED.
`rating`	object \| null	Listeners' star rating, where Spotify shows one.
`rating.average`	number	The average of listeners' 1 to 5 star ratings.
`rating.count`	integer	—
`topics`	string[]	The podcast's topics, or the audiobook's genres.
`authors`	string[]	An audiobook's authors; empty for a podcast.
`narrators`	string[]	An audiobook's narrators; empty for a podcast.
`publishDate`	string \| null	When an audiobook was published. May be absent.
`durationMs`	integer \| null	An audiobook's total length. May be absent.
`price`	object \| null	An audiobook's price, as sold in the region the request ran from. May be absent.
`price.amount`	number	—
`price.currency`	string	—
`price.formatted`	string	As the page shows it, such as $12.49.
`consumptionOrder`	string \| null	EPISODIC (newest first) or SEQUENTIAL (in order), for a podcast. May be absent.
`episodeCount`	integer	How many episodes or chapters the show has in all.
`episodes`	object[]	The podcast's episodes newest first, or the audiobook's chapters in order, up to limit.
`episodes[].id`	string	The episode's Spotify id.
`episodes[].uri`	string	—
`episodes[].url`	string	—
`episodes[].type`	string	episode, or chapter for an audiobook chapter.
`episodes[].name`	string	—
`episodes[].description`	string \| null	The episode's show notes, as plain text.
`episodes[].durationMs`	integer \| null	—
`episodes[].releaseDate`	string \| null	When the episode was published, as precise as Spotify states it.
`episodes[].explicit`	boolean	—
`episodes[].playable`	boolean \| null	Whether a logged-out listener can play it in the region the request ran from; false for a paywalled chapter.
`episodes[].mediaTypes`	string[] \| null	AUDIO and/or VIDEO.
`episodes[].imageUrl`	string \| null	—
`episodes[].previewUrl`	string \| null	A short public audio preview, where Spotify offers one.
`episodes[].show`	object \| null	The podcast or audiobook the episode belongs to.
`episodes[].show.id`	string	The entity's Spotify id.
`episodes[].show.uri`	string	The entity's spotify: URI, such as spotify:artist:2Z9KL8Zmqx5Sg3cd7Fldhl.
`episodes[].show.url`	string	The entity's open.spotify.com page.
`episodes[].show.name`	string	—

Example

curl https://request.usestring.ai/v1/integrations/spotify/show \
  -H "Authorization: Bearer $STRING_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "show": "https://open.spotify.com/show/0d9jEMAhxcXp7gZt0O4hSV",
    "limit": 20
  }'

data starts with these rows:

[
  {
    "id": "0d9jEMAhxcXp7gZt0O4hSV",
    "uri": "spotify:show:0d9jEMAhxcXp7gZt0O4hSV",
    "url": "https://open.spotify.com/show/0d9jEMAhxcXp7gZt0O4hSV",
    "type": "podcast",
    "name": "Deutschrap Plus - Der Podcast rund um Rap & Releases",
    "publisher": "Deutschrap Plus",
    "description": "Deutschrap, was geht ab ⁉️\n\nHier dreht sich alles um Deutschrap: Aktuelle Releases, die heißesten News und legendäre Flashbacks aus den letzten 20 Jahren Rap-Geschichte. Wir feiern die Szene mit allem…",
    "imageUrl": "https://i.scdn.co/image/ab6765630000ba8a31c794ddb621031259d36598",
    "explicit": true,
    "mediaType": "MIXED",
    "rating": {
      "average": 4.534420289855073,
      "count": 552
    },
    "topics": ["Music"],
    "authors": [],
    "narrators": [],
    "consumptionOrder": "EPISODIC",
    "episodeCount": 414,
    "episodes": [
      {
        "id": "75htquI3F1S4X97zfxIzrR",
        "uri": "spotify:episode:75htquI3F1S4X97zfxIzrR",
        "url": "https://open.spotify.com/episode/75htquI3F1S4X97zfxIzrR",
        "type": "episode",
        "name": "5 Deutschrap-Songs aus Oktober, die du kennen MUSST 👀",
        "description": "Diese 5 Deutschrap-Songs aus dem Oktober, musst du unbedingt gehört haben!!!\n\nMit dabei sind: Kool Savas, Haqat & Cazal feat. Bausa, Celo & Abdi, Fler, Kiarababa x Juju 👀\n\nAll das erfahrt ihr in der n…",
        "durationMs": 2798867,
        "releaseDate": "2026-11-03T00:54:00Z",
        "explicit": false,
        "playable": true,
        "mediaTypes": ["AUDIO"],
        "imageUrl": "https://i.scdn.co/image/ab6765630000ba8a3f0b4bc179c9394ac8276086",
        "previewUrl": "https://p.scdn.co/mp3-preview/d06646e4da8512103306ae752e500dc688af8ebe.mp3",
        "show": {
          "id": "0d9jEMAhxcXp7gZt0O4hSV",
          "uri": "spotify:show:0d9jEMAhxcXp7gZt0O4hSV",
          "url": "https://open.spotify.com/show/0d9jEMAhxcXp7gZt0O4hSV",
          "name": "Deutschrap Plus - Der Podcast rund um Rap & Releases"
        }
      },
      {
        "id": "3EeERgYni4KqwK7lfRUD1R",
        "uri": "spotify:episode:3EeERgYni4KqwK7lfRUD1R",
        "url": "https://open.spotify.com/episode/3EeERgYni4KqwK7lfRUD1R",
        "type": "episode",
        "name": "Ski Aggu Musik: Neues Ski Aggu Album zu kurz oder zu geil?",
        "description": "Ski Aggu droppt das erste Album nach der Trennung von Bamboo Artists – wir besprechen Ski Aggu Musik!\n\nAll das erfahrt ihr in der neuen Folge des Deutschrap Plus Podcasts - Jetzt reinhören und abonnie…",
        "durationMs": 2125902,
        "releaseDate": "2026-10-27T02:16:00Z",
        "explicit": false,
        "playable": true,
        "mediaTypes": ["AUDIO"],
        "imageUrl": "https://i.scdn.co/image/ab6765630000ba8ab647b829f2cf7e9d758a4856",
        "previewUrl": "https://p.scdn.co/mp3-preview/c78e7ab219f0032e24d5ab9b1e0925c026c15a94.mp3",
        "show": {
          "id": "0d9jEMAhxcXp7gZt0O4hSV",
          "uri": "spotify:show:0d9jEMAhxcXp7gZt0O4hSV",
          "url": "https://open.spotify.com/show/0d9jEMAhxcXp7gZt0O4hSV",
          "name": "Deutschrap Plus - Der Podcast rund um Rap & Releases"
        }
      }
    ]
  }
]

Requests and billing

Requests: 1 Web Access request per result page, plus up to 2 setup requests per call.
Billing: passthrough. Each request the action makes bills at its own rate on your plan; there is no separate charge for the action. See Pricing.

`episode`

Read each Spotify podcast episode or audiobook chapter: name, show notes, duration, release date, explicit flag, playability, audio or video, cover, public preview link, and the show it belongs to.

POST https://request.usestring.ai/v1/integrations/spotify/episode

Input

Unknown fields are rejected.

Field	Type	Description
`items`	string[]	Required. Spotify episodes or audiobook chapters: open.spotify.com/episode links, spotify:episode: URIs, or bare episode ids. 1 to 300 entries.

Output

data is an array of rows, one per result. Each row has:

Field	Type	Description
`id`	string	The episode's Spotify id.
`uri`	string	—
`url`	string	—
`type`	string	episode, or chapter for an audiobook chapter.
`name`	string	—
`description`	string \| null	The episode's show notes, as plain text.
`durationMs`	integer \| null	—
`releaseDate`	string \| null	When the episode was published, as precise as Spotify states it.
`explicit`	boolean	—
`playable`	boolean \| null	Whether a logged-out listener can play it in the region the request ran from; false for a paywalled chapter.
`mediaTypes`	string[]	AUDIO and/or VIDEO.
`imageUrl`	string \| null	—
`previewUrl`	string \| null	A short public audio preview, where Spotify offers one.
`show`	object \| null	The podcast or audiobook the episode belongs to.
`show.id`	string	The entity's Spotify id.
`show.uri`	string	The entity's spotify: URI, such as spotify:artist:2Z9KL8Zmqx5Sg3cd7Fldhl.
`show.url`	string	The entity's open.spotify.com page.
`show.name`	string	—

Example

curl https://request.usestring.ai/v1/integrations/spotify/episode \
  -H "Authorization: Bearer $STRING_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "items": ["https://open.spotify.com/episode/6VjVDIj1sTzkOOnmnguSQF"]
  }'

data starts with these rows:

[
  {
    "id": "6VjVDIj1sTzkOOnmnguSQF",
    "uri": "spotify:episode:6VjVDIj1sTzkOOnmnguSQF",
    "url": "https://open.spotify.com/episode/6VjVDIj1sTzkOOnmnguSQF",
    "type": "episode",
    "name": "Olexesh: Verschwörungstheorien, CIA, Filme, Attentat von München, Russland, uvm. #waslos (2016) ",
    "description": "Freunde, Bekannte, Bratiya und Sestry: Olexesh ist back bei #waslos! Es geht wie gewohnt um Gott und die Welt. Dazu gibts noch Fanfragen. Gönnt euch hart!",
    "durationMs": 4711764,
    "releaseDate": "2026-03-11T23:01:00Z",
    "explicit": false,
    "playable": true,
    "mediaTypes": ["AUDIO", "VIDEO"],
    "imageUrl": "https://i.scdn.co/image/ab6765630000ba8a99aac41fea0a32401060a263",
    "previewUrl": "https://p.scdn.co/mp3-preview/cde29df688518906e91b09d158d768c049d90fb1.mp3",
    "show": {
      "id": "79o6uuLdf5uDIR5qyaT20q",
      "uri": "spotify:show:79o6uuLdf5uDIR5qyaT20q",
      "url": "https://open.spotify.com/show/79o6uuLdf5uDIR5qyaT20q",
      "name": "Hiphop.de Classics"
    }
  }
]

Requests and billing

Requests: 1 Web Access request per entry in items, plus up to 1 setup request per call.
Billing: passthrough. Each request the action makes bills at its own rate on your plan; there is no separate charge for the action. See Pricing.

`recommendations`

Read what Spotify recommends alongside each track, podcast episode or podcast, as the web player's More like this shelves list it: for a track, similar tracks (with play counts) and albums; for an episode, similar episodes; for a podcast, similar podcasts. Each row is one recommendation with its type, rank, id, link, name and image, plus what that type carries, and the entity it is recommended for.

POST https://request.usestring.ai/v1/integrations/spotify/recommendations

Input

Unknown fields are rejected.

Field	Type	Description
`items`	string[]	Required. Spotify tracks, episodes or podcasts: open.spotify.com/track, /episode or /show links, spotify: URIs, or bare ids (read as tracks) 1 to 300 entries.

Output

data is an array of rows, one per result. Each row has:

Field	Type	Description
`for`	string	The spotify: URI of the track, episode or podcast this is recommended for.
`type`	string	track, artist, album, playlist, podcast, episode, audiobook, user, genre or author; browse shelves also list category.
`position`	integer	The result's rank within its type, from 1.
`id`	string	The result's Spotify id.
`uri`	string	—
`url`	string	The result's open.spotify.com page.
`name`	string	—
`artists`	object[] \| null	A track's or album's artists. May be absent.
`artists[].id`	string	The entity's Spotify id.
`artists[].uri`	string	The entity's spotify: URI, such as spotify:artist:2Z9KL8Zmqx5Sg3cd7Fldhl.
`artists[].url`	string	The entity's open.spotify.com page.
`artists[].name`	string	—
`album`	object \| null	The release a track is on. May be absent.
`album.id`	string	The entity's Spotify id.
`album.uri`	string	The entity's spotify: URI, such as spotify:artist:2Z9KL8Zmqx5Sg3cd7Fldhl.
`album.url`	string	The entity's open.spotify.com page.
`album.name`	string	—
`albumType`	string \| null	An album's type: ALBUM, SINGLE, EP or COMPILATION. May be absent.
`releaseDate`	string \| null	An album's or episode's release date, as precise as Spotify states it. May be absent.
`durationMs`	integer \| null	A track's or episode's length. May be absent.
`explicit`	boolean \| null	Whether a track or episode is marked explicit. May be absent.
`verified`	boolean \| null	Whether an artist is verified. May be absent.
`owner`	object \| null	A playlist's owner. May be absent.
`owner.id`	string	The entity's Spotify id.
`owner.uri`	string	The entity's spotify: URI, such as spotify:artist:2Z9KL8Zmqx5Sg3cd7Fldhl.
`owner.url`	string	The entity's open.spotify.com page.
`owner.name`	string	—
`description`	string \| null	A playlist's, episode's or audiobook's description, or an author's biography, as plain text. May be absent.
`publisher`	string \| null	A podcast's publisher. May be absent.
`show`	object \| null	The podcast an episode belongs to. May be absent.
`show.id`	string	The entity's Spotify id.
`show.uri`	string	The entity's spotify: URI, such as spotify:artist:2Z9KL8Zmqx5Sg3cd7Fldhl.
`show.url`	string	The entity's open.spotify.com page.
`show.name`	string	—
`authors`	string[] \| null	An audiobook's authors. May be absent.
`imageUrl`	string \| null	The result's largest image: cover art, avatar or playlist image.
`playCount`	integer \| null	A recommended track's all-time play count. May be absent.

Example

curl https://request.usestring.ai/v1/integrations/spotify/recommendations \
  -H "Authorization: Bearer $STRING_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "items": ["https://open.spotify.com/track/4uLU6hMCjMI75M1A2tKUQC", "spotify:show:4rOoJ6Egrf8K2IrywzwOMk"]
  }'

data starts with these rows:

[
  {
    "for": "spotify:track:4uLU6hMCjMI75M1A2tKUQC",
    "type": "track",
    "position": 1,
    "id": "3kXoKlD84c6OmIcOLfrfEs",
    "uri": "spotify:track:3kXoKlD84c6OmIcOLfrfEs",
    "url": "https://open.spotify.com/track/3kXoKlD84c6OmIcOLfrfEs",
    "name": "September",
    "artists": [
      {
        "id": "4QQgXkCYTt3BlENzhyNETg",
        "uri": "spotify:artist:4QQgXkCYTt3BlENzhyNETg",
        "url": "https://open.spotify.com/artist/4QQgXkCYTt3BlENzhyNETg",
        "name": "Earth, Wind & Fire"
      }
    ],
    "album": {
      "id": "3p90GIjEg4gXpnLmwGGvzI",
      "uri": "spotify:album:3p90GIjEg4gXpnLmwGGvzI",
      "url": "https://open.spotify.com/album/3p90GIjEg4gXpnLmwGGvzI",
      "name": ""
    },
    "durationMs": 216022,
    "explicit": false,
    "imageUrl": "https://i.scdn.co/image/ab67616d0000b2730faf2fc17446651865ce2282",
    "playCount": 2485166326
  },
  {
    "for": "spotify:track:4uLU6hMCjMI75M1A2tKUQC",
    "type": "track",
    "position": 2,
    "id": "1TfqLAPs4K3s2rJMoCokcS",
    "uri": "spotify:track:1TfqLAPs4K3s2rJMoCokcS",
    "url": "https://open.spotify.com/track/1TfqLAPs4K3s2rJMoCokcS",
    "name": "Sweet Dreams (Are Made of This) - 2005 Remaster",
    "artists": [
      {
        "id": "0NKDgy9j66h3DLnN8qu1bB",
        "uri": "spotify:artist:0NKDgy9j66h3DLnN8qu1bB",
        "url": "https://open.spotify.com/artist/0NKDgy9j66h3DLnN8qu1bB",
        "name": "Eurythmics"
      },
      {
        "id": "5MspMQqdVbdwP6ax3GXqum",
        "uri": "spotify:artist:5MspMQqdVbdwP6ax3GXqum",
        "url": "https://open.spotify.com/artist/5MspMQqdVbdwP6ax3GXqum",
        "name": "Annie Lennox"
      },
      {
        "id": "7gcCQIlkkfbul5Mt0jBQkg",
        "uri": "spotify:artist:7gcCQIlkkfbul5Mt0jBQkg",
        "url": "https://open.spotify.com/artist/7gcCQIlkkfbul5Mt0jBQkg",
        "name": "Dave Stewart"
      }
    ],
    "album": {
      "id": "5jNDWA19BJbE24x1UUJGRY",
      "uri": "spotify:album:5jNDWA19BJbE24x1UUJGRY",
      "url": "https://open.spotify.com/album/5jNDWA19BJbE24x1UUJGRY",
      "name": ""
    },
    "durationMs": 216933,
    "explicit": false,
    "imageUrl": "https://i.scdn.co/image/ab67616d0000b273b3994c94dfb241923664bb4d",
    "playCount": 2043872306
  },
  {
    "for": "spotify:track:4uLU6hMCjMI75M1A2tKUQC",
    "type": "track",
    "position": 3,
    "id": "2Lz4iCypeUTy62CP3Xwk6i",
    "uri": "spotify:track:2Lz4iCypeUTy62CP3Xwk6i",
    "url": "https://open.spotify.com/track/2Lz4iCypeUTy62CP3Xwk6i",
    "name": "Stayin' Alive - From \"Saturday Night Fever\" Soundtrack",
    "artists": [
      {
        "id": "1LZEQNv7sE11VDY3SdxQeN",
        "uri": "spotify:artist:1LZEQNv7sE11VDY3SdxQeN",
        "url": "https://open.spotify.com/artist/1LZEQNv7sE11VDY3SdxQeN",
        "name": "Bee Gees"
      }
    ],
    "album": {
      "id": "0rgTenVmpKywToHph2HDMm",
      "uri": "spotify:album:0rgTenVmpKywToHph2HDMm",
      "url": "https://open.spotify.com/album/0rgTenVmpKywToHph2HDMm",
      "name": ""
    },
    "durationMs": 284666,
    "explicit": false,
    "imageUrl": "https://i.scdn.co/image/ab67616d0000b273c93a2d859ee3635aa415d61d",
    "playCount": 1619648714
  }
]

Requests and billing

Requests: 1–2 Web Access requests per entry in items, plus up to 1 setup request per call.
Billing: passthrough. Each request the action makes bills at its own rate on your plan; there is no separate charge for the action. See Pricing.

`concert`

Read each Spotify concert or festival page: title, start time, doors, the artists on the bill, the venue with its city, country and coordinates, genre tags, related dates, and every ticket offer with its seller, link, sale type, sale window and price where shown. The artist action lists an artist's concerts; the concerts action lists a city's.

POST https://request.usestring.ai/v1/integrations/spotify/concert

Input

Unknown fields are rejected.

Field	Type	Description
`items`	string[]	Required. Spotify concerts: open.spotify.com/concert links, spotify:concert: URIs, or bare concert ids. 1 to 300 entries.

Output

data is an array of rows, one per result. Each row has:

Field	Type	Description
`id`	string	The concert's Spotify id.
`uri`	string	—
`url`	string	The concert's open.spotify.com page.
`title`	string	—
`startDate`	string \| null	When the concert starts, as an ISO 8601 timestamp.
`doorsOpen`	string \| null	When doors open, where Spotify gives it.
`festival`	boolean	—
`ageRestriction`	string \| null	—
`artists`	object[]	The artists on the bill.
`artists[].id`	string	The entity's Spotify id.
`artists[].uri`	string	The entity's spotify: URI, such as spotify:artist:2Z9KL8Zmqx5Sg3cd7Fldhl.
`artists[].url`	string	The entity's open.spotify.com page.
`artists[].name`	string	—
`venue`	object \| null	The venue's Spotify page; the venue action reads it.
`venue.id`	string	The entity's Spotify id.
`venue.uri`	string	The entity's spotify: URI, such as spotify:artist:2Z9KL8Zmqx5Sg3cd7Fldhl.
`venue.url`	string	The entity's open.spotify.com page.
`venue.name`	string	—
`location`	object	—
`location.name`	string	The venue's name.
`location.city`	string \| null	—
`location.region`	string \| null	—
`location.country`	string \| null	ISO 3166-1 alpha-2 country code.
`location.metroArea`	string \| null	The metro area Spotify files the concert under, such as London, GB.
`location.latitude`	number \| null	—
`location.longitude`	number \| null	—
`genres`	string[]	The genres Spotify tags the concert with, most relevant first.
`offers`	object[]	Ticket offers from Spotify's ticketing partners.
`offers[].seller`	string	The ticket seller, such as Ticketmaster.
`offers[].url`	string	The seller's page for the tickets.
`offers[].saleType`	string \| null	Such as on-sale or presale.
`offers[].availability`	string \| null	As Spotify states it, such as AVAILABLE, SOLD_OUT or UNKNOWN.
`offers[].saleStart`	string \| null	When the offer opens, as an ISO 8601 timestamp.
`offers[].saleEnd`	string \| null	—
`offers[].minPrice`	number \| null	—
`offers[].maxPrice`	number \| null	—
`offers[].currency`	string \| null	—
`relatedConcerts`	object[]	Other dates Spotify lists with this one.
`relatedConcerts[].id`	string	The concert's Spotify id.
`relatedConcerts[].uri`	string	—
`relatedConcerts[].url`	string	The concert's open.spotify.com page.
`relatedConcerts[].title`	string	—
`relatedConcerts[].startDate`	string \| null	When the concert starts, as an ISO 8601 timestamp in the venue's offset where Spotify gives one.
`relatedConcerts[].festival`	boolean \| null	Whether the event is a festival.
`relatedConcerts[].venue`	string \| null	The venue's name.
`relatedConcerts[].city`	string \| null	—
`relatedConcerts[].artists`	object[] \| null	The artists on the bill, where the listing names them.
`relatedConcerts[].artists[].id`	string	The entity's Spotify id.
`relatedConcerts[].artists[].uri`	string	The entity's spotify: URI, such as spotify:artist:2Z9KL8Zmqx5Sg3cd7Fldhl.
`relatedConcerts[].artists[].url`	string	The entity's open.spotify.com page.
`relatedConcerts[].artists[].name`	string	—
`setlistPlaylist`	object \| null	The concert's setlist playlist, where one exists.
`setlistPlaylist.id`	string	The entity's Spotify id.
`setlistPlaylist.uri`	string	The entity's spotify: URI, such as spotify:artist:2Z9KL8Zmqx5Sg3cd7Fldhl.
`setlistPlaylist.url`	string	The entity's open.spotify.com page.
`setlistPlaylist.name`	string	—

Example

curl https://request.usestring.ai/v1/integrations/spotify/concert \
  -H "Authorization: Bearer $STRING_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "items": ["https://open.spotify.com/concert/6Uk6FeW4q5sOpJIEdGs4iY"]
  }'

data starts with these rows:

[
  {
    "id": "6Uk6FeW4q5sOpJIEdGs4iY",
    "uri": "spotify:concert:6Uk6FeW4q5sOpJIEdGs4iY",
    "url": "https://open.spotify.com/concert/6Uk6FeW4q5sOpJIEdGs4iY",
    "title": "Rick Astley",
    "startDate": "2026-12-09T18:45Z",
    "doorsOpen": null,
    "festival": false,
    "ageRestriction": null,
    "artists": [
      {
        "id": "0gxyHStUsqpMadRV0Di1Qt",
        "uri": "spotify:artist:0gxyHStUsqpMadRV0Di1Qt",
        "url": "https://open.spotify.com/artist/0gxyHStUsqpMadRV0Di1Qt",
        "name": "Rick Astley"
      }
    ],
    "venue": {
      "id": "0QlkqsikBzZwfFZLpmIcm8",
      "uri": "spotify:venue:0QlkqsikBzZwfFZLpmIcm8",
      "url": "https://open.spotify.com/venue/0QlkqsikBzZwfFZLpmIcm8",
      "name": "Royal Albert Hall"
    },
    "location": {
      "name": "Royal Albert Hall",
      "city": "London",
      "region": null,
      "country": "GB",
      "metroArea": "London, GB",
      "latitude": 51.501277,
      "longitude": -0.177552
    },
    "genres": ["pop soul", "pop", "pop rock", "synthpop", "orchestral"],
    "offers": [
      {
        "seller": "Ticketmaster",
        "url": "https://ticketmaster.evyy.net/c/296934/2038758/24023?sharedId=&subId1=&subId3=6Uk6FeW4q5sOpJIEdGs4iY&u=https%3A%2F%2Fwww.ticketmaster.co.uk%2Frick-astley-christmas-swing-show-london-09-12-2026%2Fevent%2F1F006535EFC4423E&utm_medium=affiliate",
        "saleType": "on-sale",
        "availability": "UNKNOWN",
        "saleStart": "2026-09-25T09:00:00Z",
        "saleEnd": "2026-12-09T18:45:00Z",
        "minPrice": null,
        "maxPrice": null,
        "currency": null
      },
      {
        "seller": "See Tickets",
        "url": "https://prf.hn/click/camref:1101l3IrX6/pubref:/tsource:Display/ar:%3A6Uk6FeW4q5sOpJIEdGs4iY/eventid:6Uk6FeW4q5sOpJIEdGs4iY/destination:https%3A%2F%2Fwww.seetickets.com%2Fevent%2Frick-astley%2Froyal-albert-hall%2F3728899%3Faff%3Did1spotify",
        "saleType": "on-sale",
        "availability": "UNKNOWN",
        "saleStart": "2026-09-25T10:00:00Z",
        "saleEnd": "2026-12-09T19:00:00Z",
        "minPrice": null,
        "maxPrice": null,
        "currency": null
      }
    ],
    "relatedConcerts": [],
    "setlistPlaylist": null
  }
]

Requests and billing

Requests: 1 Web Access request per entry in items, plus up to 1 setup request per call.
Billing: passthrough. Each request the action makes bills at its own rate on your plan; there is no separate charge for the action. See Pricing.

`venue`

Read each Spotify venue page: name, address, city, country, genre tags, and its upcoming concerts with their date, title and bill.

POST https://request.usestring.ai/v1/integrations/spotify/venue

Input

Unknown fields are rejected.

Field	Type	Description
`items`	string[]	Required. Spotify venues: open.spotify.com/venue links, spotify:venue: URIs, or bare venue ids. 1 to 300 entries.
`limit`	integer	The most upcoming concerts to list per venue, 1 to 500. Defaults to 50. From 1 to 500.

Output

data is an array of rows, one per result. Each row has:

Field	Type	Description
`id`	string	The venue's Spotify id.
`uri`	string	—
`url`	string	The venue's open.spotify.com page.
`name`	string	—
`address`	string \| null	—
`city`	string \| null	—
`country`	string \| null	ISO 3166-1 alpha-2 country code.
`genres`	string[]	The genres Spotify tags the venue with.
`concerts`	object[]	The venue's upcoming concerts, soonest first, up to the limit.
`concerts[].id`	string	The concert's Spotify id.
`concerts[].uri`	string	—
`concerts[].url`	string	The concert's open.spotify.com page.
`concerts[].title`	string	—
`concerts[].startDate`	string \| null	When the concert starts, as an ISO 8601 timestamp in the venue's offset where Spotify gives one.
`concerts[].festival`	boolean \| null	Whether the event is a festival.
`concerts[].venue`	string \| null	The venue's name.
`concerts[].city`	string \| null	—
`concerts[].artists`	object[] \| null	The artists on the bill, where the listing names them.
`concerts[].artists[].id`	string	The entity's Spotify id.
`concerts[].artists[].uri`	string	The entity's spotify: URI, such as spotify:artist:2Z9KL8Zmqx5Sg3cd7Fldhl.
`concerts[].artists[].url`	string	The entity's open.spotify.com page.
`concerts[].artists[].name`	string	—

Example

curl https://request.usestring.ai/v1/integrations/spotify/venue \
  -H "Authorization: Bearer $STRING_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "items": ["https://open.spotify.com/venue/0QlkqsikBzZwfFZLpmIcm8"],
    "limit": 60
  }'

data starts with these rows:

[
  {
    "id": "0QlkqsikBzZwfFZLpmIcm8",
    "uri": "spotify:venue:0QlkqsikBzZwfFZLpmIcm8",
    "url": "https://open.spotify.com/venue/0QlkqsikBzZwfFZLpmIcm8",
    "name": "Royal Albert Hall",
    "address": "Kensington Gore",
    "city": "London",
    "country": "GB",
    "genres": ["orchestral", "classical", "classic rock", "vocal jazz", "blues rock"],
    "concerts": [
      {
        "id": "4WtMwMXv6zBmS4q7iFr0sR",
        "uri": "spotify:concert:4WtMwMXv6zBmS4q7iFr0sR",
        "url": "https://open.spotify.com/concert/4WtMwMXv6zBmS4q7iFr0sR",
        "title": "Melody Gardot",
        "startDate": "2026-11-16T18:45Z",
        "festival": null,
        "venue": "Royal Albert Hall",
        "city": "London",
        "artists": [
          {
            "id": "2P1puQXmG48EVLBrHbum1J",
            "uri": "spotify:artist:2P1puQXmG48EVLBrHbum1J",
            "url": "https://open.spotify.com/artist/2P1puQXmG48EVLBrHbum1J",
            "name": "Melody Gardot"
          }
        ]
      },
      {
        "id": "21ZrJ7EHUkKWFEWF7h5d00",
        "uri": "spotify:concert:21ZrJ7EHUkKWFEWF7h5d00",
        "url": "https://open.spotify.com/concert/21ZrJ7EHUkKWFEWF7h5d00",
        "title": "Lucilla Rose Mariotti",
        "startDate": "2026-11-22T14:30Z",
        "festival": null,
        "venue": "Royal Albert Hall",
        "city": "London",
        "artists": [
          {
            "id": "0cZylT31dFuHQ1JCnwKIlS",
            "uri": "spotify:artist:0cZylT31dFuHQ1JCnwKIlS",
            "url": "https://open.spotify.com/artist/0cZylT31dFuHQ1JCnwKIlS",
            "name": "Lucilla Rose Mariotti"
          }
        ]
      },
      {
        "id": "092HMAp2AxeD9ar4UNOdsO",
        "uri": "spotify:concert:092HMAp2AxeD9ar4UNOdsO",
        "url": "https://open.spotify.com/concert/092HMAp2AxeD9ar4UNOdsO",
        "title": "Deep Purple, JAYLER",
        "startDate": "2026-11-25T18:45Z",
        "festival": null,
        "venue": "Royal Albert Hall",
        "city": "London",
        "artists": [
          {
            "id": "568ZhdwyaiCyOGJRtNYhWf",
            "uri": "spotify:artist:568ZhdwyaiCyOGJRtNYhWf",
            "url": "https://open.spotify.com/artist/568ZhdwyaiCyOGJRtNYhWf",
            "name": "Deep Purple"
          },
          {
            "id": "2cqlQm5f8HXjQ7LCMVsZ7f",
            "uri": "spotify:artist:2cqlQm5f8HXjQ7LCMVsZ7f",
            "url": "https://open.spotify.com/artist/2cqlQm5f8HXjQ7LCMVsZ7f",
            "name": "JAYLER"
          }
        ]
      }
    ]
  }
]

Requests and billing

Requests: 1–10 Web Access requests per entry in items, plus up to 1 setup request per call.
Billing: passthrough. Each request the action makes bills at its own rate on your plan; there is no separate charge for the action. See Pricing.

`concerts`

List the upcoming concerts near a city as the web player's Live Events feed does, soonest first: each concert's title, start time, venue, city and bill, and whether Spotify counts it among the city's popular events. The concert action reads one in full.

POST https://request.usestring.ai/v1/integrations/spotify/concerts

Input

Unknown fields are rejected.

Field	Type	Description
`location`	string	Required. The city to list concerts near: a city name, optionally with its country (Berlin, DE), or a GeoNames id. A name is matched the way the web player's location picker matches it, best match first. At least 1 character.
`limit`	integer	The most concerts to return, 1 to 500. Defaults to 50. From 1 to 500.

Output

data is an array of rows, one per result. Each row has:

Field	Type	Description
`id`	string	The concert's Spotify id.
`uri`	string	—
`url`	string	The concert's open.spotify.com page.
`title`	string	—
`startDate`	string \| null	When the concert starts, as an ISO 8601 timestamp in the venue's offset where Spotify gives one.
`festival`	boolean \| null	Whether the event is a festival.
`venue`	string \| null	The venue's name.
`city`	string \| null	—
`artists`	object[] \| null	The artists on the bill, where the listing names them.
`artists[].id`	string	The entity's Spotify id.
`artists[].uri`	string	The entity's spotify: URI, such as spotify:artist:2Z9KL8Zmqx5Sg3cd7Fldhl.
`artists[].url`	string	The entity's open.spotify.com page.
`artists[].name`	string	—
`area`	string	The city the feed is for, as Spotify names it, such as London, GB.
`popular`	boolean	Whether Spotify lists the concert among the city's popular events.

Example

curl https://request.usestring.ai/v1/integrations/spotify/concerts \
  -H "Authorization: Bearer $STRING_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "location": "London, GB",
    "limit": 30
  }'

data starts with these rows:

[
  {
    "id": "2hY3JKQaYQ8S2GVI8Yg6ug",
    "uri": "spotify:concert:2hY3JKQaYQ8S2GVI8Yg6ug",
    "url": "https://open.spotify.com/concert/2hY3JKQaYQ8S2GVI8Yg6ug",
    "title": "BTAY",
    "startDate": "2026-11-05T22:30Z",
    "festival": null,
    "venue": "Xoyo",
    "city": "London",
    "artists": [
      {
        "id": "5DMKvkvY7ZotKWhcYkDBzS",
        "uri": "spotify:artist:5DMKvkvY7ZotKWhcYkDBzS",
        "url": "https://open.spotify.com/artist/5DMKvkvY7ZotKWhcYkDBzS",
        "name": "BTAY"
      }
    ],
    "area": "London, GB",
    "popular": false
  },
  {
    "id": "7iPcRlxwyo2kMkvbZdiccw",
    "uri": "spotify:concert:7iPcRlxwyo2kMkvbZdiccw",
    "url": "https://open.spotify.com/concert/7iPcRlxwyo2kMkvbZdiccw",
    "title": "Jon Onabowu, David Mrakpor, INSXGHT",
    "startDate": "2026-11-05T23:00Z",
    "festival": null,
    "venue": "Ronnie Scott's",
    "city": "London",
    "artists": [
      {
        "id": "1B3fZSaCWJ9RkCUH2ZgYlu",
        "uri": "spotify:artist:1B3fZSaCWJ9RkCUH2ZgYlu",
        "url": "https://open.spotify.com/artist/1B3fZSaCWJ9RkCUH2ZgYlu",
        "name": "Jon Onabowu"
      },
      {
        "id": "7JNCmuOVO13j5XNE8s1Bvr",
        "uri": "spotify:artist:7JNCmuOVO13j5XNE8s1Bvr",
        "url": "https://open.spotify.com/artist/7JNCmuOVO13j5XNE8s1Bvr",
        "name": "David Mrakpor"
      },
      {
        "id": "4dwnFCeyTdjAyDZvNGAYxb",
        "uri": "spotify:artist:4dwnFCeyTdjAyDZvNGAYxb",
        "url": "https://open.spotify.com/artist/4dwnFCeyTdjAyDZvNGAYxb",
        "name": "INSXGHT"
      }
    ],
    "area": "London, GB",
    "popular": false
  },
  {
    "id": "2nOF3f52oARVmAUlWPFkIY",
    "uri": "spotify:concert:2nOF3f52oARVmAUlWPFkIY",
    "url": "https://open.spotify.com/concert/2nOF3f52oARVmAUlWPFkIY",
    "title": "Yaacov",
    "startDate": "2026-11-05T23:00Z",
    "festival": null,
    "venue": "The Scotch of St James",
    "city": "London",
    "artists": [
      {
        "id": "2bJyKzj1pzGbr0biIjoCWF",
        "uri": "spotify:artist:2bJyKzj1pzGbr0biIjoCWF",
        "url": "https://open.spotify.com/artist/2bJyKzj1pzGbr0biIjoCWF",
        "name": "Yaacov"
      }
    ],
    "area": "London, GB",
    "popular": false
  }
]

Requests and billing

Requests: 1–21 Web Access requests per call, plus up to 1 setup request per call.
Billing: passthrough. Each request the action makes bills at its own rate on your plan; there is no separate charge for the action. See Pricing.

`browse`

Read Spotify's Browse all grid of categories, or one genre or category page (Music, Pop, Podcasts and the rest) shelf by shelf, for a chosen market: each row is one item on a shelf (a playlist, album, artist, podcast, episode or sub-category) with the shelf's title, its rank on the shelf, and what that type carries.

POST https://request.usestring.ai/v1/integrations/spotify/browse

Input

Unknown fields are rejected.

Field	Type	Description
`page`	string	The genre or category page to read: an open.spotify.com/genre link, a spotify:page: URI, or a bare page id. Leave it out for the Browse all grid of categories.
`country`	string	ISO 3166-1 alpha-2 code of the market to read the page for, such as DE. Spotify builds the page for the country the request comes from; defaults to wherever Web Access routes it. Matches `^[A-Za-z]{2}$`.

Output

data is an array of rows, one per result. Each row has:

Field	Type	Description
`shelf`	string	The shelf's title as the page shows it, or for charts its kind: charts, trending_songs, popular_artists or popular_albums.
`shelfUri`	string \| null	The shelf's spotify:section: URI. May be absent.
`country`	string \| null	The country a charts row is for. May be absent.
`type`	string	track, artist, album, playlist, podcast, episode, audiobook, user, genre or author; browse shelves also list category.
`position`	integer	The result's rank within its type, from 1.
`id`	string	The result's Spotify id.
`uri`	string	—
`url`	string	The result's open.spotify.com page.
`name`	string	—
`artists`	object[] \| null	A track's or album's artists. May be absent.
`artists[].id`	string	The entity's Spotify id.
`artists[].uri`	string	The entity's spotify: URI, such as spotify:artist:2Z9KL8Zmqx5Sg3cd7Fldhl.
`artists[].url`	string	The entity's open.spotify.com page.
`artists[].name`	string	—
`album`	object \| null	The release a track is on. May be absent.
`album.id`	string	The entity's Spotify id.
`album.uri`	string	The entity's spotify: URI, such as spotify:artist:2Z9KL8Zmqx5Sg3cd7Fldhl.
`album.url`	string	The entity's open.spotify.com page.
`album.name`	string	—
`albumType`	string \| null	An album's type: ALBUM, SINGLE, EP or COMPILATION. May be absent.
`releaseDate`	string \| null	An album's or episode's release date, as precise as Spotify states it. May be absent.
`durationMs`	integer \| null	A track's or episode's length. May be absent.
`explicit`	boolean \| null	Whether a track or episode is marked explicit. May be absent.
`verified`	boolean \| null	Whether an artist is verified. May be absent.
`owner`	object \| null	A playlist's owner. May be absent.
`owner.id`	string	The entity's Spotify id.
`owner.uri`	string	The entity's spotify: URI, such as spotify:artist:2Z9KL8Zmqx5Sg3cd7Fldhl.
`owner.url`	string	The entity's open.spotify.com page.
`owner.name`	string	—
`description`	string \| null	A playlist's, episode's or audiobook's description, or an author's biography, as plain text. May be absent.
`publisher`	string \| null	A podcast's publisher. May be absent.
`show`	object \| null	The podcast an episode belongs to. May be absent.
`show.id`	string	The entity's Spotify id.
`show.uri`	string	The entity's spotify: URI, such as spotify:artist:2Z9KL8Zmqx5Sg3cd7Fldhl.
`show.url`	string	The entity's open.spotify.com page.
`show.name`	string	—
`authors`	string[] \| null	An audiobook's authors. May be absent.
`imageUrl`	string \| null	The result's largest image: cover art, avatar or playlist image.

Example

curl https://request.usestring.ai/v1/integrations/spotify/browse \
  -H "Authorization: Bearer $STRING_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'

data starts with these rows:

[
  {
    "shelf": "Browse all",
    "shelfUri": "spotify:section:0JQ5DAwD41j2mAgQ1AtEZl",
    "type": "category",
    "position": 1,
    "id": "0JQ5DAqbMKFSi39LMRT0Cy",
    "uri": "spotify:page:0JQ5DAqbMKFSi39LMRT0Cy",
    "url": "https://open.spotify.com/genre/0JQ5DAqbMKFSi39LMRT0Cy",
    "name": "Music",
    "imageUrl": "https://i.scdn.co/image/ab67fb8200008e2c21cf047fac53f26680dcad78"
  },
  {
    "shelf": "Browse all",
    "shelfUri": "spotify:section:0JQ5DAwD41j2mAgQ1AtEZl",
    "type": "category",
    "position": 2,
    "id": "0JQ5DArNBzkmxXHCqFLx2J",
    "uri": "spotify:page:0JQ5DArNBzkmxXHCqFLx2J",
    "url": "https://open.spotify.com/genre/0JQ5DArNBzkmxXHCqFLx2J",
    "name": "Podcasts",
    "imageUrl": "https://i.scdn.co/image/ab67fb8200005caf6cc0187b9ea66de1525c3cec"
  },
  {
    "shelf": "Browse all",
    "shelfUri": "spotify:section:0JQ5DAwD41j2mAgQ1AtEZl",
    "type": "category",
    "position": 3,
    "id": "0JQ5DAqbMKFETqK4t8f1n3",
    "uri": "spotify:page:0JQ5DAqbMKFETqK4t8f1n3",
    "url": "https://open.spotify.com/genre/0JQ5DAqbMKFETqK4t8f1n3",
    "name": "Audiobooks",
    "imageUrl": "https://i.scdn.co/image/ab67fb8200005cafa6152f62518b4c3251858b21"
  }
]

Requests and billing

Requests: 1 Web Access request per call, plus up to 1 setup request per call.
Billing: passthrough. Each request the action makes bills at its own rate on your plan; there is no separate charge for the action. See Pricing.

`home`

Read the home feed Spotify shows a logged-out visitor in a chosen market: trending songs, popular artists, albums and radio, featured charts and the rest, shelf by shelf. Each row is one item with its shelf's title, its rank on the shelf, and what its type carries.

POST https://request.usestring.ai/v1/integrations/spotify/home

Input

Unknown fields are rejected.

Field	Type	Description
`country`	string	ISO 3166-1 alpha-2 code of the market to read the home feed for, such as JP. Defaults to wherever Web Access routes the request. Matches `^[A-Za-z]{2}$`.
`timeZone`	string	The IANA time zone the feed is built for, such as Asia/Tokyo. Defaults to UTC.

Output

data is an array of rows, one per result. Each row has:

Field	Type	Description
`shelf`	string	The shelf's title as the page shows it, or for charts its kind: charts, trending_songs, popular_artists or popular_albums.
`shelfUri`	string \| null	The shelf's spotify:section: URI. May be absent.
`country`	string \| null	The country a charts row is for. May be absent.
`type`	string	track, artist, album, playlist, podcast, episode, audiobook, user, genre or author; browse shelves also list category.
`position`	integer	The result's rank within its type, from 1.
`id`	string	The result's Spotify id.
`uri`	string	—
`url`	string	The result's open.spotify.com page.
`name`	string	—
`artists`	object[] \| null	A track's or album's artists. May be absent.
`artists[].id`	string	The entity's Spotify id.
`artists[].uri`	string	The entity's spotify: URI, such as spotify:artist:2Z9KL8Zmqx5Sg3cd7Fldhl.
`artists[].url`	string	The entity's open.spotify.com page.
`artists[].name`	string	—
`album`	object \| null	The release a track is on. May be absent.
`album.id`	string	The entity's Spotify id.
`album.uri`	string	The entity's spotify: URI, such as spotify:artist:2Z9KL8Zmqx5Sg3cd7Fldhl.
`album.url`	string	The entity's open.spotify.com page.
`album.name`	string	—
`albumType`	string \| null	An album's type: ALBUM, SINGLE, EP or COMPILATION. May be absent.
`releaseDate`	string \| null	An album's or episode's release date, as precise as Spotify states it. May be absent.
`durationMs`	integer \| null	A track's or episode's length. May be absent.
`explicit`	boolean \| null	Whether a track or episode is marked explicit. May be absent.
`verified`	boolean \| null	Whether an artist is verified. May be absent.
`owner`	object \| null	A playlist's owner. May be absent.
`owner.id`	string	The entity's Spotify id.
`owner.uri`	string	The entity's spotify: URI, such as spotify:artist:2Z9KL8Zmqx5Sg3cd7Fldhl.
`owner.url`	string	The entity's open.spotify.com page.
`owner.name`	string	—
`description`	string \| null	A playlist's, episode's or audiobook's description, or an author's biography, as plain text. May be absent.
`publisher`	string \| null	A podcast's publisher. May be absent.
`show`	object \| null	The podcast an episode belongs to. May be absent.
`show.id`	string	The entity's Spotify id.
`show.uri`	string	The entity's spotify: URI, such as spotify:artist:2Z9KL8Zmqx5Sg3cd7Fldhl.
`show.url`	string	The entity's open.spotify.com page.
`show.name`	string	—
`authors`	string[] \| null	An audiobook's authors. May be absent.
`imageUrl`	string \| null	The result's largest image: cover art, avatar or playlist image.

Example

curl https://request.usestring.ai/v1/integrations/spotify/home \
  -H "Authorization: Bearer $STRING_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "country": "JP",
    "timeZone": "Asia/Tokyo"
  }'

data starts with these rows:

[
  {
    "shelf": "Trending songs",
    "shelfUri": "spotify:section:0JQ5DB5E8N831KzFzsBBQ2",
    "type": "track",
    "position": 1,
    "id": "0MohbpR6kxGC31EaMDkK4M",
    "uri": "spotify:track:0MohbpR6kxGC31EaMDkK4M",
    "url": "https://open.spotify.com/track/0MohbpR6kxGC31EaMDkK4M",
    "name": "爆裂愛しすぎて滅！(Crazy Mashup by TeddyLoid)",
    "artists": [
      {
        "id": "4jhJ8cnJ9vYKyCh289nuwQ",
        "uri": "spotify:artist:4jhJ8cnJ9vYKyCh289nuwQ",
        "url": "https://open.spotify.com/artist/4jhJ8cnJ9vYKyCh289nuwQ",
        "name": "M!LK"
      },
      {
        "id": "3GfNJrDTZY7voXPDx8gH9I",
        "uri": "spotify:artist:3GfNJrDTZY7voXPDx8gH9I",
        "url": "https://open.spotify.com/artist/3GfNJrDTZY7voXPDx8gH9I",
        "name": "TeddyLoid"
      }
    ],
    "album": {
      "id": "13TWDETr9SLtrIJsQAvqeY",
      "uri": "spotify:album:13TWDETr9SLtrIJsQAvqeY",
      "url": "https://open.spotify.com/album/13TWDETr9SLtrIJsQAvqeY",
      "name": "爆裂愛しすぎて滅！(Crazy Mashup by TeddyLoid)"
    },
    "explicit": false,
    "imageUrl": "https://i.scdn.co/image/ab67616d0000b2731e606ea1a0cd64b68163c796"
  },
  {
    "shelf": "Trending songs",
    "shelfUri": "spotify:section:0JQ5DB5E8N831KzFzsBBQ2",
    "type": "track",
    "position": 2,
    "id": "0pMoUGdpD8nupNP1mSdZUn",
    "uri": "spotify:track:0pMoUGdpD8nupNP1mSdZUn",
    "url": "https://open.spotify.com/track/0pMoUGdpD8nupNP1mSdZUn",
    "name": "You’re Under Arrest",
    "artists": [
      {
        "id": "36cgvBn0aadzOijnjjwqMN",
        "uri": "spotify:artist:36cgvBn0aadzOijnjjwqMN",
        "url": "https://open.spotify.com/artist/36cgvBn0aadzOijnjjwqMN",
        "name": "ILLIT"
      }
    ],
    "album": {
      "id": "4xYpXVSKqRTsL3ucRd8EMM",
      "uri": "spotify:album:4xYpXVSKqRTsL3ucRd8EMM",
      "url": "https://open.spotify.com/album/4xYpXVSKqRTsL3ucRd8EMM",
      "name": "BREAK EVEN"
    },
    "explicit": false,
    "imageUrl": "https://i.scdn.co/image/ab67616d0000b273df9518845a9897da168eb9df"
  },
  {
    "shelf": "Trending songs",
    "shelfUri": "spotify:section:0JQ5DB5E8N831KzFzsBBQ2",
    "type": "track",
    "position": 3,
    "id": "2wNsXxFKjKfiffzEK1RHqs",
    "uri": "spotify:track:2wNsXxFKjKfiffzEK1RHqs",
    "url": "https://open.spotify.com/track/2wNsXxFKjKfiffzEK1RHqs",
    "name": "Slidin",
    "artists": [
      {
        "id": "7fmXV2O48buswss04YetaN",
        "uri": "spotify:artist:7fmXV2O48buswss04YetaN",
        "url": "https://open.spotify.com/artist/7fmXV2O48buswss04YetaN",
        "name": "HANA"
      }
    ],
    "album": {
      "id": "3nSlGw0nRjALQMGVrvFxew",
      "uri": "spotify:album:3nSlGw0nRjALQMGVrvFxew",
      "url": "https://open.spotify.com/album/3nSlGw0nRjALQMGVrvFxew",
      "name": "Slidin"
    },
    "explicit": false,
    "imageUrl": "https://i.scdn.co/image/ab67616d0000b273a9a7fdd774fd4f2943a9a70b"
  }
]

Requests and billing

Requests: 1 Web Access request per call, plus up to 1 setup request per call.
Billing: passthrough. Each request the action makes bills at its own rate on your plan; there is no separate charge for the action. See Pricing.

`charts`

Read each country's charts page on Spotify: its chart playlists (Top Songs and Top 50 for the country and the world, which the playlist action reads track by track), and its top 50 trending songs, popular artists and popular albums, in rank order. Each row is one item with its shelf, rank and country.

POST https://request.usestring.ai/v1/integrations/spotify/charts

Input

Unknown fields are rejected.

Field	Type	Description
`countries`	string[] \| null	Required. ISO 3166-1 alpha-2 country codes, such as GB or DE. At least 1 entry.

Output

data is an array of rows, one per result. Each row has:

Field	Type	Description
`shelf`	string	The shelf's title as the page shows it, or for charts its kind: charts, trending_songs, popular_artists or popular_albums.
`shelfUri`	string \| null	The shelf's spotify:section: URI. May be absent.
`country`	string \| null	The country a charts row is for. May be absent.
`type`	string	track, artist, album, playlist, podcast, episode, audiobook, user, genre or author; browse shelves also list category.
`position`	integer	The result's rank within its type, from 1.
`id`	string	The result's Spotify id.
`uri`	string	—
`url`	string	The result's open.spotify.com page.
`name`	string	—
`artists`	object[] \| null	A track's or album's artists. May be absent.
`artists[].id`	string	The entity's Spotify id.
`artists[].uri`	string	The entity's spotify: URI, such as spotify:artist:2Z9KL8Zmqx5Sg3cd7Fldhl.
`artists[].url`	string	The entity's open.spotify.com page.
`artists[].name`	string	—
`album`	object \| null	The release a track is on. May be absent.
`album.id`	string	The entity's Spotify id.
`album.uri`	string	The entity's spotify: URI, such as spotify:artist:2Z9KL8Zmqx5Sg3cd7Fldhl.
`album.url`	string	The entity's open.spotify.com page.
`album.name`	string	—
`albumType`	string \| null	An album's type: ALBUM, SINGLE, EP or COMPILATION. May be absent.
`releaseDate`	string \| null	An album's or episode's release date, as precise as Spotify states it. May be absent.
`durationMs`	integer \| null	A track's or episode's length. May be absent.
`explicit`	boolean \| null	Whether a track or episode is marked explicit. May be absent.
`verified`	boolean \| null	Whether an artist is verified. May be absent.
`owner`	object \| null	A playlist's owner. May be absent.
`owner.id`	string	The entity's Spotify id.
`owner.uri`	string	The entity's spotify: URI, such as spotify:artist:2Z9KL8Zmqx5Sg3cd7Fldhl.
`owner.url`	string	The entity's open.spotify.com page.
`owner.name`	string	—
`description`	string \| null	A playlist's, episode's or audiobook's description, or an author's biography, as plain text. May be absent.
`publisher`	string \| null	A podcast's publisher. May be absent.
`show`	object \| null	The podcast an episode belongs to. May be absent.
`show.id`	string	The entity's Spotify id.
`show.uri`	string	The entity's spotify: URI, such as spotify:artist:2Z9KL8Zmqx5Sg3cd7Fldhl.
`show.url`	string	The entity's open.spotify.com page.
`show.name`	string	—
`authors`	string[] \| null	An audiobook's authors. May be absent.
`imageUrl`	string \| null	The result's largest image: cover art, avatar or playlist image.

Example

curl https://request.usestring.ai/v1/integrations/spotify/charts \
  -H "Authorization: Bearer $STRING_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "countries": ["GB"]
  }'

data starts with these rows:

[
  {
    "shelf": "charts",
    "country": "GB",
    "type": "playlist",
    "position": 1,
    "id": "37i9dQZEVXbMwmF30ppw50",
    "uri": "spotify:playlist:37i9dQZEVXbMwmF30ppw50",
    "url": "https://open.spotify.com/playlist/37i9dQZEVXbMwmF30ppw50",
    "name": "Top Songs - United Kingdom",
    "owner": {
      "id": "spotify",
      "uri": "spotify:user:spotify",
      "url": "https://open.spotify.com/user/spotify",
      "name": "Spotify"
    },
    "description": "Your weekly update of the most played tracks right now - United Kingdom.",
    "imageUrl": "https://charts-images.scdn.co/assets/locale_en/regional/weekly/region_gb_default.jpg"
  },
  {
    "shelf": "charts",
    "country": "GB",
    "type": "playlist",
    "position": 2,
    "id": "37i9dQZEVXbLnolsZ8PSNw",
    "uri": "spotify:playlist:37i9dQZEVXbLnolsZ8PSNw",
    "url": "https://open.spotify.com/playlist/37i9dQZEVXbLnolsZ8PSNw",
    "name": "Top 50 - United Kingdom",
    "owner": {
      "id": "spotify",
      "uri": "spotify:user:spotify",
      "url": "https://open.spotify.com/user/spotify",
      "name": "Spotify"
    },
    "description": "Your daily update of the most played tracks right now - United Kingdom.",
    "imageUrl": "https://charts-images.scdn.co/assets/locale_en/regional/daily/region_gb_default.jpg"
  },
  {
    "shelf": "charts",
    "country": "GB",
    "type": "playlist",
    "position": 3,
    "id": "37i9dQZEVXbNG2KDcFcKOF",
    "uri": "spotify:playlist:37i9dQZEVXbNG2KDcFcKOF",
    "url": "https://open.spotify.com/playlist/37i9dQZEVXbNG2KDcFcKOF",
    "name": "Top Songs - Global",
    "owner": {
      "id": "spotify",
      "uri": "spotify:user:spotify",
      "url": "https://open.spotify.com/user/spotify",
      "name": "Spotify"
    },
    "description": "Your weekly update of the most played tracks right now - Global.",
    "imageUrl": "https://charts-images.scdn.co/assets/locale_en/regional/weekly/region_global_default.jpg"
  }
]

Requests and billing

Requests: 4 Web Access requests per entry in items, plus up to 1 setup request per call.
Billing: passthrough. Each request the action makes bills at its own rate on your plan; there is no separate charge for the action. See Pricing.

On this page