Search top results

Find top artist, track, playlist, and user matches for a query. Returns basic identity and display data in source order, without enriched metrics. Types filter the mixed candidate results after retrieval, so fewer items than the limit may be returned, including none. Generated mixes and unsupported entity types are excluded. There is no pagination, total count, or exhaustive per-type search. Regional context is best effort and may differ when a fallback connection is used. Use playlist search for filtering stored playlist data and keyword search for stored keyword research.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Query Params
string
required
length between 1 and 200

Search text. Leading and trailing whitespace is removed; blank values are rejected.

string
^[a-zA-Z]{2}$
Defaults to us

Supported two-letter regional context, using the keyword autocomplete market allowlist. Case-insensitive and returned in lowercase. Unsupported codes are rejected. Requested context does not guarantee regional ranking.

integer
1 to 50
Defaults to 10

Maximum mixed candidate count requested before type filtering. Returned items never exceed this limit.

types
array of strings
length ≥ 1
Defaults to artist,track,playlist,user

Comma-separated entity types. Case and whitespace are normalized; duplicates are removed. Empty or unsupported types are rejected. This filters mixed results rather than searching separately for each type.

types
Allowed:
Responses

Language
Credentials
Header
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json