API Reference

Search keywords

get
https://api.artist.tools/v2/keywords/search

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

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.

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).

Responses

Updated 29 days ago

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

Updated 29 days ago