App Store Connect by Acquisition Channel

⚠️

Upcoming changes — January 19, 2027

Following our recent Public API pricing update, this endpoint's request limits will change:

  • Date range: Each request can cover a maximum of one year.
  • Apps: The apps parameter will be required and must contain between 1 and 10 apps.

Please update your requests before January 19. Split larger requests into multiple calls.



The integrations reports endpoints allow you to fetch different reports related to your integrations in AppTweak with a breakdown by acquisition channel.

Price
DataCreditsPer
Acquisition channel report1request


The response for the request will be a JSON which contains all the info related to the selected property, grouped by app id, country code and device, without pagination.
Query Params
string
required

The api-account-id of the integrated account. Get the list of integrated accounts using the integrated accounts endpoint. You can only pass 1 api account id. It must be an "itunes-connect" integration.

string
enum
required

The metric to report, one per request. units is first-time downloads; installs is completed installations, redownloads and other devices on the same Apple Account included, and like every usage metric it covers only users who opted in to share analytics. impressions-total and page-view-count count every impression and product page view; impressions-total-unique and page-view-unique count each device once. Each value is described in the property parameter table.

string
Defaults to all

The list of acquisition channels (search, browse, appref, webref) OR all. Default: all

string

The list of app ids separated by commas for which to fetch the report. Get the list of products using the integrated apps endpoint. Default: all products

string

Comma-separated country codes among the territories App Store Connect reports. Default: all available countries

string

Start date (YYYY-MM-DD). Send both dates or omit both. Defaults to 30 days ago.

string

The end date for the report in the format: YYYY-MM-DD. Default: yesterday

Responses

401

Unauthorized. Unknown or missing API token.

403

Forbidden. Returned when there are not enough credits to perform the request, when one of the requested apps is not owned by the connected account, or when the requested resource does not belong to the requester's account.

422

Validation error. Returned when a parameter is invalid.

Language
Credentials
Header
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json