Analytics API

Aggregate click counts for your app's links. DeepLinkNow is not an analytics suite: it reports operational totals only, never individual visitors, and never anything about you as the caller. For funnels and attribution, forward the deferred link your SDK returns to your own analytics tool.

Authentication

Requires your app's private API key (dln_priv_…) in the x-api-key header. Public SDK keys (dln_pub_…) are rejected with 401. Results only ever cover the key's own app. See Authentication.

Get Click Counts

GET /api/v1/analytics

Headers:
  x-api-key: dln_priv_your_private_key

Query Parameters (all optional):
  start_date  - ISO datetime
  end_date    - ISO datetime
  campaign_id - Campaign UUID
  platform    - "ios" | "android" | "web"
  group_by    - "day" | "week" | "month" (default: "day")

{
  "overview": { "total_clicks": 1200 },
  "time_series": [
    { "date": "2025-01-01", "total_clicks": 40 }
  ],
  "platforms": [
    { "platform": "ios", "clicks": 700, "percentage": 58.3 }
  ]
}

All values are totals across clicks on your links, recorded by the link page. time_series buckets are UTC days, weeks (the Monday's date) or months. There are no unique-visitor, country or referrer breakdowns. An app with no clicks returns zeros and empty arrays. Per-link counts are available from GET /api/v1/deeplinks/{id}/stats (see the Deep Links API).