Topic moves of a domain over a period: each topic's own-brand level at the start and at the end of the period, with the ranges deciding whether the move is real, the biggest move first
The period counts back from the last measured day across the topics in scope. One selected model reads its stored slice; none or several read the pooled one. Tags do not narrow this read.
X-API-Key<token>API Key for programmatic access
domainId*stringDomain ID
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)
marketLanguageCodePairId?stringKeeps the topics of one market and language pair of the domain
application/json- response
domainId*stringperiod?|The preset read; null on a custom range
from?|First day of the period read; null when the domain has no measured topic
to?|Last day of the period read; null when the domain has no measured topic
kind*stringWhat the biggest move is: steady when no topic moved past its ranges
"drop""gain""steady"move?|nullThe biggest move, a real one before a probable one and a drop before a gain; null when steady
topics*numberTopics of the domain in scope, measured or not
moves*array<>Every topic with two readings in the period, the biggest move first
curl -X GET 'https://api.getmint.ai/api/v2/domains/507f1f77bcf86cd799439011/visibility/moves'{ "domainId": "507f1f77bcf86cd799439011", "period": "30d", "from": "2026-07-08", "to": "2026-10-05", "kind": "gain", "move": { "topicId": "507f1f77bcf86cd799439012", "topic": "Running shoes", "from": { "day": "2026-07-08", "level": 32.4, "range95": 4.1 }, "to": { "day": "2026-07-08", "level": 32.4, "range95": 4.1 }, "deltaPts": 12.3, "verdict": "stable", "prompts": 42 }, "topics": 3, "moves": [ { "topicId": "507f1f77bcf86cd799439012", "topic": "Running shoes", "from": { "day": "2026-07-08", "level": 32.4, "range95": 4.1 }, "to": { "day": "2026-07-08", "level": 32.4, "range95": 4.1 }, "deltaPts": 12.3, "verdict": "stable", "prompts": 42 } ]}