Spotify Track Search API. Tracks matching your search.

Tracks by keyword, artist or ISRC. We handle the proxies, blocks and platform changes.

Searches Spotify tracks by keyword, artist or ISRC, in any language, and returns them a page at a time in Spotify's order. Each has its title, credited artists with their IDs, album, exact length, cover, explicit flag, music video count and a preview clip. Set kind=episode to search podcast episodes instead. The Spotify Track API adds plays, release date, ISRC, label and credits.

GET /v1/spotify/search_tracks

Read the API reference

1 credit per page, $0.75–$1.97 per 1,000 pages
22 typed fields null when unknown
100 tracks per page, Spotify's own ranking for the query
query is all it needs, e.g. rick astley

Send one request. Get up to 100 tracks back.

Copy the request in your language, or hand it to your agent. Sign up for an API key and your first 100 credits are free.

$ npm install socialtap

query = rick astley

Open in playground

GET /v1/spotify/search_tracksTry in

const params = new URLSearchParams({
  kind: "track",
  query: "rick astley",
});
const res = await fetch(`https://socialtap.dev/v1/spotify/search_tracks?${params}`, {
  headers: { "x-api-key": process.env.SOCIALTAP_API_KEY ?? "" },
});
const body = await res.json();
if (!res.ok) throw new Error(`${body.error.code}: ${body.error.message}`);
const { data, page, meta } = body;
console.log(data, meta.credits_charged);

import os

import requests

res = requests.get(
    "https://socialtap.dev/v1/spotify/search_tracks",
    params={"kind": "track", "query": "rick astley"},
    headers={"x-api-key": os.environ["SOCIALTAP_API_KEY"]},
)
body = res.json()
if not res.ok:
    raise RuntimeError(f"{body['error']['code']}: {body['error']['message']}")
data, page, meta = body["data"], body["page"], body["meta"]
print(data, meta["credits_charged"])

require "json"
require "net/http"

uri = URI("https://socialtap.dev/v1/spotify/search_tracks")
uri.query = URI.encode_www_form('kind' => 'track', 'query' => 'rick astley')
req = Net::HTTP::Get.new(uri)
req["x-api-key"] = ENV.fetch("SOCIALTAP_API_KEY")
res = Net::HTTP.start(uri.host, uri.port, use_ssl: uri.scheme == "https") { |http| http.request(req) }
body = JSON.parse(res.body)
raise "#{body["error"]["code"]}: #{body["error"]["message"]}" unless res.is_a?(Net::HTTPSuccess)
pp body["data"]
puts body["meta"]["credits_charged"]

<?php

$query = http_build_query([
    'kind' => 'track',
    'query' => 'rick astley',
]);
$ch = curl_init('https://socialtap.dev/v1/spotify/search_tracks?' . $query);
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => ['x-api-key: ' . getenv('SOCIALTAP_API_KEY')],
]);
$body = json_decode(curl_exec($ch), true);
if (curl_getinfo($ch, CURLINFO_RESPONSE_CODE) >= 400) {
    throw new RuntimeException($body['error']['code'] . ': ' . $body['error']['message']);
}
print_r($body['data']);
echo $body['meta']['credits_charged'], PHP_EOL;

package main

import (
	"encoding/json"
	"fmt"
	"log"
	"net/http"
	"net/url"
	"os"
)

func main() {
	q := url.Values{}
	q.Set("kind", "track")
	q.Set("query", "rick astley")
	req, err := http.NewRequest("GET", "https://socialtap.dev/v1/spotify/search_tracks?"+q.Encode(), nil)
	if err != nil {
		log.Fatal(err)
	}
	req.Header.Set("x-api-key", os.Getenv("SOCIALTAP_API_KEY"))
	res, err := http.DefaultClient.Do(req)
	if err != nil {
		log.Fatal(err)
	}
	defer res.Body.Close()
	var body struct {
		Data  json.RawMessage `json:"data"`
		Page  json.RawMessage `json:"page"`
		Meta  map[string]any  `json:"meta"`
		Error *struct {
			Code    string `json:"code"`
			Message string `json:"message"`
		} `json:"error"`
	}
	if err := json.NewDecoder(res.Body).Decode(&body); err != nil {
		log.Fatal(err)
	}
	if body.Error != nil {
		log.Fatalf("%s: %s", body.Error.Code, body.Error.Message)
	}
	fmt.Println(string(body.Data), body.Meta["credits_charged"])
}

