> ## Documentation Index
> Fetch the complete documentation index at: https://docs.appeeky.com/llms.txt
> Use this file to discover all available pages before exploring further.

# App Metrics

> Daily store analytics, traffic sources, Apple Search Ads and RevenueCat for one of your apps

Read the performance data Appeeky syncs for an app in your list: product page views, downloads, conversion, where App Store traffic came from, Apple Search Ads spend and installs, and RevenueCat revenue and trials. Use it to measure what a listing change, an ad campaign or a price change did.

> [!NOTE]
>
> This endpoint costs **0 credits** and requires the `apps:read` scope. It returns only data you have connected in appeeky.com (App Store Connect, Google Play, Apple Search Ads, RevenueCat); a part you have not connected is `null`.

***

## Get App Metrics

```
GET /v1/user/apps/:appId/metrics
```

**Path Parameters:**

| Name | Type | Description |
| - | - | - |
| `appId` | string | App Store ID, or Google Play package name, of an app in your list |

**Query Parameters:**

| Name | Type | Description |
| - | - | - |
| `from` | date | First day, `YYYY-MM-DD`. Default: 28 days before `to` |
| `to` | date | Last day (inclusive), `YYYY-MM-DD`. Default: yesterday |

At most 180 days per request.

```bash cURL theme={"theme":{"light":"github-light","dark":"github-dark"}}
curl "https://api.appeeky.com/v1/user/apps/6443843426/metrics?from=2026-10-01&to=2026-10-28" \
  -H "X-API-Key: YOUR_API_KEY"
```

```javascript JavaScript theme={"theme":{"light":"github-light","dark":"github-dark"}}
const res = await fetch(
  "https://api.appeeky.com/v1/user/apps/6443843426/metrics?from=2026-10-01&to=2026-10-28",
  { headers: { "X-API-Key": "YOUR_API_KEY" } }
);
const { data } = await res.json();
```

**Response:**

```json theme={"theme":{"light":"github-light","dark":"github-dark"}}
{
  "data": {
    "app": { "appId": "6443843426", "storeAppId": "6443843426", "platform": "ios", "name": "Sleep Sounds" },
    "from": "2026-10-01",
    "to": "2026-10-28",
    "store": {
      "source": "app-store-connect",
      "days": [
        {
          "date": "2026-10-01",
          "impressions": 1840,
          "pageViews": 412,
          "downloads": 61,
          "conversionRate": 0.148,
          "proceeds": 38.4,
          "trials": 9,
          "subscriptions": 4
        }
      ]
    },
    "sources": [
      { "source": "App Store search", "impressions": 41200, "pageViews": 9100, "share": 0.82 },
      { "source": "App Store browse", "impressions": 6300, "pageViews": 1200, "share": 0.11 }
    ],
    "ads": {
      "currency": "USD",
      "days": [{ "date": "2026-10-01", "spend": 24.1, "impressions": 3100, "taps": 120, "installs": 31 }],
      "totals": { "spend": 642.5, "installs": 810, "taps": 3300, "impressions": 88000, "cpa": 0.79 }
    },
    "revenuecat": {
      "scope": "app",
      "currency": "USD",
      "days": [
        { "date": "2026-10-01", "revenue": 52.3, "mrr": 1890, "trials": 14, "newCustomers": 96, "trialConversion": 0.31, "churn": 6, "actives": 412 }
      ]
    }
  }
}
```

### Fields

| Field | Description |
| - | - |
| `store.days[].conversionRate` | App Store: downloads ÷ unique product page views. Google Play: store listing acquisitions ÷ visitors. `null` without page views |
| `store.days[].proceeds` | App Store Connect sales proceeds, or Google Play estimated revenue |
| `sources` | App Store only. Traffic by source over the range; `share` is the source's share of product page views |
| `ads` | Apple Search Ads campaigns for this app, summed per day |
| `revenuecat.scope` | `app` when the RevenueCat project holds only this app. `project` when it holds other apps too, so the numbers include them |

Days with no synced data are left out; a value Appeeky does not have for a day is `null`.

### Errors

| Status | Code | When |
| - | - | - |
| 400 | `BAD_REQUEST` | `from` or `to` is not a date, `from` is after `to`, or the range is over 180 days |
| 403 | `FORBIDDEN` | The key does not have `apps:read` |
| 404 | `NOT_FOUND` | The app is not in your list |


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.