Analytics

https://exclusivo.one/api/v1 · scope analytics:read

GET /api/v1/analytics

Parameter	Values	Default
`time_range`	`7d`, `30d`, `90d`, `365d`, `all`	`30d`

Anything else returns a 400 listing what’s valid.

curl "https://exclusivo.one/api/v1/analytics?time_range=90d" \
  -H "Authorization: Bearer ex_live_your_key_here"

{
  "data": {
    "summary": {
      "totalRevenue": 18420.5,
      "totalOrders": 312,
      "averageOrderValue": 59.04,
      "totalCustomers": 244
    },
    "topProducts": [
      { "id": "prod_abc123", "name": "Ceramic Mug", "unitsSold": 84, "revenue": 2352 }
    ],
    "revenueByCategory": [],
    "geographicData": [],
    "revenueTimeSeries": [],
    "orderStatusBreakdown": {},
    "refundAnalytics": {},
    "conversionFunnel": {}
  },
  "timeRange": "90d"
}

Field
`summary`	Revenue, orders, average order value, customers
`topProducts`	Top 10 only, by units sold
`revenueByCategory`	Split by collection
`geographicData`	Revenue by location
`revenueTimeSeries`	Revenue over the period
`orderStatusBreakdown`	Order counts by status
`refundAnalytics`	Refund totals and rate
`conversionFunnel`	Only present when there’s funnel data

Two things to code around: topProducts is capped at 10 and doesn’t paginate — derive a full breakdown from orders if you need one. And conversionFunnel is omitted entirely rather than returned empty, so check the key exists before reading it.

averageOrderValue with no orders

Returned as 0 when totalOrders is 0, rather than erroring. Don’t read that 0 as a meaningful average — check totalOrders first.

Time ranges

all covers your whole history and is the most expensive query here. Cache it rather than calling it on every dashboard load.

This isn’t traffic data

These are commerce numbers — orders, revenue, products. Visits, referrers and page views live in the dashboard’s own analytics and aren’t exposed here. → Analytics

Errors

Status
`400`	Bad `time_range`
`403`	Wrong scope
`429`	Rate limited

Overview

Store API

Marketplace API

Analytics

averageOrderValue with no orders

Time ranges

This isn’t traffic data

Errors

​averageOrderValue with no orders

​Time ranges

​This isn’t traffic data

​Errors

averageOrderValue with no orders

Time ranges

This isn’t traffic data

Errors