Skip to content

FAQ & troubleshooting

Historical coverage depends on the dataset and your subscription. Use the retention table in Bulk exports for snapshot availability and confirm other historical access with your Apptopia contact. A time series request can cover at most 180 days.

How do I properly set the quarterly date range?

Section titled “How do I properly set the quarterly date range?”

Quarterly exports are identified by the first day of each quarter: January 1, April 1, July 1, and October 1. Include the desired quarter’s start date in your requested range. Check the export dataset’s supported intervals before choosing quarter.

Yes. The documented API limit is 1,000 requests per minute over a sliding 60-second window. Excess requests return 429. See Limits & errors.

Yes. Keep the combined request rate within your limit. For discovery, process different partitions concurrently and follow each partition’s page tokens in order.

How can I increase the speed of my downloads?

Section titled “How can I increase the speed of my downloads?”

For larger transfers, consider downloading and processing exports on compute close to the data before transferring the reduced result to your own systems. Network capacity and the amount of data transferred affect download time.

What if I only want a subset of the data I am pulling?

Section titled “What if I only want a subset of the data I am pulling?”

Use entity lookups when you know the IDs, search to find matching entities, or filter exported records in your own pipeline. Contact Apptopia to discuss a custom report when the standard endpoints do not fit your use case.

How do lookups, discovery, search, and exports differ?

Section titled “How do lookups, discovery, search, and exports differ?”

Lookups return known entities. Discovery pages through datasets. Bulk exports return downloadable snapshots. Search finds IDs by name or filters. See Choose an access pattern.

Exports are split into multiple parts. Part sizes vary by dataset, date, and compression. Download all URLs returned for the requested snapshot.

The API supports Apple App Store (itunes_connect) and Google Play (google_play). Dataset availability depends on your account. See Stores & identifiers.

Update schedules vary by dataset. Monthly datasets use a month-level date, while daily estimates and export snapshots follow their own publishing schedules. Confirm the delivery timing you need with your Apptopia contact before scheduling a production pipeline.

You can look up 50 IDs per lookup request. Use a single id or repeat id[] for multiple IDs.

The maximum is 180 days per time series request. Split longer periods into smaller windows.

Can I pull queries based on the last time the data was updated?

Section titled “Can I pull queries based on the last time the data was updated?”

Use date_from and date_to for measurements within a time range. For metadata, retrieve a snapshot and filter fields such as last_update_date where available. Measurement dates and metadata update dates have different meanings.

Use the client ID and secret supplied for the Data API. Send them as form-encoded client and secret fields to /api/login. Check for accidental whitespace. See Authentication.

The documented new releases window is the last 30 days. Check your dates, store, and country. See New releases.

Check app metadata from /api/:store/app or /api/:store/app/discovery, subject to field availability for the selected store.

The existing API contract describes estimate timestamps in Eastern Standard Time. Most request examples use date-only YYYY-MM-DD values. Confirm time-zone and daylight-saving handling for timestamp fields before converting them in your pipeline.

Send your Apptopia contact the intended task, expected result, actual result, route, and a reproducible request with credentials removed. Include a request ID when available.