Skip to content

Bulk data exports

GET /api/:store/data_dumps

Bulk exports return signed URLs for dataset snapshot files. Use them to download larger datasets without paging through individual API responses.

Parameter Description
dataset Required dataset slug from the table below.
date_from Start of the date range in YYYY-MM-DD format.
date_to End of the date range in YYYY-MM-DD format.
interval day, month, or quarter, where supported by the dataset. Defaults to day.
model_version Estimates model, where supported: v2.0 or v3.0.
compressed Set to true to request Gzip-compressed files. Omit or set to false for uncompressed files.

Follow the Contents links for field definitions in the downloaded records.

Dataset slug Contents Snapshot retention Supported intervals
app_general_data Apps 30 days day
publisher_general_data Publishers 30 days day
parent_company_general_data Parent companies 30 days day
sdk_general_data SDKs 30 days day
app_sdks Installed SDKs 3 months day, month, quarter
app_retention_data Retention estimates 3 months month
daily_app_estimates App estimates 3 months day, month, quarter
daily_app_session_data App sessions 3 months day, month, quarter
daily_app_ratings App ratings 3 months day, month, quarter
app_ranks App ranks 3 months day
daily_publisher_estimates Publisher estimates 3 months day, month, quarter
cross_app_usage Cross app usage 3 months day (monthly snapshot)
app_tags App tags 3 months day

Availability also depends on your account’s dataset access.

Use /api/unified/data_dumps for parent_company_general_data. This dataset combines both stores. Other datasets in the table use the selected store’s path.

For cross_app_usage, request interval=day and the first day of the measurement month. The data is monthly even though its snapshots are registered under the daily export interval.

Each snapshot is identified by the start date of its interval:

  • Daily: the day represented by the snapshot.
  • Monthly: the first day of the month.
  • Quarterly: January 1, April 1, July 1, or October 1.

Your date range must include each desired snapshot’s identifying date. For example, a monthly range from 2017-01-01 to 2017-02-01 includes January and February snapshots. A quarterly range from 2016-01-01 to 2016-05-01 includes Q1 and Q2 because their identifying dates are January 1 and April 1.

The API returns a list of parts. This example shows the response structure; the URL is a placeholder:

[
{
"date": "2026-10-01",
"part": 0,
"url": "https://apptopia-bulk.s3.amazonaws.com/path/to/part-00000?SIGNED_QUERY"
}
]
  1. Request export URLs for your dataset and dates.
  2. Download every part returned for each snapshot.
  3. Decompress Gzip files if you requested compression.
  4. Parse the downloaded files as newline-delimited JSON: each nonempty line contains one record. Use the field definitions linked under Choose a dataset.

The documented URL lifetime is 24 hours from the API request. Request fresh URLs if your downloads have expired. Monthly and quarterly exports use the same response structure as daily exports.

The playground requests the part list. Downloading the files is a separate step, so you can review the returned URLs before starting a larger transfer.