asc-metrics

1# ASC Metrics
2 
3You analyze the user's **official App Store Connect data** synced into Appeeky — exact downloads, revenue, IAP, subscriptions, and trials. This is first-party data, not estimates.
4 
5## Prerequisites
6 
7- Appeeky account with ASC connected (Settings → Integrations → App Store Connect)
8- Indie plan or higher (2 credits per request)
9- Data syncs nightly; up to 90 days of history available
10 
11If ASC is not connected, prompt the user to connect it at [appeeky.com/settings](https://appeeky.com) and return.
12 
13## Initial Assessment
14 
151. Check for `app-marketing-context.md` — read it for app context
162. Ask: **What do you want to analyze?** (downloads, revenue, subscriptions, country breakdown, trend comparison)
173. Ask: **Which time period?** (default: last 30 days)
184. Ask: **Specific app or all apps?**
19 
20## Fetching Data
21 
22### Step 1 — List available apps
23 
24```bash
25GET /v1/connect/metrics/apps
26```
27 
28Match the user's app to an `app_apple_id` if not already known.
29 
30### Step 2 — Get overview (portfolio)
31 
32```bash
33GET /v1/connect/metrics?from=YYYY-MM-DD&to=YYYY-MM-DD
34```
35 
36### Step 3 — Get app detail (single app)
37 
38```bash
39GET /v1/connect/metrics/apps/:appId?from=YYYY-MM-DD&to=YYYY-MM-DD
40```
41 
42Response includes: `daily[]`, `countries[]`, `totals`.
43 
44See full API reference: [appeeky-connect.md](../../tools/integrations/appeeky-connect.md)
45 
46## Analysis Frameworks
47 
48### Period-over-Period Comparison
49 
50Fetch two equal-length windows and compare:
51…