curl -G 'https://socialtap.dev/v1/spotify/search_tracks' \
  --data-urlencode 'kind=track' \
  --data-urlencode 'query=rick astley' \
  -H "x-api-key: $SOCIALTAP_API_KEY"

{
  "data": [
    {
      "approximate_fields": [],
      "author": {
        "avatar_url": null,
        "display_name": "Rick Astley",
        "id": "0gxyHStUsqpMadRV0Di1Qt",
        "is_verified": null,
        "url": "https://open.spotify.com/artist/0gxyHStUsqpMadRV0Di1Qt",
        "username": null
      },
      "coauthors": [],
      "duration_ms": 213573,
      "hashtags": [],
      "id": "4PTG3Z6ehGkBFwjybzWkR8",
      "is_nsfw": null,
      "is_pinned": null,
      "is_sponsored": null,
      "language": null,
      "media": [
        {
          "alt_text": null,
          "duration_ms": null,
          "expires_at": null,
          "height": null,
          "thumbnail_url": "https://i.scdn.co/image/ab67616d0000b27315ebbedaacef61af244262a8",
          "type": "audio",
          "url": "https://p.scdn.co/mp3-preview/b4c682084c3fd05538726d0a126b7e14b6e92c83",
          "width": null
        }
      ],
      "mentions": [],
      "metrics": {
        "comment_count": null,
        "like_count": null,
        "quote_count": null,
        "repost_count": null,
        "save_count": null,
        "share_count": null,
        "view_count": null
      },
      "platform": "spotify",
      "platform_specific": {
        "spotify": {
          "added_at": null,
          "added_by": null,
          "album_id": "6eUW0wxWtzkFdaEFsTJto6",
          "album_title": "Whenever You Need Somebody",
          "album_track_count": null,
          "album_type": null,
          "album_url": "https://open.spotify.com/album/6eUW0wxWtzkFdaEFsTJto6",
          "bpm": null,
          "camelot_key": null,
          "canonical_track_id": null,
          "copyrights": [],
          "credits": [],
          "disc_number": null,
          "is_explicit": false,
          "is_paywalled": null,
          "is_playable": true,
          "isrc": null,
          "label": null,
          "languages": [],
          "music_video_count": 1,
          "musical_key": null,
          "playability_reason": "playable",
          "podcast_id": null,
          "popularity": null,
          "release_date_precision": null,
          "track_number": null
        }
      },
      "platform_type": "track",
      "published_at": null,
      "text": null,
      "thumbnail_url": "https://i.scdn.co/image/ab67616d0000b27315ebbedaacef61af244262a8",
      "title": "Never Gonna Give You Up",
      "type": "audio",
      "unknown_fields": [
        "platform_specific.spotify.copyrights",
        "platform_specific.spotify.credits",
        "platform_specific.spotify.languages"
      ],
      "url": "https://open.spotify.com/track/4PTG3Z6ehGkBFwjybzWkR8"
    },
    {
      "approximate_fields": [],
      "author": {
        "avatar_url": null,
        "display_name": "Rick Astley",
        "id": "0gxyHStUsqpMadRV0Di1Qt",
        "is_verified": null,
        "url": "https://open.spotify.com/artist/0gxyHStUsqpMadRV0Di1Qt",
        "username": null
      },
      "coauthors": [],
      "duration_ms": 205533,
      "hashtags": [],
      "id": "00isIFJWVpXIQ8HkGICSQp",
      "is_nsfw": null,
      "is_pinned": null,
      "is_sponsored": null,
      "language": null,
      "media": [
        {
          "alt_text": null,
          "duration_ms": null,
          "expires_at": null,
          "height": null,
          "thumbnail_url": "https://i.scdn.co/image/ab67616d0000b27315ebbedaacef61af244262a8",
          "type": "audio",
          "url": "https://p.scdn.co/mp3-preview/218ce9bda2e7ad945f675c8f3cb48cd94b8718fa",
          "width": null
        }
      ],
      "mentions": [],
      "metrics": {
        "comment_count": null,
        "like_count": null,
        "quote_count": null,
        "repost_count": null,
        "save_count": null,
        "share_count": null,
        "view_count": null
      },
      "platform": "spotify",
      "platform_specific": {
        "spotify": {
          "added_at": null,
          "added_by": null,
          "album_id": "6eUW0wxWtzkFdaEFsTJto6",
          "album_title": "Whenever You Need Somebody",
          "album_track_count": null,
          "album_type": null,
          "album_url": "https://open.spotify.com/album/6eUW0wxWtzkFdaEFsTJto6",
          "bpm": null,
          "camelot_key": null,
          "canonical_track_id": null,
          "copyrights": [],
          "credits": [],
          "disc_number": null,
          "is_explicit": false,
          "is_paywalled": null,
          "is_playable": true,
          "isrc": null,
          "label": null,
          "languages": [],
          "music_video_count": 1,
          "musical_key": null,
          "playability_reason": "playable",
          "podcast_id": null,
          "popularity": null,
          "release_date_precision": null,
          "track_number": null
        }
      },
      "platform_type": "track",
      "published_at": null,
      "text": null,
      "thumbnail_url": "https://i.scdn.co/image/ab67616d0000b27315ebbedaacef61af244262a8",
      "title": "Together Forever",
      "type": "audio",
      "unknown_fields": [
        "platform_specific.spotify.copyrights",
        "platform_specific.spotify.credits",
        "platform_specific.spotify.languages"
      ],
      "url": "https://open.spotify.com/track/00isIFJWVpXIQ8HkGICSQp"
    },
    {
      "approximate_fields": [],
      "author": {
        "avatar_url": null,
        "display_name": "Rick Astley",
        "id": "0gxyHStUsqpMadRV0Di1Qt",
        "is_verified": null,
        "url": "https://open.spotify.com/artist/0gxyHStUsqpMadRV0Di1Qt",
        "username": null
      },
      "coauthors": [],
      "duration_ms": 213560,
      "hashtags": [],
      "id": "0yNttAVwMr39qyODHNIkrY",
      "is_nsfw": null,
      "is_pinned": null,
      "is_sponsored": null,
      "language": null,
      "media": [
        {
          "alt_text": null,
          "duration_ms": null,
          "expires_at": null,
          "height": null,
          "thumbnail_url": "https://i.scdn.co/image/ab67616d0000b2733a67639779ccabd632e1a80e",
          "type": "audio",
          "url": "https://p.scdn.co/mp3-preview/40a780b231e5ed130483bec7917b6c9a4f8a4708",
          "width": null
        }
      ],
      "mentions": [],
      "metrics": {
        "comment_count": null,
        "like_count": null,
        "quote_count": null,
        "repost_count": null,
        "save_count": null,
        "share_count": null,
        "view_count": null
      },
      "platform": "spotify",
      "platform_specific": {
        "spotify": {
          "added_at": null,
          "added_by": null,
          "album_id": "4C4LvbYS0pxXLW5sGD9EK5",
          "album_title": "Whenever You Need Somebody (Deluxe Edition - 2022 Remaster)",
          "album_track_count": null,
          "album_type": null,
          "album_url": "https://open.spotify.com/album/4C4LvbYS0pxXLW5sGD9EK5",
          "bpm": null,
          "camelot_key": null,
          "canonical_track_id": null,
          "copyrights": [],
          "credits": [],
          "disc_number": null,
          "is_explicit": false,
          "is_paywalled": null,
          "is_playable": true,
          "isrc": null,
          "label": null,
          "languages": [],
          "music_video_count": 1,
          "musical_key": null,
          "playability_reason": "playable",
          "podcast_id": null,
          "popularity": null,
          "release_date_precision": null,
          "track_number": null
        }
      },
      "platform_type": "track",
      "published_at": null,
      "text": null,
      "thumbnail_url": "https://i.scdn.co/image/ab67616d0000b2733a67639779ccabd632e1a80e",
      "title": "Never Gonna Give You Up - 2022 Remaster",
      "type": "audio",
      "unknown_fields": [
        "platform_specific.spotify.copyrights",
        "platform_specific.spotify.credits",
        "platform_specific.spotify.languages"
      ],
      "url": "https://open.spotify.com/track/0yNttAVwMr39qyODHNIkrY"
    }
  ],
  "page": {
    "has_more": true,
    "next_cursor": "c1.EXAMPLE_CURSOR",
    "next_cursor_expires_at": "2026-10-26T12:00:00Z",
    "end_reason": null
  },
  "meta": {
    "request_id": "req_3f9c2a7d1e8b4c6a9f0e2d4b6a8c0e1f",
    "platform": "spotify",
    "source": "api",
    "is_cached": false,
    "credits_charged": 1,
    "latency_ms": 816,
    "fetched_at": "2026-10-25T12:00:00Z",
    "input": null,
    "credits_remaining": 9999,
    "client_request_id": null,
    "warnings": []
  }
}

