list_local_places liste les établissements qui apparaissent dans la carte attachée aux réponses d'un projet. Quand un prompt porte une intention locale (« meilleure boulangerie à Nice »), ChatGPT et Google AI Overview renvoient une liste d'établissements à côté du texte. Chaque ligne agrège un établissement sur la période : nombre de cartes où il apparaît, rang moyen, note et nombre d'avis, coordonnées quand le moteur les donne.

L'objet summary porte la visibilité locale dans son ensemble : un seul appel répond à la fois à « qui est sur la carte » et « où j'en suis ».

Quand l'utiliser

Dès que la question porte sur un lieu physique plutôt que sur un site : « est-ce que je sors dans la carte quand on demande un plombier à Lyon ? », « quels concurrents passent devant moi ? », « ma note est-elle en dessous de celles que l'IA recommande ? ».

Deux chiffres de la synthèse désignent ce qu'il faut corriger. citedNotInMap compte les réponses où la marque est nommée dans le texte mais absente de la carte : c'est la fiche d'établissement qui est en cause (mauvaise catégorie, profil non vérifié, adresse manquante). inMapNotCited compte l'inverse, où la fiche est bonne mais le contenu que le moteur cite ne parle jamais de la marque.

Seuls ChatGPT et Google AI Overview renvoient une carte. Les autres moteurs sont ignorés dans filters.llms : demander Perplexity renvoie une page vide, pas une erreur.

Input

Champ	Type	Défaut	Description
`projectId`	string (CUID)	requis	Projet interrogé.
`cursor`	string	-	Curseur opaque issu d'un `pageInfo.nextCursor` précédent.
`limit`	entier	20	De 1 à 100.
`filters.dateRange.from`	date/datetime	il y a 30 jours	Date ou datetime ISO 8601.
`filters.dateRange.to`	date/datetime	maintenant	Date ou datetime ISO 8601.
`filters.llms`	enum[]	moteurs à carte	Seuls `CHATGPT` et `GOOGLE_AIO` produisent une carte.
`filters.promptIds`	string[] (CUID)	-	Ne compter que les cartes produites par ces prompts.
`filters.brandOnly`	booléen	false	Ne garder que la fiche de la marque suivie.
`sortBy`	enum	`appearances_desc`	`appearances_desc`, `rank_asc`, `reviews_desc`, `name_asc`.

Réponse

data porte une ligne par établissement, pageInfo l'enveloppe de pagination habituelle, summary la visibilité locale de la période. Les deltas comparent la période demandée à la fenêtre précédente de même durée. lat et lng sont nuls sur Google AI Overview, qui ne renvoie pas de coordonnées.

{
  "data": [
    {
      "id": "chatgpt:boulangerie-durand-nice",
      "name": "Boulangerie Durand",
      "domain": "boulangerie-durand.fr",
      "url": "https://boulangerie-durand.fr",
      "isBrand": true,
      "appearances": 14,
      "avgRank": 2.3,
      "rating": 4.6,
      "reviewCount": 312,
      "lat": 43.7009,
      "lng": 7.2683
    }
  ],
  "pageInfo": { "hasMore": true, "nextCursor": "20", "totalCount": 37 },
  "summary": {
    "periodFrom": "2026-08-23T00:00:00.000Z",
    "periodTo": "2026-09-22T00:00:00.000Z",
    "totalResults": 60,
    "mapCount": 21,
    "presence": 67,
    "presenceDelta": 12,
    "avgRank": 2.3,
    "avgRankDelta": -0.4,
    "anchor": { "city": "Nice", "share": 82 },
    "brandRating": 4.6,
    "brandReviewCount": 312,
    "medianRating": 4.4,
    "medianReviewCount": 180,
    "topCategory": "Bakery",
    "citedNotInMap": 3,
    "inMapNotCited": 5,
    "placesWithoutCoords": 4,
    "promptsWithMaps": 9,
    "ignoredMaps": 2
  }
}

presence est la part des cartes où la marque apparaît, en pourcentage. avgRank est sa position moyenne quand elle y est : un avgRankDelta négatif est donc une progression. anchor est la ville sur laquelle les moteurs répondent vraiment, avec sa part des fiches. Quand ce n'est pas la ville visée, ce sont les prompts qui pointent ailleurs.

Projet sans clients sur place

Quand le réglage Clients sur place du projet est désactivé, le tool ne lit rien et renvoie une liste vide avec la raison :

{
  "data": [],
  "pageInfo": { "hasMore": false, "nextCursor": null, "totalCount": 0 },
  "summary": { "localDisabled": true }
}

Conseils et patterns

ignoredMaps compte les cartes écartées de tous les chiffres : leur prompt ne nomme aucun lieu (« meilleure boulangerie près de chez moi »), le moteur répond donc pour la position de l'internaute. Ajoutez la ville à ces prompts pour les mesurer.
Lisez summary en premier. mapCount rapporté à totalResults dit combien de réponses portent seulement une carte : un ratio faible signifie que les prompts ont peu d'intention locale, pas que la visibilité a chuté.
Comparez brandRating à medianRating avant de toucher au contenu. Un établissement noté sous la médiane de la carte remonte rarement à coups de rédaction.
Passez filters.promptIds pour isoler une question, puis appelez get_prompt_result avec include.localPlaces pour lire la carte brute d'une réponse.
sortBy: "rank_asc" montre qui est en tête de carte, appearances_desc montre qui y est le plus souvent. Les deux comptent, et ils s'accordent rarement.
Les id sont stables d'un scan à l'autre : comparer deux appels dit quels établissements sont entrés ou sortis de la carte.

Tools liés

get_prompt_result : la carte brute d'une réponse, via include.localPlaces
list_prompts : les prompts derrière ces cartes
list_competitors : les concurrents nommés dans le texte, au-delà de la carte