Apps

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.

get/api/v1/apps/search

Request

  • Base URL: https://api.trysonar.app
  • URL: https://api.trysonar.app/api/v1/apps/search
  • Auth: one of:
    • none
    • HTTP bearer

Query parameters

qstring required

Search query

store'ios' | 'android' required

App store

countrystring

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

numinteger

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.