API Reference

Get multiple keyword insights

post
https://api.artist.tools/v2/keywords/multiple

Read-only bulk keyword lookup. This endpoint only reads existing keyword records from the database; it does not ingest missing keywords, refresh Spotify data, or update Google data. The request is rejected if more than 50 keyword items are provided. Missing keywords or invalid per-keyword inputs are returned as status: false items with an error object in place of keyword insight data. To ingest or refresh a missing keyword, call the single keyword endpoint: GET /v2/keywords/{keyword}?market={market}.

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

JSON body for read-only bulk keyword insight lookup.

string
length between 2 and 2
Defaults to us

Default market for string keyword entries and object entries without their own market. The API trims and lowercases this value before lookup. Defaults to us when omitted or blank.

boolean
Defaults to true

When true, omits large Google trend arrays from returned keyword records for a smaller response. Set to false to include full trend data.

keywords
array
required
length between 1 and 50

Keyword inputs to look up. Each item may be a string using the top-level market, or an object with keyword and optional per-item market. The request is rejected if more than 50 items are provided.

keywords*
Responses

Updated 16 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 16 days ago