---
title: "Pige complète : annonces actives et retirées du lac"
method: GET
path: "/annonces/archives"
---

# Pige complète : annonces actives et retirées du lac

`GET /annonces/archives`

## Request

- Base URL: `https://pillr.fr/api/v1`
- URL: `https://pillr.fr/api/v1/annonces/archives`
- Auth: HTTP bearer

Toutes les annonces collectées par Pillr, actives et retirées, analysées ou non, avec les champs du portail et la vie de l'annonce (jours en ligne, baisses, republications, retrait) : par commune, code postal, département, point et rayon, ou SIREN d'agence, filtrées par type, prix, surface, dates de parution et de retrait, statut, portail, type de vendeur et baisse de prix. Le fonds pige et le fonds scraper_lbc servent les archives figées de l'ancienne pige et de l'ancien balayage Leboncoin, sans code INSEE, date de retrait ni statut actuel (un filtre qu'un fonds ne connaît pas est refusé sans débit).Un vendeur professionnel est servi en entier ; un particulier jamais par son nom ni ses coordonnées. Lecture lourde : servie depuis la mémoire seulement entre 20h30 et minuit. Un crédit par annonce rendue. Coût : 1 crédit par élément rendu.

## Query parameters

- `fonds` 'lac' | 'pige' | 'scraper_lbc': lac (défaut) : toutes les annonces balayées par Pillr ; pige et scraper_lbc : archives figées de l'ancienne pige et de l'ancien balayage Leboncoin.
- `insee` union: Code INSEE d'une commune, ou liste de 10 codes au plus (paramètre répété).
  - string: Code INSEE de la commune ou de l'arrondissement (5 caractères, 2A ou 2B pour la Corse).
  - string[]
- `cp` union: Code postal, ou liste de 10 codes au plus.
  - string: Code postal.
  - string[]
- `departement` union: Code de département, ou liste de 8 codes au plus.
  - string: Code du département (01 à 95, 2A, 2B, 971 à 976).
  - string[]
- `lat` number: Latitude du point de recherche (avec lon et rayon_km).
- `lon` number: Longitude du point de recherche (avec lat et rayon_km).
- `rayon_km` number: Rayon autour du point, en km (50 au plus).
- `siren` string
- `type` 'appartement' | 'maison' | 'immeuble': Type de bien : appartement, maison ou immeuble entier.
- `prix_min` number
- `prix_max` number
- `surface_min` number
- `surface_max` number
- `publie_apres` string: Parues à partir de cette date (AAAA-MM-JJ).
- `publie_avant` string: Parues avant cette date.
- `retire_apres` string: Retirées à partir de cette date.
- `retire_avant` string: Retirées avant cette date.
- `statut` 'active' | 'retiree' | 'toutes': toutes par défaut.
- `source` 'lbc' | 'bienici' | 'seloger' | 'zefir'
- `type_vendeur` 'pro' | 'particulier' | 'inconnu': Statut du vendeur déclaré par le portail : pro (agence, réseau, promoteur), particulier, ou inconnu.
- `avec_baisse` union: Vrai : seulement les annonces dont le prix a baissé.
  - boolean
  - string
- `tri` 'date' | 'prix' | 'prix_desc': date (défaut, plus récentes d'abord), prix, prix_desc.
- `limite` integer: Nombre d'éléments par page (50 au plus).
- `curseur` string: Curseur opaque rendu par la page précédente (curseur_suivant), à repasser tel quel.
- `champs` union: Champs rendus, séparés par des virgules (« prix,surface,analyse.score ») ; tous si absent.
  - string
  - string[]

## Response `200`

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

- object
  - `donnees` object[], required
    - `id` string, required: Identifiant de l'annonce dans son fonds (lac : identifiant du lac ; archives : identifiant chez le portail).
    - `fonds` 'lac' | 'pige' | 'scraper_lbc', required
    - `id_portail` string, nullable
    - `lien` string, nullable
    - `source` string, nullable
    - `titre` string, nullable
    - `description` string, nullable
    - `type` string, nullable
    - `neuf_ancien` string, nullable
    - `prix` number, nullable
    - `prix_m2` number, nullable
    - `surface` number, nullable
    - `sejour_m2` number, nullable
    - `pieces` number, nullable
    - `chambres` number, nullable
    - `salles_de_bain` number, nullable
    - `salles_d_eau` number, nullable
    - `etage` number, nullable
    - `nb_etages` number, nullable
    - `terrain_m2` number, nullable
    - `annee_construction` number, nullable
    - `insee` string, nullable
    - `code_postal` string, nullable
    - `commune` string, nullable
    - `departement` string, nullable
    - `region` string, nullable
    - `lat` number, nullable
    - `lon` number, nullable
    - `precision` string, nullable
    - `dpe` string, nullable
    - `dpe_valeur` number, nullable
    - `ges` string, nullable
    - `ges_valeur` number, nullable
    - `equipements` object
      - `ascenseur` boolean, nullable, required
      - `balcon` boolean, nullable, required
      - `terrasse` boolean, nullable, required
      - `jardin` boolean, nullable, required
      - `cave` boolean, nullable, required
      - `piscine` boolean, nullable, required
      - `parking` boolean, nullable, required
      - `garage` boolean, nullable, required
      - `meuble` boolean, nullable, required
      - `cuisine_equipee` boolean, nullable, required
      - `chauffage` string, nullable, required
      - `chauffage_mode` string, nullable, required
      - `orientation` string, nullable, required
    - `charges_annuelles` number, nullable
    - `taxe_fonciere` number, nullable
    - `prix_hors_honoraires` number, nullable
    - `honoraires` number, nullable
    - `honoraires_a_charge` string, nullable
    - `frais_notaire_estimes` number, nullable
    - `budget_energie_min` number, nullable
    - `budget_energie_max` number, nullable
    - `lots_copro` number, nullable
    - `en_copro` boolean, nullable
    - `type_vendeur` 'pro' | 'particulier' | 'inconnu': Statut du vendeur déclaré par le portail : pro (agence, réseau, promoteur), particulier, ou inconnu.
    - `annonceur` object: Le vendeur : un professionnel est servi en entier (nom, enseigne, SIREN, mandat, coordonnées professionnelles), 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
      - `enseigne` string, nullable, required
      - `siren` string, nullable, required
      - `mandat` string, nullable, required: Type de mandat publié (simple, exclusif) ; null si inconnu.
      - `telephone` string, nullable, required: Téléphone professionnel publié par le portail ; jamais celui d'un particulier.
      - `email` string, nullable, required: Adresse électronique professionnelle publiée par le portail ; jamais celle d'un particulier.
    - `photos` string[]
    - `vignette` string, nullable
    - `visite_virtuelle` boolean, nullable
    - `premiere_parution` string, nullable
    - `premiere_parution_estimee` boolean, nullable
    - `vue_le` string, nullable
    - `retiree_le` string, nullable
    - `actif` boolean, nullable
    - `jours_en_ligne` integer, nullable
    - `nb_baisses` integer, nullable
    - `baisse_totale_pct` number, nullable
    - `nb_republications` integer, nullable
    - `bien_uid` string, nullable
    - `etat` string, nullable: État du bien déclaré par le portail.
    - `drapeaux` string[]: Ce qui doit faire lire l'annonce avec prudence ; vide si rien.
  - `notes` string[], 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.
  - `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)