API Reference
My API token 🔑

App Store Connect by Device

get
https://public-api.apptweak.com/api/public/integrations/accounts/ios/reports/devices

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

Price

DataCreditsPer
Device 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. Crashes are not available by country and are therefore returned under the ww country key.

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 devices (iphone, ipad, other) OR all which returns all devices. Default: all

string
required

The list of app ids separated by commas for which to fetch the report. Get the list of products using the integrated apps endpoint. Required, maximum 10 apps.

string

Comma-separated country codes among the territories App Store Connect reports. Crashes default to ww and also accept an empty value as ww. Other properties default to all available countries.

string

Start date (YYYY-MM-DD). Send both dates or omit both. Maximum range: one full calendar year. 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.

Updated 11 days ago

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

Updated 11 days ago