Skip to main content
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

  1. Take the url from a segment
  2. Fetch with your JWT (or the segment URL may be pre-signed by Apple)
  3. Decompress the gzip response
  4. Parse the TSV (tab-separated values)

Get Segment Details

Get a single segment’s details including the download URL.

Code Example


Credits