Concerts · GET

Search concerts by artist name

GET /partner/search-concert-artists

About

Resolve an artist by free-text name and return their upcoming concerts in one call — useful when you don't know the Spotify artist ID. `limit > 1` returns concerts for the top N matched artists (handy for ambiguous names).

Parameters 7

query Required
In
query
Default
—
Description
Artist name to search.
geoHash Optional
In
query
Default
0
includeNearby Optional
In
query
Default
true
limit Optional
In
query
Default
1
Description
Number of artist matches to return concerts for.
details Optional
In
query
Default
false
Description
Enrich each concert with full concert details in parallel.
detailsLimit Optional
In
query
Default
20
Description
Max concerts to enrich per request (max 50).
parsed Optional
In
query
Default
false
Description
Return a flat, normalized concert shape instead of raw GraphQL.

Request

Against https://spotify-proxy.checkleaked.cc, with the same example values the Run button sends.

Sample response

Live only

This endpoint has no recorded sample. Press Run to fetch a real response.

Errors

400
“query” is required — a request that omits it, or sends a value of the wrong type, is rejected before it reaches Spotify.
401 / 403
The key is missing, wrong, or on a plan that does not include this endpoint. On RapidAPI the header is X-RapidAPI-Key; on the Direct Portal it is an Authorization: Bearer token; on Apify the actor supplies it.
429
Rate limited. The demo on this site allows 100 requests per 15 minutes and 500 per day per visitor, inside a budget shared by every visitor. With a key it is 5 requests per second on every RapidAPI plan and 10 per second on the Direct Portal.
5xx
Spotify itself failed or timed out. These are transient; retry once with a short backoff rather than immediately.

Related endpoints

The other 4 operations in the Concerts group.