Ad rate for a domain
Share of prompt executions that rendered at least one sponsored ad, over the requested window, with a daily series and a per-model split. The denominator is every execution in scope, so the figure moves when the model mix changes. Accepts the full visibility filter set (date range, models, topic, prompt, tags). Also carries how widely advertisers spread across the prompt set, where the analysed brand itself stands among them, and the same counters over the equally long window immediately before this one, so deltas need no second call. That comparison window is derived from the requested one: ask for a different range and the baseline moves with it.
In: header
Path Parameters
Domain under analysis
Query Parameters
Start date for the report range (ISO 8601). On aggregated endpoints, omit to default to the last 6 months (there is no "all time"); an explicit start is honoured at any length.
End date for the report range (ISO 8601). Defaults to now when omitted.
Filter by specific models
Filter by specific topic ID
Filter raw results to a single prompt ID. Used by the sentiment heatmap drawer to lazy-load one cell's LLM response instead of bundling all responses in the aggregate.
Include variation calculation comparing to previous period
truePage number for paginated responses
1 <= value1Items per page for paginated responses
1 <= value <= 10050Filter by specific market/language pair ID
Filter by tag IDs (visibility_result joined with prompt_tag)
Response Body
application/json
curl -X GET "https://example.com/api/domains/3fa85f64-5717-4562-b3fc-2c963f66afa6/ads/overview"{ "executions": 4820, "executionsWithAds": 386, "totalAds": 1174, "adRate": 8.01, "uniqueAdvertisers": 42, "uniqueCreatives": 137, "avgPromptsPerAdvertiser": 4.6, "totalPrompts": 9, "ownBrand": { "isAdvertising": true, "adCount": 96, "creativeCount": 3, "promptCount": 3, "firstSeenAt": "2026-04-21T08:02:00.000Z" }, "comparison": { "adRate": 8.94, "uniqueAdvertisers": 40, "uniqueCreatives": 129, "startDate": "2026-04-27T00:00:00.000Z", "endDate": "2026-05-25T00:00:00.000Z" }, "overTime": [ { "executions": 4820, "executionsWithAds": 386, "totalAds": 1174, "adRate": 8.01, "key": "2026-05-25" } ], "byModel": [ { "executions": 4820, "executionsWithAds": 386, "totalAds": 1174, "adRate": 8.01, "key": "2026-05-25" } ]}