import { SocialTap } from "socialtap";

const client = new SocialTap(); // apiKey defaults to process.env.SOCIALTAP_API_KEY

const res = await client.spotify.searchTracks.list({ query: "rick astley", kind: "track" });
console.log(res.data);
console.log(res.credits.charged, res.meta.request_id);

import java.net.URI;
import java.net.URLEncoder;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.nio.charset.StandardCharsets;

public class Main {
    public static void main(String[] args) throws Exception {
        String query = "kind=" + encode("track")
            + "&query=" + encode("rick astley");
        HttpRequest request = HttpRequest.newBuilder()
            .uri(URI.create("https://socialtap.dev/v1/spotify/search_tracks?" + query))
            .header("x-api-key", System.getenv("SOCIALTAP_API_KEY"))
            .GET()
            .build();
        HttpResponse<String> response = HttpClient.newHttpClient()
            .send(request, HttpResponse.BodyHandlers.ofString());
        // An error is {"error": {"code", "message", ...}}; success is {data, meta}, meta.credits_charged its price.
        if (response.statusCode() >= 400) throw new RuntimeException(response.body());
        System.out.println(response.body());
    }

    static String encode(String value) {
        return URLEncoder.encode(value, StandardCharsets.UTF_8);
    }
}

using System.Text.Json;

