Analytics API

Retrieve analytics and reporting data to understand how AI agents interact with your product catalog, track query patterns, and measure revenue attribution.

Scope: analytics:read

Management API preview

Cresva records query, transaction, and revenue events from the live Storefront API today, but the brand-facing Analytics endpoints documented here ship with the public Management API release.

GET/analytics/overview

Retrieve summary statistics including total requests, unique queries, average response time, and error count.

Query Parameters

sincestringISO 8601 start date

untilstringISO 8601 end date

bash

curl "https://api.cresva.ai/api/storefront/[brandId]/analytics/overview?since=2026-03-01T00:00:00Z&until=2026-03-28T23:59:59Z" \
  -H "Authorization: Bearer cresva_ak_a1b2c3d4e5f6..."

javascript

const params = new URLSearchParams({
  since: "2026-03-01T00:00:00Z",
  until: "2026-03-28T23:59:59Z",
});

const response = await fetch(
  `https://api.cresva.ai/api/storefront/[brandId]/analytics/overview?${params}`,
  {
    headers: {
      Authorization: `Bearer ${process.env.CRESVA_API_KEY}`,
    },
  }
);

const { data } = await response.json();

Example Response

JSON

{
  "data": {
    "totalRequests": 45230,
    "uniqueQueries": 12847,
    "avgResponseMs": 134,
    "errorCount": 23,
    "period": {
      "since": "2026-03-01T00:00:00Z",
      "until": "2026-03-28T23:59:59Z"
    }
  }
}

GET/analytics/queries

Retrieve query analytics including intent distribution, top queries, and platform breakdown.

Query Parameters

sincestringISO 8601 start date

untilstringISO 8601 end date

bash

curl "https://api.cresva.ai/api/storefront/[brandId]/analytics/queries?since=2026-03-01T00:00:00Z&until=2026-03-28T23:59:59Z" \
  -H "Authorization: Bearer cresva_ak_a1b2c3d4e5f6..."

javascript

const params = new URLSearchParams({
  since: "2026-03-01T00:00:00Z",
  until: "2026-03-28T23:59:59Z",
});

const response = await fetch(
  `https://api.cresva.ai/api/storefront/[brandId]/analytics/queries?${params}`,
  {
    headers: {
      Authorization: `Bearer ${process.env.CRESVA_API_KEY}`,
    },
  }
);

const { data } = await response.json();

Example Response

JSON

{
  "data": {
    "intentDistribution": {
      "search": 6420,
      "recommend": 3210,
      "compare": 1890,
      "detail": 1327
    },
    "topQueries": [
      { "query": "wireless headphones", "count": 342 },
      { "query": "running shoes", "count": 287 }
    ],
    "platformBreakdown": {
      "chatgpt": 5230,
      "perplexity": 3420,
      "claude": 2890,
      "other": 1307
    }
  }
}

GET/analytics/revenue

Retrieve agent commerce revenue attribution data.

Query Parameters

sincestringISO 8601 start date

untilstringISO 8601 end date

bash

curl "https://api.cresva.ai/api/storefront/[brandId]/analytics/revenue?since=2026-03-01T00:00:00Z&until=2026-03-28T23:59:59Z" \
  -H "Authorization: Bearer cresva_ak_a1b2c3d4e5f6..."

javascript

const params = new URLSearchParams({
  since: "2026-03-01T00:00:00Z",
  until: "2026-03-28T23:59:59Z",
});

const response = await fetch(
  `https://api.cresva.ai/api/storefront/[brandId]/analytics/revenue?${params}`,
  {
    headers: {
      Authorization: `Bearer ${process.env.CRESVA_API_KEY}`,
    },
  }
);

const { data } = await response.json();

Example Response

JSON

{
  "data": {
    "totalRevenue": 284930,
    "currency": "USD",
    "transactionCount": 1423,
    "avgOrderValue": 20023,
    "byPlatform": [
      { "platform": "chatgpt", "revenue": 142300, "transactions": 712 },
      { "platform": "perplexity", "revenue": 89400, "transactions": 445 }
    ]
  }
}