Workspace

Discovered keywords for an app (what to track next)

Keywords Sonar's discovery engine surfaced for the app but that aren't tracked yet — ranked finds (bucket ranked), competitor gaps (gap), and idea suggestions (idea) — each with latest metrics, AI relevance (0-100), and an opportunity score (0-100). Sorted by opportunity, best first; total is the filtered count before limit. Track the winners via POST /api/v1/apps/{id}/keywords. Requires the Indie plan.

get/api/v1/apps/{id}/discovered-keywords

Request

  • Base URL: https://api.trysonar.app
  • URL: https://api.trysonar.app/api/v1/apps/{id}/discovered-keywords
  • Auth: HTTP bearer

Path parameters

idstring required

Sonar app UUID or store id of a tracked app

Query parameters

countrystring

Filter to one market (ISO country code)

source'autocomplete' | 'metadata' | 'serp_scan' | 'competitor' | 'apple_ads' | 'ai'

Filter by discovery source

status'new' | 'tracked' | 'hidden' | 'all'

Row status filter; default new (still-actionable)

bucket'ranked' | 'gap' | 'idea'

Classification filter

min_relevanceinteger

Only rows with AI relevance ≥ this value (0-100)

min_opportunityinteger

Only rows with opportunity ≥ this value (0-100)

limitinteger

Max rows (1-500, default 200)

Response

{ app_id, total, keywords: [{ id, keyword_id, keyword, store, country, rank, source, status, bucket, popularity, popularity_proxy, popularity_source, difficulty, ai_relevance, opportunity, discovered_at, ranks_checked_at }] }

dataobject required

Result payload — full field reference at https://trysonar.app/docs/api

Changes

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