using var http = new HttpClient();
http.DefaultRequestHeaders.Add("x-api-key", Environment.GetEnvironmentVariable("SOCIALTAP_API_KEY"));

var query = string.Join("&",
    "kind=" + Uri.EscapeDataString("track"),
    "query=" + Uri.EscapeDataString("rick astley"));
var res = await http.GetAsync("https://socialtap.dev/v1/spotify/search_tracks?" + query);
using var body = JsonDocument.Parse(await res.Content.ReadAsStringAsync());
if (!res.IsSuccessStatusCode)
{
    var error = body.RootElement.GetProperty("error");
    throw new Exception($"{error.GetProperty("code")}: {error.GetProperty("message")}");
}
Console.WriteLine(body.RootElement.GetProperty("data"));
Console.WriteLine(body.RootElement.GetProperty("meta").GetProperty("credits_charged"));

// Cargo.toml: reqwest = { version = "0.12", features = ["blocking", "json"] }, serde_json = "1"
use std::env;

fn main() -> Result<(), Box<dyn std::error::Error>> {
    let res = reqwest::blocking::Client::new()
        .get("https://socialtap.dev/v1/spotify/search_tracks")
        .query(&[("kind", "track"), ("query", "rick astley")])
        .header("x-api-key", env::var("SOCIALTAP_API_KEY")?)
        .send()?;
    let ok = res.status().is_success();
    let body: serde_json::Value = res.json()?;
    if !ok {
        return Err(format!("{}: {}", body["error"]["code"], body["error"]["message"]).into());
    }
    println!("{} {}", body["data"], body["meta"]["credits_charged"]);
    Ok(())
}

