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".
AuthorizationBearer <token>Session JWT signed with HS256. Verification pins the algorithm and rejects expired tokens, per RFC8725.
domainId*stringDomain under analysis
startDate?stringStart 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.
endDate?stringEnd date for the report range (ISO 8601). Defaults to now when omitted.
models?array<string>Filter by specific models
topicId?stringFilter by specific topic ID
promptId?stringFilter 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.
includeVariation?booleanInclude variation calculation comparing to previous period
truepage?numberPage number for paginated responses
1 <= value1limit?numberItems per page for paginated responses
1 <= value <= 10050marketLanguageCodePairId?stringFilter by specific market/language pair ID
tagIds?array<string>Filter by tag IDs (visibility_result joined with prompt_tag)
dimension*stringWhether to break the series down by advertiser or by creative
"advertiser""creative"seriesLimit?numberHow 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 <= 126One series per entity
application/json- response
dimension*stringWhether the breakdown is by advertiser or by creative
"advertiser""creative"series*array<>One series per entity, highest volume first
curl -X GET 'https://api.getmint.ai/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 } ] } ]}