---
title: "Mon secteur en 30 secondes"
method: GET
path: "/codes-postaux/{cp}/secteur"
---

# Mon secteur en 30 secondes

`GET /codes-postaux/{cp}/secteur`

## Request

- Base URL: `https://pillr.fr/api/v1`
- URL: `https://pillr.fr/api/v1/codes-postaux/{cp}/secteur`
- Auth: HTTP bearer

Pour un code postal, les deux signaux de la page « Mon secteur » de pillr.fr : les adresses en pré-marché pur (DPE individuel de moins de 90 jours, ni en vente ni vendues depuis, dont les passoires F et G), et les particuliers qui vendent seuls depuis plus de 50 jours et sont encore en ligne, dont ceux qui ont baissé leur prix ; avec detail=true, la liste de leurs annonces, sans le nom ni les coordonnées du vendeur. Sans annonce de particulier dans le code postal, le compte passe au département et le dit. Coût : 2 crédits par appel réussi.

## Path parameters

- `cp` string, required: Code postal.

## Query parameters

- `detail` 'true' | 'false': true : la liste des annonces de particuliers.

## Response `200`

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

- object
  - `cp` string, required
  - `commune` string, nullable, required: La commune la plus peuplée de ce code postal.
  - `departement` string, required
  - `pre_marche_pur` object, required
    - `n` integer, required: Adresses à DPE individuel de moins de 90 jours, ni en vente ni vendues depuis.
    - `passoires` integer, required: Dont étiquette F ou G.
    - `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.
  - `particuliers` object, required
    - `echelle` 'secteur' | 'departement', required: departement quand le code postal n'a aucune annonce de particulier ouverte depuis assez longtemps.
    - `n_plus_50_jours` integer, required
    - `duree_moyenne_jours` integer, required
    - `n_avec_baisse` integer, required
    - `annonces` object[], nullable, required: Les annonces elles-mêmes, avec detail=true ; jamais le nom ni les coordonnées du vendeur.
      - `id` string, nullable, required
      - `lien` string, nullable, required: Lien d'origine de l'annonce, servi quand la clé porte la portée lien_origine.
      - `titre` string, nullable, required
      - `prix` number, nullable, required
      - `surface` number, nullable, required
      - `commune` string, nullable, required
      - `parue_depuis_jours` integer, required
      - `derniere_baisse_le` string, nullable, required
      - `type_vendeur` 'particulier', 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.
  - `calcule_le` string, nullable, required
  - `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
- `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

---

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