Workspace

App Store Connect sales for one of your iOS apps (Agency plan)

Daily first-time downloads, redownloads, in-app purchase units and approximate USD proceeds (static FX table, hence proceeds_usd_approx), window totals, and a per-country breakdown for one of your own iOS apps — same numbers as the Performance page. Needs an App Store Connect connection. Every response carries status (ready | not_connected | not_ios | app_not_in_account | pending | key_lacks_analytics) and a human-readable message when not ready, instead of an empty series; days Apple hasn't reported have reported: false and null metrics. Requires the Agency plan — 403 on other plans.

get/api/v1/apps/{id}/sales

Request

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

Path parameters

idstring required

Sonar app UUID or store id (bundle id) of one of your own tracked iOS apps

Query parameters

startstring date

First day of the window, YYYY-MM-DD (inclusive). Defaults to days back from end.

endstring date

Last day of the window, YYYY-MM-DD (inclusive). Defaults to yesterday (UTC).

daysinteger

Window length in days when start is omitted (1-366, default 30)

store'ios' | 'android'

Disambiguates a store id tracked in both stores

Response

{ app_id, app_name, store, status, connected, message, apple_app_id, last_synced_at, range: { start, end }, reported_days, totals: { downloads, redownloads, iap_units, proceeds_usd_approx } | null, days: [{ date, reported, downloads, redownloads, iap_units, proceeds_usd_approx }], countries: [{ country, downloads, redownloads, iap_units, proceeds_usd_approx }] }

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.