Find apps in a store by keyword
For finding apps and their store IDs, not for checking ranks. On iOS the list follows the App Store's own search order when Sonar can read it, with the iTunes Search API's relevance order as the fallback (which can sit dozens of places away from the App Store's real ranking below the top 10), and the response doesn't say which one served it, so the list order is not a rank. For an app's position on a keyword, track the keyword and read /api/v1/apps/{id}/rankings or /api/v1/keywords/{id}/rankings.
Request
- Base URL: https://api.trysonar.app
- URL: https://api.trysonar.app/api/v1/apps/search
- Auth: one of:
- none
- HTTP bearer
Query parameters
Search query
App store
ISO 3166-1 alpha-2 country code. Store reads accept every App Store storefront (175) and Google Play market (145); a code that isn't a storefront returns 400 with error.reason: "unsupported_market".
Max results (1–50)
Response
Matching apps (list order is not a rank — see the operation description). When the store is throttling, the newest stored top 10 for this exact term and storefront with meta.stale + meta.partial (entries carry rank, store, storeId, name, developer, iconUrl only).
Changes
No recorded changes to this operation across all 1 revision of this API.