Ad rate per prompt over time
Weekly ad rate for each prompt that ran in the window, alongside the same figure over the whole window, so a prompt whose advertisers arrived last week is distinguishable from one that has been contested throughout. Accepts the full visibility filter set (date range, models, topic, prompt, tags). Ordered by absolute ad volume — ad-bearing executions, then executions — NOT by rate: a prompt that ran twice and drew one ad reads 50% and would otherwise outrank one that ran 400 times and drew 120. Returns the whole prompt set up to 100 series rather than a plottable handful, so a consumer can chart its leaders and still offer the rest for selection without a second call. Buckets are ISO weeks starting Monday, not days: ads are observed on a single surface, so a prompt contributes one execution per refresh, and since domains seldom refresh more than once a day a daily bucket is mostly a denominator of 1 — a rate that reads 0% or 100%. Read each point against its own `executions`, which says how much is behind its rate. Points cover only the weeks a prompt actually ran: a week it did not run is ABSENT rather than a 0% rate, since the domain does not refresh every week and an unrun prompt has no rate at all. Prompts that drew no ads are included, as a flat zero line.
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/prompt-series"{ "series": [ { "promptId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", "prompt": "best running shoes for flat feet", "executions": 20, "executionsWithAds": 5, "adRate": 25, "points": [ { "weekStart": "2026-05-25", "executions": 5, "executionsWithAds": 4, "adRate": 80 } ] } ]}