Aggregate mentions geographically for the heatmap
Returns two independent layers. `countries` needs no geocoding and always renders; `points` carries coordinates only for places the geocoder has resolved, and reports how many are still unlocated rather than dropping them.
AuthorizationBearer <JWT>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)
segment?stringRestrict the map to one side of the brand split.
"all""all""ourbrand""competitor"brandName?stringRestrict the map to a single brand, as the analyzer resolved it. Narrower than segment, and used to look at one competitor rather than all of them at once.
Country and point layers for the map
application/json- response
topicHotel*|nullThe topic's own establishment, pinned even when no answer named it.
countries*array<>Per-country totals. Always present — this layer needs no geocoding.
points*array<>Distinct places, most-named first.
totalMentions*numberTotal distinct answers behind the country layer.
locatedPoints*numberPlaces carrying coordinates.
unlocatedPoints*numberPlaces with no coordinates yet. Surfaced rather than hidden so the UI can state how much of the data the map is not plotting.
curl -X GET 'https://api.getmint.ai/api/domains/string/mention-entities/geo'{ "topicHotel": { "name": "Novotel Paris Centre Tour Eiffel", "address": "61 Quai de Grenelle, 75015 Paris", "latitude": 48.8496, "longitude": 2.2834, "placeId": "ChIJLU7jZClu5kcR4PcOOO6p3I0", "listing": { "mapsUrl": "https://www.google.com/maps/place/?q=place_id:ChIJLU7jZClu5kcR4PcOOO6p3I0", "title": "ibis Paris Porte de la Chapelle", "address": "5 Rue Pierre de Coubertin, 75018 Paris", "category": "Hotel", "rating": 4.1, "reviewsCount": 2341 }, "mentions": 52, "mentionRate": 41.2, "placeBlockAnswers": 14, "byModel": [ { "model": "gpt-interface", "mentions": 31, "placeBlockAnswers": 9, "avgPosition": 1.8 } ] }, "countries": [ { "countryCode": "FR", "mentions": 1284 } ], "points": [ { "locationKey": "FR|paris|porte de la chapelle", "displayName": "ibis Paris Porte de la Chapelle", "propertyKey": "FR|paris|ibis paris porte de la chapelle", "propertyName": "ibis Paris Porte de la Chapelle", "brandName": "ibis", "countryCode": "FR", "cityText": "Paris", "localityText": "Porte de la Chapelle", "latitude": 48.8967, "longitude": 2.3597, "precision": "locality", "mentions": 249, "isTopicHotel": false, "placeId": "ChIJLU7jZClu5kcR4PcOOO6p3I0" } ], "totalMentions": 3342, "locatedPoints": 412, "unlocatedPoints": 88}