---
title: "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`."
method: POST
path: "/v1/ai-visibility/scan"
tags: ["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-Key` string

## Request body

- object

## Response `200`

OK

- object
  - `data` unknown
  - `pagination` object
  - `meta` object

## Other responses

- `400`: Requête invalide (`invalid_body`, `invalid_query`)
- `401`: Clé API invalide
- `402`: Crédits insuffisants (`insufficient_credits`, avec `required` et `balance`)
- `404`: Ressource introuvable (`place_not_found`, fiche ou scan inconnu)
- `409`: Conflit d'état (déjà publié, déjà répondu, mauvais statut) ou `Idempotency-Key` réutilisée avec un autre corps (`idempotency_key_reused`) / requête encore en cours (`idempotency_in_flight`)
- `429`: Rate limit (headers X-RateLimit-*, Retry-After)
- `503`: Fournisseur de données indisponible (`upstream_unavailable`)

---

[API](https://skmtc.dev/localnord/apis/localnord-api.md) · [All operations](https://skmtc.dev/localnord/apis/localnord-api/llms.txt) · [OpenAPI document](https://skmtc.dev/localnord/apis/localnord-api/revisions/d061ddba21c6?raw)