---
title: "Vie des annonces d'une zone"
method: GET
path: "/codes-postaux/{cp}/vie-annonces"
---

# Vie des annonces d'une zone

`GET /codes-postaux/{cp}/vie-annonces`

## Request

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

Vie des annonces d'une commune ou d'un code postal, mois par mois : entrées (particuliers, professionnels, exclusifs, maisons, appartements), part nationale, sorties rapides et longues, stock, durée médiane en ligne, prix affiché médian au m², baisses et baisse moyenne, chaque mois marqué comparable ou non selon la stabilisation de la collecte. Pour une zone de plusieurs communes, les comptes s'additionnent et les médianes restent vides. S'y ajoutent la durée en ligne par code postal et type de bien (médiane et quartiles, avec l'effectif) et, sur demande, les évènements des derniers jours : baisses de prix et annonces diffusées par plusieurs agences, par identifiant d'annonce. Coût : 5 crédits par appel réussi.

## Path parameters

- `cp` string, required

## Response `200`

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

- object
  - `zone` object, required
    - `niveau` 'commune' | 'code_postal', required
    - `code` string, required
    - `communes` string[], required
  - `serie` object[], required
    - `mois` string, required
    - `communes` integer, required: Communes de la zone qui portent ce mois.
    - `entrees` number, nullable, required
    - `entrees_particulier` number, nullable, required
    - `entrees_pro` number, nullable, required
    - `entrees_exclusif` number, nullable, required
    - `entrees_maison` number, nullable, required
    - `entrees_appart` number, nullable, required
    - `part_nationale` number, nullable, required
    - `sorties` number, nullable, required
    - `sorties_rapides` number, nullable, required
    - `sorties_longues` number, nullable, required
    - `duree_mediane_j` number, nullable, required: Médiane : servie pour une seule commune, vide pour une zone de plusieurs communes (une médiane ne s'additionne pas).
    - `prix_m2_median` number, nullable, required
    - `baisses` number, nullable, required
    - `baisse_moy_pct` number, nullable, required
    - `stock_fin` number, nullable, required
    - `volumes_comparables` boolean, required
  - `duree_en_ligne` object[], required
    - `code_postal` string, required
    - `type` string, required
    - `n` integer, nullable, required
    - `mediane_j` number, nullable, required
    - `p25_j` number, nullable, required
    - `p75_j` number, nullable, required
    - `fenetre_j` integer, nullable, required
  - `evenements` object[], required
    - `genre` 'baisse_prix' | 'multi_agences', required
    - `annonce_id` string, required
    - `le` string, required
    - `ancien_prix` number, nullable, required
    - `nouveau_prix` number, nullable, required
    - `ecart_pct` number, nullable, required
    - `agences` integer, nullable, required
    - `portails` integer, 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
  - `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)