Keywords

Keyword research with difficulty + popularity

Keyword research with difficulty + popularity

get/api/v1/keywords/search

Request

  • Base URL: https://api.trysonar.app
  • URL: https://api.trysonar.app/api/v1/keywords/search
  • Auth: HTTP bearer

Query parameters

qstring required
store'ios' | 'android' required

App store

countrystring

ISO 3166-1 alpha-2 country code — one of Sonar's 72 keyword-research markets (keyword data is persisted per country). Other codes return 400 with error.reason: "unsupported_market" and the list of supported codes.

Headers

X-Sonar-Time-Budget-Msinteger

Optional: total milliseconds the caller will wait for the response. The server stops starting store work before it ends and answers with what it has — cached, stale, or pending keywords (queued on the scrape fleet, not billed); charts serve the newest stored snapshot. Can only shorten the server default (API_REQUEST_DEADLINE_MS, 40s on the API box); values under 3000 are treated as 3000. The MCP tools send it.

Response

Keyword data

Changes

No recorded changes to this operation across all 1 revision of this API.