---
title: "Radar de prospection d'une commune ou d'un département"
method: GET
path: "/departements/{departement}/radar"
---

# Radar de prospection d'une commune ou d'un département

`GET /departements/{departement}/radar`

## Request

- Base URL: `https://pillr.fr/api/v1`
- URL: `https://pillr.fr/api/v1/departements/{departement}/radar`
- Auth: HTTP bearer

Radar de prospection mensuel d'une commune, ou de toutes les communes d'un département classées par score : score sur 100, rang dans le département, cinq blocs (vendeurs sans agence, mandats qui patinent, absence d'agence dominante, parc immobile, signaux amont) et leur détail (pression des DPE, vente directe, mandats essoufflés, stock, agences présentes, part du leader et concentration, exclusifs, prix au m² médian, durée médiane, baisses). Le dernier mois calculé, ou le mois demandé. Des agrégats communaux, sans adresse ni nom. Liste paginée. Coût : 3 crédits par élément rendu.

## Path parameters

- `departement` string, required: Code du département (01 à 95, 2A, 2B, 971 à 976).

## Response `200`

Réponse servie et débitée (sauf réponse identique déjà servie dans les 24 h).

- object
  - `mois` string, nullable, required: Mois du radar servi, AAAA-MM.
  - `perimetre` object, required
    - `niveau` 'commune' | 'departement', required
    - `code` string, required
  - `donnees` object[], required
    - `insee` string, required
    - `commune` string, nullable, required
    - `score` number, nullable, required: Score de prospection sur 100.
    - `rang_departement` integer, nullable, required
    - `blocs` object, required
      - `gisement` number, nullable, required: Vendeurs sans agence (percentile).
      - `essoufflement` number, nullable, required: Mandats en place qui patinent (percentile).
      - `ouverture` number, nullable, required: Aucune agence ne tient le secteur (percentile).
      - `dormant` number, nullable, required: Parc immobile (percentile).
      - `amont` number, nullable, required
    - `detail` object, nullable, required
      - `pression_dpe_idx` number, nullable, required
      - `dpe_mois` number, nullable, required
      - `dpe_attendu` number, nullable, required
      - `dpe_passoires` number, nullable, required
      - `vente_directe` number, nullable, required
      - `vente_directe_pct` number, nullable, required
      - `mandats_essoufles` number, nullable, required
      - `stock` number, nullable, required
      - `agences_presentes` number, nullable, required
      - `part_leader` number, nullable, required
      - `concentration_hhi` number, nullable, required
      - `exclusifs_pct` number, nullable, required
      - `prix_m2_median` number, nullable, required
      - `duree_mediane_j` number, nullable, required
      - `baisses_pct` number, nullable, required
  - `qualite` object, required: Ce qui permet de juger la valeur : nombre, provenance, incertitude, drapeaux, date et source.
    - `n` integer, nullable, required: Nombre d'observations derrière la valeur ; null si sans objet.
    - `provenance` 'mesure' | 'estime', nullable, required: mesure : observé sur la donnée ; estime : modèle, barème ou imputation ; null : sans objet.
    - `incertitude` object, nullable, required: Incertitude de la valeur : fourchette et demi-largeur.
      - `demi_largeur_pct` number, nullable, required: Demi-largeur de la fourchette, en % de la valeur.
      - `bas` number, nullable, required
      - `haut` number, nullable, required
    - `drapeaux` string[], required: Ce qui doit faire lire la valeur avec prudence ; vide si rien.
    - `methode` string, nullable, required: Méthode de calcul ou de rattachement, en clair.
    - `donnees_du` string, nullable, required: Date de la donnée (AAAA-MM-JJ ou horodatage ISO 8601).
    - `source` string, required: Source publique ou moteur Pillr, en clair.
  - `donnees_du` string, nullable, required
  - `curseur_suivant` string, nullable, required: Curseur de la page suivante, à repasser dans curseur ; null sur la dernière page.
  - `credits` object, required: Crédits débités par cet appel (réservés, pour une tâche en cours), et crédits encore utilisables ce mois avant la coupure : crédits offerts, crédits inclus du mois et crédits facturables sous le plafond de dépense (null si inconnus ou en bac à sable).
    - `debites` integer, required
    - `restants` integer, nullable, required

## Other responses

- `304`: Non modifiée depuis l'ETag fourni : rien n'est débité.
- `400`: Paramètres invalides ; Curseur invalide
- `401`: Clé d'API absente
- `402`: Crédits insuffisants ; Carte requise ; Plafond mensuel de dépense atteint
- `403`: Portée insuffisante
- `404`: Ressource absente : rien n'est débité
- `429`: Trop de requêtes par minute
- `500`: Erreur interne
- `503`: API indisponible ; Donnée momentanément indisponible ; Opération coupée sur ce créneau

---

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