Skip to content

Custom data reports

Try this endpoint · Response fields

This endpoint provides access to custom data reports:

Endpoint path: /api/:store/custom_reports

Supported store values:

Param Description
itunes_connect ‘iTunes Connect’ store
google_play ‘Google Play’ store
unified ‘iTunes Connect’ and ‘Google Play’ stores combined; should only be used when report does not require a particular store explicitly
Param Description
report_id string, unique report’s identifier
date_from string date in ISO 8601 format, start of date range, e.g. 2020-02-17
date_to string date in ISO 8601 format, end of date range, e.g. 2020-02-17

In order to pull data for report with id “66d98e90-a782-43ec-adce-3a2ac9beb5bd” for ‘Google Play’ store for a time span from 2020-02-15 to 2020-02-17 the following query can be used:

Terminal window
curl "https://integrations.apptopia.com/api/google_play/custom_reports?report_id=66d98e90-a782-43ec-adce-3a2ac9beb5bd&date_from=2020-02-15&date_to=2020-02-17" \
-H "Authorization: $APPTOPIA_TOKEN"

The response is an array of part records. Each record contains a string url for downloading a report part. The downloaded file’s schema is specific to your custom report.

An abbreviated response is:

// Abbreviated response; omitted fields and records are shown as ...
[
{
"url":"https://integrations.apptopia.com/dataset/66d98e90-a782-43ec-adce-3a2ac9beb5bd/apptopia-custom-reports/google_play/2020-02-15/part-00000.json.gz?X-Amz-Date=20200219T101027Z&X-Amz-Expires=86400&X-Amz-Signature=db44a773532436940f206cd21e46ca58ce83cdb2a7dfefed7351aeb5b762aca6&X-Amz-SignedHeaders=host"
},
{
"url":"https://integrations.apptopia.com/dataset/66d98e90-a782-43ec-adce-3a2ac9beb5bd/apptopia-custom-reports/google_play/2020-02-16/part-00000.json.gz?X-Amz-Date=20200219T101027Z&X-Amz-Expires=86400&X-Amz-Signature=db44a773532436940f206cd21e46ca58ce83cdb2a7dfefed7351aeb5b762aca6&X-Amz-SignedHeaders=host"
},
{
"url":"https://integrations.apptopia.com/dataset/66d98e90-a782-43ec-adce-3a2ac9beb5bd/apptopia-custom-reports/google_play/2020-02-17/part-00000.json.gz?X-Amz-Date=20200219T101027Z&X-Amz-Expires=86400&X-Amz-Signature=db44a773532436940f206cd21e46ca58ce83cdb2a7dfefed7351aeb5b762aca6&X-Amz-SignedHeaders=host"
},
...
]

URLs are valid within 24h since the API query invocation.