EveryData platform API
Spotify API
Spotify data here means Spotify profiles, artists, tracks, albums, playlists, podcasts, and search results, divided among 7 Spotify actions with explicit Spotify target objects: `profile`, `search`, `artist`.
Select `profile` to retrieve a single public record instead of searching matching results with `search`. Use `url` as the key selector instead of `keyword`.
- Endpoint
- POST /api/v1/social
- Capabilities
- 7
- Per 1,000
- $1.389
Available capabilities
Compare the Spotify actions by required input, returned data, and price. Use the action identifier exactly as shown in your request.
| Action | Required | Optional | Delivery | Limit | Per 1,000 | Response fields |
|---|---|---|---|---|---|---|
profileDetails Retrieve public track or album metadata from Spotify. Accepts these parameters: | url | — | Sync delivery | — | $1.39 per 1,000 requests | id · url · name · type · release_date · label · artists · image_url · track_count · tracks · platform · duration_ms · play_count · track_number |
searchSearch Search public results on Spotify. Accepts these parameters: | keyword | content_type | Sync delivery | Catalog values: defaultLimit=20, maxLimit=100. A limit can control pages or per-parent expansion for some actions, so it is not always a final row count. | $1.39 per 1,000 requests | id · url · type · name · text · artists · album_name · owner_name · publisher · image_url · duration_ms · play_count · follower_count · monthly_listener_count · track_count · episode_count · release_date · is_explicit · preview_url · rank · platform |
artistArtist details Retrieve public artist details from Spotify. Accepts these parameters: | url | — | Sync delivery | — | $1.39 per 1,000 requests | id · url · name · bio · monthly_listener_count · follower_count · world_rank · genres · image_url · header_image_url · album_count · single_count · compilation_count · top_cities · top_tracks · related_artists · platform · city · country · region · listener_count |
trackTrack Retrieve a public track from Spotify. Accepts these parameters: | url | — | Sync delivery | — | $1.39 per 1,000 requests | album_id · album_type · label · content_rating |
albumAlbum Retrieve a public album from Spotify. Accepts these parameters: | url | — | Sync delivery | — | $1.39 per 1,000 requests | id · url · name · album_type · artists · release_date · label · copyright · track_count · image_url · tracks · platform |
playlistPlaylist Retrieve a public playlist from Spotify. Accepts these parameters: | url | — | Sync delivery | — | $1.39 per 1,000 requests | id · url · name · text · owner_name · save_count · follower_count · track_count · image_url · tracks · platform |
podcastPodcast Search for podcasts on Spotify. Accepts these parameters: | keyword | content_type | Sync delivery | Catalog values: defaultLimit=20, maxLimit=100. A limit can control pages or per-parent expansion for some actions, so it is not always a final row count. | $1.39 per 1,000 requests | id · url · type · name · text · artists · album_name · owner_name · publisher · image_url · duration_ms · play_count · follower_count · monthly_listener_count · track_count · episode_count · release_date · is_explicit · preview_url · rank · platform |
What does each Spotify action accept?
Each answer below pairs one callable action with its real inputs. Parameter meanings and allowed values are action-specific; a familiar name does not carry the same meaning across every platform.
Official sources are linked only to clarify the platform term beside them. They do not imply platform authorization or endorsement, and they do not add official-site features to the EveryInfra API contract.
What do the Spotify profile parameters mean?
Retrieve public track or album metadata from Spotify. Accepts these parameters: url. Returns these fields: tracks, track_number, label, and duration_ms.
urlRequired- Specifies the target open.spotify.com link, spotify:type:ID URI, or raw entity ID corresponding to the chosen action (artist, track, album, or playlist). Input types must match the endpoint action and cannot be interchanged. Legacy profile endpoints accept full Spotify links to return album and single streaming metadata rather than user profile account details.Spotify: Resource URLs, URIs, and User Identifiers Cannot Be InterchangedOfficial Spotify documentation distinguishes resource URLs, URIs, IDs, and user identifiers. The legacy `profile` action only accepts full release history URLs; despite name similarity, it does not function as an official user profile endpoint, nor does it automatically parse URIs for other actions.Checked
What do the Spotify search parameters mean?
Search public results on Spotify. Accepts these parameters: keyword and content_type. Returns these fields: preview_url, is_explicit, artists, and owner_name.
keywordRequired- Specifies the search query for the search action, with target entities constrained by content_type. On the podcast action, this parameter searches overall podcast shows by default rather than looking up specific episode details.
content_typeOptional- Filters target catalog types. For search, allowed values are tracks, artists, albums, or playlists. The podcast endpoint accepts a separate value set, defaulting to podcasts_shows for shows or podcast_episodes_individual_episodes for single episodes. Overriding this field with non-default options like spoken word or audiobooks does not alter existing payload schemas or grant standalone platform capabilities.Allowed values:
albumsartistsplayliststracks
What do the Spotify artist parameters mean?
Retrieve public artist details from Spotify. Accepts these parameters: url. Returns these fields: album_count, bio, country, and monthly_listener_count.
urlRequired- Specifies the target open.spotify.com link, spotify:type:ID URI, or raw entity ID corresponding to the chosen action (artist, track, album, or playlist). Input types must match the endpoint action and cannot be interchanged. Legacy profile endpoints accept full Spotify links to return album and single streaming metadata rather than user profile account details.Spotify: Monthly Listeners vs. Monthly Active Listeners MetricsSpotify defines monthly listeners as unique listeners over the past 28 days across both active streams and algorithmic recommendations. Monthly active listeners represent only the active listening subset. The `monthly_listener_count` field on this page must not be interpreted as this active subset, play counts, or follower totals.Checked
What do the Spotify track parameters mean?
Retrieve a public track from Spotify. Accepts these parameters: url. Returns these fields: album_type, label, content_rating, and album_id.
urlRequired- Specifies the target open.spotify.com link, spotify:type:ID URI, or raw entity ID corresponding to the chosen action (artist, track, album, or playlist). Input types must match the endpoint action and cannot be interchanged. Legacy profile endpoints accept full Spotify links to return album and single streaming metadata rather than user profile account details.Spotify: Naked IDs Lack Explicit Resource TypesOfficial documentation notes that a raw Spotify ID does not explicitly declare its underlying resource type without invocation context, whereas URIs encode type information. Callers must align the selected action, URL path, and targeted ID type, as a raw string will not automatically convert across different resource types.CheckedSpotify: Tracks, Parent Albums, and Content Usage BoundariesOfficial Spotify track documentation separates `track` and `album` objects while detailing content attribution, download, and model training restrictions. Querying metadata via this endpoint does not provide full audio downloads or AI training permissions; official platform fields and `market` parameters are not automatically part of the endpoint contract.Checked
What do the Spotify album parameters mean?
Retrieve a public album from Spotify. Accepts these parameters: url. Returns these fields: release_date, album_type, track_count, and image_url.
urlRequired- Specifies the target open.spotify.com link, spotify:type:ID URI, or raw entity ID corresponding to the chosen action (artist, track, album, or playlist). Input types must match the endpoint action and cannot be interchanged. Legacy profile endpoints accept full Spotify links to return album and single streaming metadata rather than user profile account details.Spotify: Naked IDs Lack Explicit Resource TypesOfficial documentation notes that a raw Spotify ID does not explicitly declare its underlying resource type without invocation context, whereas URIs encode type information. Callers must align the selected action, URL path, and targeted ID type, as a raw string will not automatically convert across different resource types.Checked
What do the Spotify playlist parameters mean?
Retrieve a public playlist from Spotify. Accepts these parameters: url. Returns these fields: owner_name, text, save_count, and name.
urlRequired- Specifies the target open.spotify.com link, spotify:type:ID URI, or raw entity ID corresponding to the chosen action (artist, track, album, or playlist). Input types must match the endpoint action and cannot be interchanged. Legacy profile endpoints accept full Spotify links to return album and single streaming metadata rather than user profile account details.Spotify: Naked IDs Lack Explicit Resource TypesOfficial documentation notes that a raw Spotify ID does not explicitly declare its underlying resource type without invocation context, whereas URIs encode type information. Callers must align the selected action, URL path, and targeted ID type, as a raw string will not automatically convert across different resource types.Checked
What do the Spotify podcast parameters mean?
Search for podcasts on Spotify. Accepts these parameters: keyword and content_type. Returns these fields: name, artists, text, and release_date.
keywordRequired- Specifies the search query for the search action, with target entities constrained by content_type. On the podcast action, this parameter searches overall podcast shows by default rather than looking up specific episode details.
content_typeOptional- Filters target catalog types. For search, allowed values are tracks, artists, albums, or playlists. The podcast endpoint accepts a separate value set, defaulting to podcasts_shows for shows or podcast_episodes_individual_episodes for single episodes. Overriding this field with non-default options like spoken word or audiobooks does not alter existing payload schemas or grant standalone platform capabilities.Allowed values:
albums_full_releasesartists_musicians_bandsaudiobooks_spoken_word_booksplaylists_curated_collectionspodcast_episodes_individual_episodespodcasts_showssongs_individual_tracksSpotify: Podcast Shows vs. Episode ObjectsOfficial Spotify documentation organizes episodes under parent show pages and separates following a show from saving an episode. This structural reference explains resource hierarchy only and does not replicate Spotify app capabilities such as audio playback, offline downloads, or paid subscription access.Checked
How to use the Spotify API
- 01Read the public catalog and choose a platform action.
- 02Send the platform, action, and required parameters to POST /api/v1/social.
- 03Handle a synchronous result or poll the returned job ID when the selected action is asynchronous.
- 04Store the structured response fields needed by your application.
curl -X POST https://api.everyinfra.com/api/v1/social \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{"platform":"spotify","action":"profile","params":{"url":"<url>"}}'
Spotify API questions
What can I retrieve with the Spotify API?
Set platform to spotify. The current catalog lists details, search, artist details, track, album, and more. These action names identify different Spotify objects or views; they are not interchangeable search modes.
Which input starts a Spotify `profile` request?
Specifies the target open.spotify.com link, spotify:type:ID URI, or raw entity ID corresponding to the chosen action (artist, track, album, or playlist). Input types must match the endpoint action and cannot be interchanged. Legacy profile endpoints accept full Spotify links to return album and single streaming metadata rather than user profile account details. Send it as url inside params.
Which fields can Spotify `profile` return?
Its declared schema includes name, type, release_date, and label. A declared field can still be absent from an individual source record, and every other action has its own field list.
Does every Spotify action return immediately?
No assumption is needed: this page labels each action's delivery mode. The current catalog contains sync delivery; poll a returned job ID only for an action labeled asynchronous.