Ad volume over time, per advertiser or per creative
Daily ad counts for the leading advertisers (or the leading creatives) of the window, ranked by volume before their points are read, so the series returned are the ones worth plotting. `seriesLimit` caps how many come back, deliberately low: a line per advertiser stops being readable well before the data runs out. Points cover only the days an entity was actually observed. A day it was not seen is ABSENT rather than zero, because the domain does not refresh every day and a zero would assert an observation that never happened. Consumers plotting a continuous axis decide themselves whether a gap means "no ads" or "no data".
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)
Whether to break the series down by advertiser or by creative
Value in
- "advertiser"
- "creative"
How many entities to plot, ranked by ad volume. Kept small on purpose: a line per advertiser stops being readable well before the underlying data runs out.
1 <= value <= 126Response Body
application/json
curl -X GET "https://example.com/api/domains/3fa85f64-5717-4562-b3fc-2c963f66afa6/ads/series?dimension=advertiser"{ "dimension": "advertiser", "series": [ { "key": "adidas.com", "label": "Adidas", "totalAds": 218, "points": [ { "date": "2026-05-25", "ads": 12 } ] } ]}