---
title: "Aperçu gratuit de la grille qu'un scan couvrirait (points sur terre uniquement) : mode smart avec `radius_km`, ou grille personnalisée `shape` + `diameter_km` + `density`. Aucune donnée écrite."
method: GET
path: "/v1/rankings/grid-preview"
tags: ["Classements"]
---

# Aperçu gratuit de la grille qu'un scan couvrirait (points sur terre uniquement) : mode smart avec \`radius_km\`, ou grille personnalisée \`shape\` + \`diameter_km\` + \`density\`. Aucune donnée écrite.

`GET /v1/rankings/grid-preview`

## Request

- Base URL: `https://app.localnord.io/api`
- URL: `https://app.localnord.io/api/v1/rankings/grid-preview`
- Auth: HTTP bearer

## Query parameters

- `query` string

## Response `200`

OK

- unknown

## 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)