Get a curator's Google Rankings

get

https://api.artist.tools/v2/curators/{id}/google-rankings

Returns Google queries for which this curator has been observed ranking in a supported market. Each row includes lifecycle status, current and previous position, movement, ranked URL, keyword demand, estimated traffic, and up to 30 distinct daily observations. Filters apply before the exact summary and pagination totals are calculated. Data missing or at least seven days old is refreshed automatically; if refresh fails, existing stored data is returned with freshness.stale=true, while an entity with no stored dataset returns HTTP 503. These estimates are not Google Search Console analytics.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Path Params

string

required

Spotify User ID of a curator

Query Params

string

length ≤ 300

Case-insensitive keyword search.

market

string

enum

Google ranking market. Omit to include every supported market.

Allowed:

status

string

enum

Defaults to all

Lifecycle filter. active rows still rank in the latest stored dataset; lost rows no longer rank and therefore return currentPosition=null while retaining lastKnownPosition.

Allowed:

sortBy

string

enum

Defaults to position

Primary sort field. position uses lastKnownPosition so active and lost rows remain sortable; stable market, keyword, and URL tie-breakers prevent rows moving unpredictably between pages.

Allowed:

sortDirection

string

enum

Sort direction. Google and playlist ranking endpoints default to asc; Press Mentions defaults to desc.

Allowed:

page

integer

≥ 1

Defaults to 1

One-based result page. Invalid values return HTTP 400.

limit

integer

1 to 100

Defaults to 25

Primary rows per page. Invalid values are rejected rather than clamped.

Responses

200Filtered Google Rankings with exact pre-pagination summary totals.

400Client error

404Resource not found

503No stored dataset was available and an automatic SEO refresh failed.