Each prompt of a topic ranked by the share of its answers naming the brand over the period
Answers and own-brand mentions summed per prompt over the period, on the models asked for (every model when none), the tagged prompts under a tag filter. Prompts with no answer over the period are left out.
X-API-Key<token>API Key for programmatic access
domainId*stringDomain ID
topicId*stringTopic ID
tagIds?stringTags of the domain, comma-separated: the numbers are then read over the prompts carrying any of them, the levels pooled from those prompts alone; every prompt when omitted. A tag that carries no prompt of the topic reads nothing
period?stringDays of history returned, counted back from the last measured day; ignored when from and to are given
"60d""30d""60d""90d""6m"from?stringFirst day of a custom range, YYYY-MM-DD; goes with to, at least 14 days before it
to?stringLast day of a custom range, YYYY-MM-DD; the range covers at most 182 days
models?stringModels of the topic, comma-separated, as listed in modelsMix; every model pooled when omitted. One model, or every model of the mix, reads the stored slice; any other combination is derived from the single-model slices (see the derived flag)
application/json- response
period?|The preset read, null for a custom from/to range
from?|First day counted, null when the topic was never measured
to?|Last day counted, null when the topic was never measured
prompts*array<>Prompts answered over the period on the models covered, the tagged ones under a tag filter, by share of answers naming the brand, highest first
models*array<string>The models the numbers cover, sorted: every model of the mix when none was asked for
derived*booleanTrue when two or more models of the mix, not all, were asked for: the counts are then summed over those models
curl -X GET 'https://api.getmint.ai/api/v2/domains/507f1f77bcf86cd799439011/topics/507f1f77bcf86cd799439012/visibility/prompts/ranking'{ "period": "30d", "from": "2026-10-12", "to": "2026-11-10", "prompts": [ { "promptId": "3fa85f64-5717-4562-b3fc-2c963f66afa8", "prompt": "Best running shoes for a marathon?", "answers": 42, "mentions": 17, "ratePct": 40, "models": [ "gemini-interface", "gpt-interface" ] } ], "models": [ "gemini-interface", "gpt-interface" ], "derived": false}