---
title: "Bien dédoublonné et toutes ses annonces"
method: GET
path: "/annonces/{id}/bien"
---

# Bien dédoublonné et toutes ses annonces

`GET /annonces/{id}/bien`

## Request

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

Le bien unique derrière ses annonces, tous portails et toutes périodes confondus, par son identifiant ou par celui d'une de ses annonces : toutes les annonces rattachées, actives et retirées, avec leur vendeur (professionnel nommé) ; verdict et méthode du rattachement, servis tels quels, indécis compris ; clés d'identité et empreintes des photos ; agrégat (statut, agences, portails, republications, prix minimal, maximal et dernier) ; journal de certification des doublons. Rien n'est débité si le bien est inconnu. Coût : 3 crédits par appel réussi.

## Path parameters

- `id` string, required: Identifiant de l'annonce : lbc:<numéro>, bienici:<identifiant>, seloger:<numéro> ou identifiant Pillr.

## Response `200`

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

- object
  - `bien_uid` string, required
  - `verdict` string, nullable, required: Verdict du dédoublonnage pour l'annonce qui ancre le bien : rattachee, nouvelle ou indecise (servi tel quel).
  - `methode` string, nullable, required: Méthode du rattachement de l'annonce qui ancre le bien ; chaque annonce porte la sienne.
  - `ancre_id` string, nullable, required: Annonce du lac qui ancre le bien.
  - `decide_le` string, nullable, required
  - `annonces` object[], required
    - `id_lac` string, required
    - `id_portail` string, nullable, required
    - `lien` string, nullable, required
    - `source` string, nullable, required
    - `prix` number, nullable, required
    - `actif` boolean, nullable, required
    - `parue_le` string, nullable, required
    - `vue_le` string, nullable, required
    - `retiree_le` string, nullable, required
    - `verdict` string, nullable, required
    - `methode` string, nullable, required
    - `type_vendeur` 'pro' | 'particulier' | 'inconnu', required: Statut du vendeur déclaré par le portail : pro (agence, réseau, promoteur), particulier, ou inconnu.
    - `annonceur` object, required: Le vendeur : un professionnel est nommé, un particulier jamais.
      - `type_vendeur` 'pro' | 'particulier' | 'inconnu', required: Statut du vendeur déclaré par le portail : pro (agence, réseau, promoteur), particulier, ou inconnu.
      - `nom` string, nullable, required: Nom de l'agence ou du professionnel tel que le portail l'affiche ; null pour un particulier.
      - `enseigne` string, nullable, required: Enseigne ou réseau du professionnel ; null pour un particulier.
      - `siren` string, nullable, required: SIREN du professionnel quand le portail le publie ; null pour un particulier.
  - `cles` object[], nullable, required: Clés d'identité des annonces (code postal, typologie, prix, empreinte de description) ; null si la vue des clés n'est pas encore publiée.
    - `id_lac` string, required
    - `cp` string, nullable, required
    - `tn` string, nullable, required
    - `pn` string, nullable, required
    - `dh` string, nullable, required
  - `empreintes_photo` object[], nullable, required: Empreintes perceptuelles des photos ; null si la lecture a échoué.
    - `id_lac` string, required
    - `rang` integer, required
    - `phash` string, nullable, required
    - `photo` string, nullable, required
  - `agregat` object, required
    - `statut` 'en_vente' | 'retire', required
    - `nb_annonces` integer, required
    - `nb_agences` integer, required
    - `nb_portails` integer, required
    - `nb_republications` integer, nullable, required
    - `prix_min` number, nullable, required
    - `prix_max` number, nullable, required
    - `dernier_prix` number, nullable, required
    - `ecart_prix_pct` number, nullable, required
    - `premiere_parution` string, nullable, required
  - `certifications` object[], required
    - `id_lac` string, required
    - `regle` string, nullable, required
    - `verdict_avant` string, nullable, required
    - `applique_le` string, nullable, required
    - `annule_le` string, 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.
  - `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)