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.
Query parameters
Section titled “Query parameters”| 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. |
Choose a dataset
Section titled “Choose a dataset”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.
Select dates and intervals
Section titled “Select dates and intervals”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.
Download the response parts
Section titled “Download the response parts”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" }]- Request export URLs for your dataset and dates.
- Download every part returned for each snapshot.
- Decompress Gzip files if you requested compression.
- 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.
Try it
Section titled “Try it”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.