API Reference
Visibility of a topic: the tracked and top brands with their level, 95% range, tier and share of voice, the brand series over the period and the Shift days
X-API-Key<token>
API Key for programmatic access
In: header
Path Parameters
domainId*string
Domain ID
topicId*string
Topic ID
Query Parameters
period?string
Days of history returned, counted back from the last measured day; ignored when from and to are given
Value in
- "30d"
- "60d"
- "90d"
- "6m"
from?string
First day of a custom range, YYYY-MM-DD; goes with to, at least 14 days before it
to?string
Last day of a custom range, YYYY-MM-DD; the range covers at most 182 days
model?string
One model of the topic, as listed in modelsMix; every model pooled when omitted
Response Body
application/json
curl -X GET "https://example.com/api/v2/domains/507f1f77bcf86cd799439011/topics/507f1f77bcf86cd799439012/visibility"{ "domainId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", "topicId": "3fa85f64-5717-4562-b3fc-2c963f66afa7", "period": "30d", "status": "established", "lastDay": "2026-10-06", "livePrompts": 76, "computedAt": "2026-10-06T10:30:00.000Z", "brands": [ { "brandKey": 12, "name": "Samsung", "isOwn": false, "isCompetitor": true, "mentions": 41, "answers": 228, "sharePct": 11.7, "shareRange95": 1.6, "level": 28.7, "range95": 2.6, "verdict": "stable", "level14d": 27, "range9514d": 2.5, "tier": 1, "calibratingDay": 14, "shareTier": 2 } ], "brandsTotal": 46, "series": [ { "day": "2026-10-05", "level": 26.6, "range95": 2.5, "dailyRate": 23.4, "answers": 228, "livePrompts": 76, "shiftDay": false, "provisional": false, "calibratingDay": 14, "move": "calibrating", "refDay": "2026-09-21" } ], "shifts": [ { "day": "2026-09-08", "attribution": "engine", "meanChangePts": -5, "z": -4.2 } ], "modelsMix": [ { "model": "gpt-interface", "answers": 1311, "sharePct": 31.8 } ]}