Search keywords

Performs a keyword search across markets with optional filters for Google Ads volume and Spotify playlist performance. Results are paginated and sorted by follower growth + Google volume by default.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Query Params
string

Optional free-text keyword. If omitted, filters must be provided.

string
length between 2 and 2
^[a-z]{2}$

Filter results to a specific market.

boolean
Defaults to false

When true, only returns keywords that exactly match the normalized query string.

integer
≥ 1
Defaults to 1

1-indexed page number.

integer
1 to 100
Defaults to 10

Items per page (max 100). Alias: limit.

string

Mongo-style JSON-encoded sort object. Defaults to follower growth + Google volume. Every key and direction is preserved in order. The 36 spotify.playlistAge/playlistOwnership numeric paths may appear at any priority, including several together. Unknown metrics sort last at their key priority in either direction; missing volume DESC, keyword ASC, market ASC tie-breaks follow the entire supplied vector. Metric directions must be 1 or -1 (numeric strings are converted at the HTTP boundary). The complete sort, including appended tie-breaks and legacy availability keys, is limited to MongoDB's 32 keys; larger metric sorts return 400. Legacy-only sorting is unchanged; broad metric sorts may require a blocking database sort.

string

JSON object of advanced filters. Supports google.minVolume, google.maxVolume, google.minGrowth, google.maxGrowth, spotify.minFollowerReach, spotify.maxFollowerReach, spotify.minGenreFocus, spotify.maxGenreFocus, and spotify.genres (array). Also supports spotify.playlistAge and spotify.playlistOwnership, each keyed by top3, top10 or top50 and inclusive min/max bounds (for example maxMedianAgeDays, minKnownDateCount, maxSpotifyOwnedCount, minResultCount). Age fields: resultCount, knownDateCount, youngestAgeDays, p25AgeDays, medianAgeDays, meanAgeDays, p75AgeDays, oldestAgeDays. Ownership fields: resultCount, spotifyOwnedCount, spotifyLikelyGeneratedCount, spotifyWithFollowersCount. Counts are integers from 0 to the rank cap; days are finite nonnegative numbers and may be fractional. Numeric strings are converted. Invalid new bounds are 400 errors. Unknowns do not match bounds; zero is valid. Ages are days at spotify.lastSearchedAt. Owned counts are observed lower bounds, without an ownership coverage guarantee.

Responses

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