Platform availability
- 24h health
- Normal
Last 30 days
Available capabilities
Each Spotify action, what it does, its price and its health over the last 24 hours. Open an action for its parameters, response fields and code samples.
| Capability | What it does | Per 1,000 | 24-hour health |
|---|---|---|---|
Detailsprofile | Look up an album or single on Spotify from its full link to get the release type, date, record label, credited artists, cover and track list. | $1.39 per 1,000 requests | Normal |
Searchsearch | Search Spotify for tracks, artists, albums or playlists by keyword and get each match's name, type, artists and link, plus counts that fit the kind of result. | $1.39 per 1,000 requests | Normal |
Artist detailsartist | Read a Spotify artist's bio, genres, monthly listeners, followers and world rank, along with top tracks, top cities and related artists. | $1.39 per 1,000 requests | Normal |
Tracktrack | Get one Spotify track's artists, album, length, play count, track and disc number, release date, label and content rating. | $1.39 per 1,000 requests | Normal |
Albumalbum | Fetch a Spotify album's type, artists, release date, label, copyright line, cover art and full track list from its link, URI or ID. | $1.39 per 1,000 requests | Normal |
Playlistplaylist | Open a Spotify playlist to see its owner, description, saves, followers, track count and the tracks it holds. | $1.39 per 1,000 requests | Normal |
Podcastpodcast | Find Spotify podcast shows or single episodes by keyword, with publisher, episode count, duration and release date where they apply. | $1.39 per 1,000 requests | Normal |
Open a capability for its parameters, response fields, code samples and trial.
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.
| Action | Required | Optional | Delivery | Limit | Per 1,000 | Response fields |
|---|---|---|---|---|---|---|
profileDetails Look up an album or single on Spotify from its full link to get the release type, date, record label, credited artists, cover and track list. This older entry point reads releases rather than user profiles, and it plays no audio. | url | — | Sync delivery | — | $1.39 per 1,000 requests | id · url · name · type · release_date · label · artists · image_url · track_count · tracks · platform |
searchSearch Search Spotify for tracks, artists, albums or playlists by keyword and get each match's name, type, artists and link, plus counts that fit the kind of result. Set the kind with | 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 Read a Spotify artist's bio, genres, monthly listeners, followers and world rank, along with top tracks, top cities and related artists. Pass an artist link, a spotify:artist: URI or the bare ID; the numbers are a point-in-time snapshot, not revenue or a history. | 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 |
trackTrack Get one Spotify track's artists, album, length, play count, track and disc number, release date, label and content rating. | url | — | Sync delivery | — | $1.39 per 1,000 requests | id · url · name · artists · album_name · duration_ms · play_count · track_number · disc_number · is_explicit · release_date · preview_url · image_url · added_at · platform · album_id · album_type · label · content_rating |
albumAlbum Fetch a Spotify album's type, artists, release date, label, copyright line, cover art and full track list from its link, URI or ID. Nothing is played back, and regional editions of the same record are not guaranteed to match. | 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 Open a Spotify playlist to see its owner, description, saves, followers, track count and the tracks it holds. The playlist is left unchanged, individual followers are not named, and tracks are not guaranteed to still be available. | 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 Find Spotify podcast shows or single episodes by keyword, with publisher, episode count, duration and release date where they apply. Set | 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 do the Spotify profile parameters mean?
Look up an album or single on Spotify from its full link to get the release type, date, record label, credited artists, cover and track list. This older entry point reads releases rather than user profiles, and it plays no audio.
Full API reference: parameters, code samples, response example and health →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 Interchanged — Official 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 Spotify for tracks, artists, albums or playlists by keyword and get each match's name, type, artists and link, plus counts that fit the kind of result. Set the kind with content_type; results are not guaranteed to match across regions and do not show popularity over time.
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 action takes its own values: podcasts_shows (default) for shows or podcast_episodes_individual_episodes for single episodes. Values from one action cannot be used in the other.Allowed values:
albumsartistsplayliststracks
What do the Spotify artist parameters mean?
Read a Spotify artist's bio, genres, monthly listeners, followers and world rank, along with top tracks, top cities and related artists. Pass an artist link, a spotify:artist: URI or the bare ID; the numbers are a point-in-time snapshot, not revenue or a history.
Full API reference: parameters, code samples, response example and health →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 Metrics — Spotify 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?
Get one Spotify track's artists, album, length, play count, track and disc number, release date, label and content rating. duration_ms is in milliseconds, and the response carries no audio file and does not confirm territorial rights.
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 Types — Official 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 Boundaries — Official 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?
Fetch a Spotify album's type, artists, release date, label, copyright line, cover art and full track list from its link, URI or ID. Nothing is played back, and regional editions of the same record are not guaranteed to match.
Full API reference: parameters, code samples, response example and health →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 Types — Official 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?
Open a Spotify playlist to see its owner, description, saves, followers, track count and the tracks it holds. The playlist is left unchanged, individual followers are not named, and tracks are not guaranteed to still be available.
Full API reference: parameters, code samples, response example and health →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 Types — Official 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?
Find Spotify podcast shows or single episodes by keyword, with publisher, episode count, duration and release date where they apply. Set content_type to podcast_episodes_individual_episodes for episodes instead of shows, and keep each row's type to tell them apart; no audio is downloaded.
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 action takes its own values: podcasts_shows (default) for shows or podcast_episodes_individual_episodes for single episodes. Values from one action cannot be used in the other.Allowed values:
podcast_episodes_individual_episodespodcasts_showsSpotify: Podcast Shows vs. Episode Objects — Official 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 action runs asynchronously.
- 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.
Does Spotify have an official API?
Yes. Spotify's Web API provides catalog metadata and data for users who authorize your app. New apps start in Development Mode (a Premium owner, up to five users and a reduced set of endpoints), and extended access is granted only to registered organizations with a launched service and at least 250,000 monthly active users.
Official sources: Spotify Web API: quota modes · Spotify: update on developer access and platform security · Checked
Do I need a Spotify developer account or API key?
No. Requests go through EveryInfra with an EveryInfra API key: sign up, create a key in the console and send it as Authorization: Bearer <API_KEY>. You do not register a Spotify developer app, apply for Spotify API access or sign in with a Spotify account, and the actions return public Spotify data only.
How much does the Spotify API cost per 1,000 requests?
$1.39 per 1,000 requests, depending on the action; each action's price is listed in the table on this page and in the public catalog. There is no subscription: you top up a USD balance and pay per call, and failed calls and empty results are not charged.
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 record, and every other action has its own field list.
Does every Spotify action return immediately?
Actions labeled asynchronous return a job ID you poll. Every other action can also run asynchronously: add "mode": "async" to the request body to receive a job ID immediately, useful for slow tasks or large limits. The current catalog contains sync delivery.