The Analytics Reports API gives you programmatic access to 140+ report types: App Downloads, App Sessions, Commerce, App Store Engagement, Framework Usage, and more. Data is split into segments with downloadable URLs (gzip TSV).
Role required: Admin, Finance, or Sales and Reports. New report requests may take 24–48 hours before data is available.
Flow Overview
List Report Requests
List analytics report requests for an app. If empty, create one first.
Query Parameters
Response
Create Report Request
Create a new analytics report request. ONGOING generates daily reports; ONE_TIME_SNAPSHOT fetches historical data.
Request Body
List Reports for Request
List available reports (140+ types). Filter by category to narrow down.
Query Parameters
Example Report Types
List Report Instances
List instances for a report. Each instance represents a granularity (daily, weekly, monthly).
Path Parameters
List Segments
List segments for an instance. Each segment has a URL to download the actual data (gzip-compressed TSV).
Response
Download Report Data
- Take the
url from a segment
- Fetch with your JWT (or the segment URL may be pre-signed by Apple)
- Decompress the gzip response
- Parse the TSV (tab-separated values)
Get Segment Details
Get a single segment’s details including the download URL.
Code Example
Credits