Rank the places a domain is named at
Ranks the places LLM answers named a brand at — a hotel property, a store, a branch. `groupBy` selects the axis: `entity` (default) is one row per distinct naming, the rest roll it up onto a single dimension. Rows exist only for organizations with brand entity extraction enabled.
Session JWT signed with HS256. Verification pins the algorithm and rejects expired tokens, per RFC8725.
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)
Which axis to rank on. entity (default) is one row per distinct naming — brand plus the place it was named at, e.g. "ibis Porte de la Chapelle". The rest roll that up onto a single dimension.
"entity"Value in
- "entity"
- "country"
- "city"
- "locality"
- "brand"
Restrict to one side of the brand split. Applied before grouping, so a rollup row counts only the segment asked for.
"all"Value in
- "all"
- "ourbrand"
- "competitor"
Case-insensitive substring match on the row label.
Keep only namings at one place, by the folded country|city|locality key the geo rollup returns for it. Applied before grouping, so groupBy=brand answers "which brands are named at this place".
Keep only namings of one establishment, by the propertyKey a geo point or entity row returns. An empty string keeps only the namings that named no establishment, which is what a place marker on the map stands for.
Column to sort on.
"mentions"Value in
- "mentions"
- "mentionRate"
- "name"
Sort direction.
"desc"Value in
- "asc"
- "desc"
Response Body
application/json
curl -X GET "https://example.com/api/domains/string/mention-entities"{ "data": [ { "groupKey": "ibis", "displayName": "ibis", "locationKey": "FR|paris|porte de la chapelle", "propertyName": "ibis Paris Porte de la Chapelle", "propertyKey": "FR|paris|ibis paris porte de la chapelle", "ownership": "ourbrand", "countryCode": "FR", "cityText": "Paris", "localityText": "Porte de la Chapelle", "mentions": 1284, "mentionRate": 38.4 } ], "total": 42, "page": 1, "limit": 50, "answersInScope": 3342, "segmentCounts": { "all": 10, "ourbrand": 5, "competitor": 5 }}