Queek docs
Merchant endpoint reference

Analytics

Retrieve traffic analytics

GET
/analytics/traffic

Requires scope merchant-analytics-traffic-read.

Reads up to 30 days of anonymous storefront traffic for this store: daily views and visits, bot request count, and measurement metadata. Visits are not unique visitors because shared mobile networks can group shoppers. Bot requests count requests and are not views. Figures can lag live traffic by up to about ten minutes (daily totals refresh every five minutes and responses are cached for up to five); only the installed app's own key with this grant can use this route.

Authorization

merchantKey
X-Client-Key<token>

The store's private API key (sk_live_…, sk_test_… on a dev store) from Dashboard → Settings → API keys. It is bound to one store and carries the scopes the merchant granted; each operation names the scope it needs. Server-side only — never ship it to a browser or an app bundle.

In: header

Query Parameters

days?integer
Range1 <= value <= 30
app_id?string
installation_id?string
source?string
source_app_id?string

Header Parameters

X-Client-Key*string

A private API key (sk_live_…, sk_test_… on a dev store) minted under Dashboard → Settings → API keys. The key is bound to ONE store, so no vendor header or vendor_id is sent; its scopes decide which operations it may call. pk_ public keys never reach this API. Keep it on your server.

X-Request-Id?string

Your own correlation id (8–128 chars, ^[A-Za-z0-9_.:-]+$). Echoed back on the response and on every log line of the request; one is generated when you omit it.

Response Body

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/analytics/traffic?days=30" \  -H "X-Client-Key: {{merchantKey}}"
{  "status": "success",  "message": "Traffic retrieved.",  "data": {    "range": {      "days": 3,      "start": "2026-10-01T00:00:00+01:00",      "end": "2026-10-03T23:59:59+01:00"    },    "cards": {      "views": 31,      "visits": 21,      "bot_requests": 4    },    "charts": {      "views_trend": [        {          "date": "2026-10-01",          "views": 10,          "visits": 7        },        {          "date": "2026-10-02",          "views": 12,          "visits": 8        },        {          "date": "2026-10-03",          "views": 9,          "visits": 6        }      ]    },    "meta": {      "collecting_since": "2026-09-20T00:00:00+01:00",      "raw_retention_days": 14,      "dedupe_window_minutes": 30    }  }}

Files

Previous Page