200 OK · GET https://socialtap.dev/v1/spotify/search_tracksLong arrays and strings are shortened here. Real responses are complete.Docs

One schema on 21 platforms.

The response reference lists every field, its type and when it is null. See the full schema.

Null means unknown
A field Spotify doesn't show is null, never zero or an empty string, so a real zero always means zero.
What it accepts
What to search for, as in Spotify's search box: a title, an artist or both, in any language.
Write one parser
Spotify, TikTok, Instagram and 18 more platforms answer in these fields, so the code that reads one reads them all.

platformstring: Platform ID (tiktok, youtube, …).
idstring: Platform-native post ID (string; Instagram shortcode, Reddit with its t3_ prefix).
urlstring: Canonical post URL.
typestring: Normalized content shape. New values may be added; treat unknown values as other.
platform_typestring: The platform's own product label, lowercase (reel, short, story, live, tweet, …).
titlestring: Headline (YouTube title, Reddit title); null on caption-only platforms.
textstring: Caption, description or body as plain text.
languagestring: BCP-47 language of text, when the platform states it.

What teams build with the Spotify Track Search API.

Turn title and artist into a track ID
Find a recording's tracks by ISRC
Build a music search box with previews
Find podcast episodes that mention a guest

Good to know before you build.

Results are one kind: tracks, or podcast episodes with kind=episode. For artists, albums, playlists and podcasts, send the same query to their search endpoints.
An episode is a post of platform_type episode, as the Spotify Podcast Episodes API lists it, with its description, exact release time, length and preview. author is its show, by name and cover only, and platform_specific.spotify.podcast_id the show's ID.
Search lists no play count, release date, ISRC, label or credits, so those are null or empty: the Spotify Track API returns them.
Results are in Spotify's order, which depends on the page size, so a smaller limit isn't always the top of a larger one. A walk ends with page.end_reason platform_limit where Spotify stops serving, however many tracks it matched.
Spotify repeats about a third of each page on the next. Repeats are dropped, so a page usually holds fewer tracks than its limit while next_cursor goes on.
Spotify answers a weak query with its nearest guesses, so an empty page is rare and any result may be a loose match.
is_playable says whether Spotify plays the track in the country we request from, which may not be yours.
When Spotify's search doesn't answer, the first pages come from a web search engine's index, each track read from Spotify, with a partial_data warning, Spotify's filters are read as plain words, and a music video reads as audio. That list holds only what the index has, often a small part of Spotify's, in the engine's order. A next_cursor stays on the list it came from: if Spotify's search stops answering mid-walk, the next page fails with a retryable error instead of switching lists.
An empty query, a Spotify URI or a link to a Spotify page returns invalid_input, naming the endpoint that takes it where there is one. For a link to Spotify's search page, send its words instead.

1 credit per page. Failed requests are free.

Buy credits once and spend them on any endpoint, on any platform.

Plans and packs How this endpoint is priced How credits work

Source	Price per successful page	Per 1,000 pages
Any source	1 credit	$0.75–$1.97

Cache hits are free.
Credits from packs and top-ups never expire.
A monthly plan's credits are spent first, and what is left of them ends at each renewal.
Prices exclude tax: sales tax is added at checkout where it applies.
Outside the US, plans and packs are sold to businesses: checkout asks for your VAT, GST or other business tax ID.

Questions about the Spotify Track Search API.

Try it with your own search.

Type it in the playground, or copy the request into your code.

free credits

No credit card
Failed requests are free
Works on all 218 endpoints

Start for free Read the docs

Spotify Track Search API. Tracks matching your search.

Spotify Track Search API at a glance

Send one request. Get up to 100 tracks back.

One schema on 21 platforms.

Null means unknown

What it accepts

Write one parser

What teams build with the Spotify Track Search API.

Turn title and artist into a track ID

Find a recording's tracks by ISRC

Build a music search box with previews

Find podcast episodes that mention a guest

Good to know before you build.

1 credit per page. Failed requests are free.

Questions about the Spotify Track Search API.

Posts on 20 more platforms.

Spotify API. 12 endpoints, one key.

Try it with your own search.