Advertisers observed on a domain
Paginated leaderboard of every advertiser that bought placement alongside this domain's answers, with each one's share of ads and of ad-bearing executions, and whether it is the analysed brand, a configured competitor, or neither. The relationship is resolved live from the brand URL/aliases/owned sources and the competitors names/aliases/URLs, so editing that configuration relabels history.
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)
ownership?array<>Keep only advertisers with these relationships to the analysed brand. Resolved live from the brand URL/aliases/owned sources and the configured competitors names/aliases/URLs, so it reflects the current configuration.
sortBy?stringSort field for the leaderboard
"ads""ads""executions""creatives""lastSeen"offset?numberRow offset for pagination
0 <= value0Advertiser leaderboard
application/json- response
advertisers*array<>total*numberDistinct advertisers matching the filters
totalAds*numberAd cards in scope, the denominator behind shareOfAds
executionsWithAds*numberAd-bearing executions in scope, the denominator behind shareOfAdExecutions
curl -X GET 'https://api.getmint.ai/api/domains/3fa85f64-5717-4562-b3fc-2c963f66afa6/ads/advertisers'{ "advertisers": [ { "advertiserKey": "nike.com", "advertiserDomain": "nike.com", "displayName": "Nike", "ownership": "competitor", "adCount": 218, "executionCount": 154, "creativeCount": 12, "shareOfAds": 18.57, "shareOfAdExecutions": 39.9, "firstSeenAt": "2026-05-02T09:14:00.000Z", "lastSeenAt": "2026-05-25T10:30:00.000Z" } ], "total": 42, "totalAds": 1174, "executionsWithAds": 386}