---
title: "Lance une analyse (asynchrone). Fiche connectée : `listing_id` (cooldown 24 h, gratuit). Commerce non connecté : `place_id` → 10 crédits, remboursés si l'analyse échoue, cooldown 24 h par cible. Plafond mensuel par organisation (429). Fin signalée par le webhook `citations.completed`."
method: POST
path: "/v1/citations/scan"
tags: ["Citations locales (annuaires)"]
---

# Lance une analyse (asynchrone). Fiche connectée : \`listing_id\` (cooldown 24 h, gratuit). Commerce non connecté : \`place_id\` → 10 crédits, remboursés si l'analyse échoue, cooldown 24 h par cible. Plafond mensuel par organisation (429). Fin signalée par le webhook \`citations.completed\`.

`POST /v1/citations/scan`

## Request

- Base URL: `https://app.localnord.io/api`
- URL: `https://app.localnord.io/api/v1/citations/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)