App Metrics

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.

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.

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"

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:

{
  "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

My Data - Appeeky Web

AI Visibility

SEO for Apps

Growth Channels

UGC & Phones

Get App Metrics

Fields

Errors

​Get App Metrics

​Fields

​Errors

Get App Metrics

Fields

Errors