Analytics & Reports

Request and download analytics and sales reports from App Store Connect

The analytics command group provides access to App Store analytics data and sales reports. You can request analytics reports, check their status, and download the generated data.

Overview

Analytics reports provide insights into app performance, user engagement, and sales data. The workflow involves:

Creating a report request (one-time or ongoing)
Checking request status and available reports
Downloading report data for analysis

Sales Reports

Download sales and trends reports directly without creating a request.

Download Sales Report

asc analytics sales \
  --vendor "12345678" \
  --type SALES \
  --subtype SUMMARY \
  --frequency DAILY \
  --date "2024-01-20"

Required Flags:

--vendor - Vendor number (or ASC_VENDOR_NUMBER env)
--type - Report type: SALES, PRE_ORDER, NEWSSTAND, SUBSCRIPTION, SUBSCRIPTION_EVENT
--subtype - Report subtype: SUMMARY, DETAILED
--frequency - Frequency: DAILY, WEEKLY, MONTHLY, YEARLY
--date - Report date (format depends on frequency)

Date Formats:

Daily: YYYY-MM-DD
Weekly: YYYY-MM-DD (Monday start or Sunday end)
Monthly: YYYY-MM
Yearly: YYYY

Optional Flags:

--version - Report format version: 1_0 (default), 1_1, 1_3
--output - Custom output path (default: sales_report_{date}_{type}.tsv.gz)
--decompress - Decompress to .tsv format

Examples:

# Daily sales summary
asc analytics sales \
  --vendor "12345678" \
  --type SALES \
  --subtype SUMMARY \
  --frequency DAILY \
  --date "2024-01-20"

# Weekly subscription report with decompression
asc analytics sales \
  --vendor "12345678" \
  --type SUBSCRIPTION \
  --subtype DETAILED \
  --frequency WEEKLY \
  --date "2024-01-15" \
  --decompress

# Monthly report with custom output path
asc analytics sales \
  --vendor "12345678" \
  --type SALES \
  --subtype SUMMARY \
  --frequency MONTHLY \
  --date "2024-01" \
  --output "reports/monthly.tsv.gz"

Analytics Report Requests

Create Request

Create a new analytics report request to access detailed analytics data.

asc analytics request \
  --app "123456789" \
  --access-type ONGOING

Required Flags:

--app - App ID (or ASC_APP_ID env)
--access-type - ONGOING for continuous access or ONE_TIME_SNAPSHOT for single request

Access Types:

ONGOING: Continuous access to analytics data (recommended)
ONE_TIME_SNAPSHOT: Single-use request for a specific time period

List Requests

View all analytics report requests for an app.

asc analytics requests --app "123456789"

Optional Flags:

--request-id - Filter by specific request ID
--state - Filter by state: PROCESSING, COMPLETED, FAILED
--limit - Results per page (1-200)
--paginate - Fetch all pages automatically
--next - Pagination URL from previous response

Examples:

# List all requests
asc analytics requests --app "123456789"

# Filter by completed requests
asc analytics requests --app "123456789" --state COMPLETED

# Get specific request
asc analytics requests --request-id "abc-123-def"

# Fetch all pages
asc analytics requests --app "123456789" --paginate

View Reports

Retrieve available analytics reports and instances for a request. asc analytics get still works as a deprecated compatibility alias, but asc analytics view is the canonical command.

asc analytics view --request-id "REQUEST_ID"

Required Flags:

--request-id - Analytics report request ID

Optional Flags:

--instance-id - Filter by specific report instance
--date - Filter instances by date (YYYY-MM-DD)
--include-segments - Include download URLs for report segments
--limit - Results per page (1-200)
--paginate - Fetch all reports (recommended with --date)
--next - Pagination URL

Examples:

# Get all reports for a request
asc analytics view --request-id "REQUEST_ID"

# Get reports with download URLs
asc analytics view \
  --request-id "REQUEST_ID" \
  --include-segments

# Filter by date and paginate
asc analytics view \
  --request-id "REQUEST_ID" \
  --date "2024-01-20" \
  --paginate

# Get specific instance
asc analytics view \
  --request-id "REQUEST_ID" \
  --instance-id "INSTANCE_ID"

Download Report Data

Download analytics report data files.

asc analytics download \
  --request-id "REQUEST_ID" \
  --instance-id "INSTANCE_ID"

Required Flags:

--request-id - Analytics report request ID
--instance-id - Report instance ID

Optional Flags:

--segment-id - Specific segment ID (required if multiple segments)
--output - Custom output path (default: analytics_report_{requestId}_{instanceId}.csv.gz)
--decompress - Decompress to .csv format

Examples:

# Download and decompress report
asc analytics download \
  --request-id "REQUEST_ID" \
  --instance-id "INSTANCE_ID" \
  --decompress

# Download specific segment
asc analytics download \
  --request-id "REQUEST_ID" \
  --instance-id "INSTANCE_ID" \
  --segment-id "SEGMENT_ID"

Delete Request

Delete an analytics report request.

asc analytics requests delete \
  --request-id "REQUEST_ID" \
  --confirm

Required Flags:

--request-id - Request ID to delete
--confirm - Confirm deletion

Report Metadata

List Report Instances

List instances for a specific report.

asc analytics reports links --report-id "REPORT_ID"

View Report Details

Get detailed information about a specific analytics report.

asc analytics reports view --report-id "REPORT_ID"

View Relationships

List instance relationships for a report.

asc analytics reports links \
  --report-id "REPORT_ID" \
  --paginate

Report Segments

Large analytics reports are split into segments for download.

View Segment

asc analytics segments view --segment-id "SEGMENT_ID"

Use segment IDs returned by asc analytics reports links --report-id "REPORT_ID" --paginate.

Vendor Number

Sales reports require a vendor number, which identifies your organization in App Store Connect. Finding Your Vendor Number:

Sign in to App Store Connect
Go to Payments and Financial Reports
Your vendor number appears in the top right

Setting via Environment:

export ASC_VENDOR_NUMBER="12345678"
# or for analytics specifically
export ASC_ANALYTICS_VENDOR_NUMBER="12345678"

Report Formats

Sales Reports (TSV)

Sales reports are tab-separated value files compressed with gzip:

Provider    Provider Country    SKU    Developer    Title    Version    Product Type Identifier    Units    Developer Proceeds    ...
APPLE       US                  ...    ...

Use --decompress to extract the .tsv file for analysis.