---
title: "Annonces vues à une adresse"
method: GET
path: "/adresses/{cle_ban}/annonces"
---

# Annonces vues à une adresse

`GET /adresses/{cle_ban}/annonces`

## Request

- Base URL: `https://pillr.fr/api/v1`
- URL: `https://pillr.fr/api/v1/adresses/{cle_ban}/annonces`
- Auth: HTTP bearer

Toutes les annonces de vente rattachées à une adresse BAN, actives et passées : l'annonce concordante (dé-floutée par croisement), l'annonce reconnue par l'empreinte de l'adresse, les annonces reconnues par l'empreinte d'un DPE de l'adresse et celles dont l'adresse résolue tombe à moins de 25 m. Pour chacune : portail, prix, surface, type de vendeur, agence nommée avec son SIREN pour un professionnel, dates de parution et de retrait, baisses de prix, méthode et confiance du rattachement. La réponse dit aussi si l'adresse est en vente et depuis quand. Rien n'est débité quand aucune annonce n'est rattachée à l'adresse. Coût : 3 crédits par appel réussi.

## Path parameters

- `cle_ban` string, required: Clé d'interopérabilité de la Base Adresse Nationale, ex. 69383_1234_00012.

## Query parameters

- `actives_seulement` union: true : seulement les annonces encore en ligne.
  - boolean
  - 'true' | 'false'

## Response `200`

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

- object
  - `cle_ban` string, required
  - `deja_en_vente` boolean, nullable, required
  - `mise_en_vente_le` string, nullable, required
  - `derniere_parution_le` string, nullable, required
  - `annonces` object[], required: Les annonces rattachées, de la plus récente à la plus ancienne parution.
    - `id` string, required: Identifiant de portail (lbc:<numéro>, bienici:<identifiant>, seloger:<numéro>) quand le lien le donne, sinon identifiant du lac de Pillr.
    - `source` string, nullable, required: Portail d'origine.
    - `lien` string, nullable, required: Lien d'origine de l'annonce, servi quand la clé porte la portée lien_origine.
    - `active` boolean, nullable, required
    - `prix` number, nullable, required
    - `surface_m2` number, nullable, required
    - `type_bien` string, nullable, required
    - `type_vendeur` 'professionnel' | 'particulier' | 'inconnu', required
    - `annonceur` object, nullable, required: L'agence ou le professionnel qui publie l'annonce, nommé avec son SIREN ; null pour un particulier, qui n'est jamais nommé.
      - `type_vendeur` 'professionnel' | 'particulier' | 'inconnu', required
      - `nom` string, nullable, required
      - `enseigne` string, nullable, required
      - `siren` string, nullable, required
    - `parue_le` string, nullable, required
    - `retiree_le` string, nullable, required
    - `baisses` object[], required: Baisses de prix relevées sur l'annonce, hors aberrations (chute de plus de moitié, facteur 10).
      - `le` string, required
      - `de` number, required
      - `a` number, required
      - `ecart_pct` number, nullable, required: Écart en %, négatif pour une baisse.
    - `methode` 'concordante' | 'empreinte_adresse' | 'empreinte_dpe' | 'position', required: Comment l'annonce est rattachée à l'adresse.
    - `confiance` number, nullable, required: Confiance du rattachement, de 0 à 1, quand la méthode en donne une.
    - `distance_m` number, nullable, required: Distance entre la position résolue de l'annonce et l'adresse (méthode position).
    - `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)