---
title: "Dossier d'un immeuble pas encore analysé"
method: POST
path: "/immeubles/analyses"
---

# Dossier d'un immeuble pas encore analysé

`POST /immeubles/analyses`

## Request

- Base URL: `https://pillr.fr/api/v1`
- URL: `https://pillr.fr/api/v1/immeubles/analyses`
- Auth: HTTP bearer

Le dossier d'un immeuble de rapport, en cinq blocs, celui de l'outil analyse_immeuble du Hub : 1. les lots établis par les DPE de l'adresse (candidats dans un rayon de 250 m, confiance par concordance de surface et nombre de logements annoncé, désaccord) ; 2. l'état locatif lot par lot au loyer de la Carte des loyers selon la taille de chaque lot, et une découpe en lots de 40 ou 30 m² ; 3. le prix face à la prime de division DVF de la commune (repli départemental), servie quel que soit le nombre de ventes ; 4. les seuils fiscaux propres à l'immeuble ; 5. les risques datés, dont le calendrier énergétique par étiquette. Le vendeur n'est jamais nommé. Pour un immeuble collecté par Pillr que la file d'analyse n'a pas encore atteint, par le lien de son annonce (source_url). Coût : 10 crédits par appel réussi.

## Request body

- object
  - `source_url` string, uri, required: Lien de l'annonce de l'immeuble sur son portail d'origine.

## Response `200`

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

- object
  - `annonce` object, required: L'annonce de l'immeuble ; le vendeur n'y est jamais nommé.
    - `id` string, nullable, required: Identifiant Pillr de l'annonce analysée ; null pour un immeuble du lac pas encore analysé.
    - `source` string, 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
    - `commune` string, nullable, required
    - `code_postal` string, nullable, required
    - `insee` string, nullable, required
    - `prix` number, nullable, required
    - `surface_m2` number, nullable, required
    - `pieces` number, nullable, required
    - `dpe` string, nullable, required
    - `lat` number, nullable, required
    - `lon` number, nullable, required
    - `type_vendeur` 'pro' | 'particulier' | 'inconnu', required
  - `bloc_1_lots` object, required
    - `disponible` boolean, required
    - `confiance` 'mesure' | 'indice' | 'inconnu', required: mesure : lots énumérés dont la surface cumulée concorde à 20 % près avec la surface annoncée ; indice : lots énumérés sans concordance ; inconnu : aucun DPE exploitable.
    - `nb_lots` integer, required
    - `nb_lots_annonce` integer, nullable, required: Nombre de logements que le titre ou la description annonce.
    - `adresse` string, nullable, required: Adresse BAN des DPE retenus.
    - `surface_cumulee_m2` number, nullable, required
    - `surface_annoncee_m2` number, nullable, required
    - `ecart_surface_pct` number, nullable, required
    - `lots` object[], required
      - `surface_m2` number, nullable, required
      - `etiquette_dpe` string, nullable, required
      - `dpe_etabli_le` string, nullable, required
    - `desaccord` string, nullable, required
    - `autres_candidats` object[], required
      - `adresse` string, nullable, required
      - `nb_lots` integer, required
      - `surface_cumulee_m2` number, nullable, required
    - `methode` 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.
  - `bloc_2_etat_locatif` object, required
    - `loyer_m2_commune` number, nullable, required
    - `loyer_source` string, nullable, required
    - `loyer_mensuel_estime` number, nullable, required
    - `loyer_annuel_estime` number, nullable, required
    - `rendement_brut_pct` number, nullable, required
    - `detail_lots` object[], required
      - `surface_m2` number, nullable, required
      - `etiquette_dpe` string, nullable, required
      - `loyer_mensuel_eur` number, nullable, required
    - `methode` string, required
    - `decoupe` object, required
      - `disponible` boolean, required
      - `en_lots_de_40_m2` object, nullable, required
        - `nb_lots` integer, required
        - `surface_par_lot_m2` number, required
        - `loyer_mensuel` number, nullable, required
        - `ecart_pct` number, nullable, required: Écart au loyer de la configuration actuelle, en %.
      - `en_lots_de_30_m2` object, nullable, required
        - `nb_lots` integer, required
        - `surface_par_lot_m2` number, required
        - `loyer_mensuel` number, nullable, required
        - `ecart_pct` number, nullable, required: Écart au loyer de la configuration actuelle, en %.
      - `loyer_m2_t1_t2` number, nullable, required
      - `loyer_m2_t3plus` number, nullable, required
      - `source` string, nullable, required
      - `avertissement` 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.
  - `bloc_3_prix` object, required
    - `disponible` boolean, required
    - `maille` 'commune' | 'departement', nullable, required
    - `prix_m2_unite` number, nullable, required
    - `prix_m2_bloc` number, nullable, required
    - `rapport` number, nullable, required
    - `n_unite` integer, required
    - `n_bloc` integer, required
    - `position` string, nullable, required: Le prix au m² de l'annonce situé entre le prix en bloc et le prix à l'unité.
    - `avertissement` 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.
  - `bloc_4_fiscalite` object, required
    - `seuil_micro_bic_par_lot_eur` number, required
    - `seuil_micro_foncier_eur` number, required
    - `seuil_cotisations_sociales_lcd_eur` number, required
    - `particularites` string[], required
  - `bloc_5_risques` object, required
    - `calendrier_energetique` string, nullable, required
    - `concentration` string, required
    - `lots_sous_contrainte` integer, nullable, required: Lots en F ou G parmi les lots établis.
    - `a_verifier` string[], required
  - `ordre` string, required
  - `calcule_le` string, 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

- `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 ; 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)