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.
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)
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.
Sort field for the leaderboard
"ads"Value in
- "ads"
- "executions"
- "creatives"
- "lastSeen"
Row offset for pagination
0 <= value0Response Body
application/json
curl -X GET "https://example.com/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}