Visibilité IA (GEO)

Lance un scan (asynchrone, 1-2 min). Fiche connectée — `{ "listing_id": ":id", "paid": false }` : mots-clés de la fiche, cooldown 7 j (pendant la fenêtre, renvoie status "skipped" + next_scan_at sans rien lancer), `paid: true` force la relance et débite 5 crédits. Commerce non connecté — `{ "place_id": "ChIJ…", "keywords": ["boulangerie lyon"] }` (1 à 5 mots-clés, obligatoires — sinon `400 invalid_body`) : 5 crédits par scan, sans cooldown, remboursés si le scan échoue. Fin signalée par le webhook `ai_visibility.completed`.

post/v1/ai-visibility/scan

Request

  • Base URL: https://app.localnord.io/api
  • URL: https://app.localnord.io/api/v1/ai-visibility/scan
  • Auth: HTTP bearer

Headers

Idempotency-Keystring

Header optionnel "Idempotency-Key" (≤ 200 caractères) sur les endpoints marqués « Idempotency-Key supporté » : portée clé API × endpoint, conservé 24 h. Même clé + même corps → la réponse d'origine est rejouée (statut et body identiques) avec le header Idempotent-Replay: true, sans refaire l'action ni redébiter. Même clé + corps différent → 409 idempotency_key_reused ; requête encore en cours → 409 idempotency_in_flight. Sans header, chaque appel est exécuté.

Request body

object required

Example request

{
  "place_id": "ChIJ…",
  "keywords": [
    "boulangerie lyon"
  ]
}

Response

OK

dataunknown
paginationobject
metaobject

Changes

No recorded changes to this operation across all 1 revision of this API.