---
title: "Adresses à prospecter d'un secteur"
method: GET
path: "/pre-marche"
---

# Adresses à prospecter d'un secteur

`GET /pre-marche`

## Request

- Base URL: `https://pillr.fr/api/v1`
- URL: `https://pillr.fr/api/v1/pre-marche`
- Auth: HTTP bearer

Les adresses d'un secteur (une commune, une liste de communes, une intercommunalité, un code postal ou un cercle) dont le DPE a moins de 24 mois, classées par priorité de prospection : la probabilité calibrée de vente DVF à 12 mois multipliée par la fenêtre de mandat. La réponse comprend le comptage du secteur, la précision mesurée, puis pour chaque adresse ses raisons, sa frise, l'annonce et l'agence quand elle est déjà en vente, ses sociétés civiles nommées, sa dernière vente, sa copropriété et son nombre de logements, et le total des logements pour un boîtage. Les adresses déjà en vente ou vendues depuis le DPE sont exclues, sauf demande. Coût : 10 crédits par élément rendu.

## Query parameters

- `insee` string: Code INSEE de la commune ou de l'arrondissement (5 caractères, 2A ou 2B pour la Corse).
- `communes` string: Communes du secteur, noms ou codes INSEE séparés par des virgules (40 au plus).
- `cp` string: Code postal.
- `epci` string: Intercommunalité : son code SIREN à 9 chiffres, ou son nom.
- `lat` number
- `lon` number
- `rayon_km` number: Rayon du cercle autour de lat et lon, de 0,3 à 15 km (2 par défaut).
- `type_bien` 'maison' | 'appartement' | 'tous': tous par défaut.
- `inclure_deja_en_vente` 'true' | 'false': true : garder les adresses déjà en vente ou vendues depuis le DPE.
- `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.

## Response `200`

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

- object
  - `secteur` object, required
    - `libelle` string, required
    - `communes` object[], required
      - `insee` string, required
      - `commune` string, required
    - `intercommunalite` object, nullable, required
      - `code` string, required
      - `nom` string, required
      - `extrait_le` string, required
    - `code_postal` string, nullable, required
    - `centre` object, nullable, required
      - `lat` number, required
      - `lon` number, required
      - `rayon_km` number, required
    - `introuvables` string[], required
  - `type_bien` 'maison' | 'appartement' | 'tous', required
  - `comptage` object, required
    - `adresses_dpe_24m` integer, required
    - `dpe_moins_90j` integer, required
    - `avec_pack` integer, required
    - `deja_en_vente` integer, required
    - `vendues_depuis` integer, required
    - `hors_perimetre` integer, required
    - `prospectables` integer, required
  - `precision` object, required
    - `base_pct` number, nullable, required: Taux de vente DVF à 12 mois mesuré du type de bien, en %.
    - `haut_pct` number, nullable, required: Taux mesuré dans la bande de probabilité la plus haute, en %.
    - `description` string, required
    - `mesure_le` string, nullable, required
  - `adresses` object[], required
    - `rang` integer, required
    - `cle_ban` string, required
    - `adresse` string, required
    - `commune` string, required
    - `code_postal` string, nullable, required
    - `insee` string, required
    - `lat` number, required
    - `lon` number, required
    - `type_bien` 'maison' | 'appartement' | 'immeuble' | 'autre', required
    - `dpe` string, nullable, required
    - `periode_construction` string, nullable, required
    - `chauffage` string, nullable, required
    - `dpe_le` string, required
    - `age_dpe_jours` integer, required
    - `audit_le` string, nullable, required
    - `pack_pre_vente` boolean, required
    - `p_vente` number, required: Probabilité calibrée qu'une vente DVF soit enregistrée à l'adresse dans les 12 mois.
    - `lift` number, nullable, required: p_vente divisée par le taux de vente mesuré du type de bien.
    - `fiabilite` 'mesure' | 'indicatif', required: mesure : maison positionnée dans la BAN, la population où la calibration est démontrée ; indicatif sinon.
    - `raisons` string[], required: Les coefficients réellement appliqués, du plus fort au plus faible, puis l'âge du DPE et la fenêtre de mandat.
    - `fenetre_mandat` object, required
      - `valeur` number, required: Part des vendeurs encore libres d'un mandat à cet âge du DPE (mesurée sur le délai entre le DPE et la première annonce).
      - `libelle` string, required
    - `priorite` number, required: p_vente multipliée par la fenêtre de mandat : l'ordre du classement.
    - `deja_en_vente` boolean, required
    - `annonce` object, nullable, required
      - `id` string, nullable, required
      - `lien` string, nullable, required: Lien d'origine de l'annonce, servi quand la clé porte la portée lien_origine.
      - `parue_le` string, nullable, required
      - `prix` number, nullable, required
      - `type_vendeur` 'pro' | 'particulier' | 'inconnu', required
      - `agence` object, nullable, required: L'agence qui publie l'annonce ; null pour un vendeur particulier ou inconnu.
        - `nom` string, nullable, required
        - `enseigne` string, nullable, required
        - `siren` string, nullable, required
    - `derniere_vente` object, nullable, required
      - `date` string, nullable, required
      - `prix` number, nullable, required
    - `annees_detention` number, nullable, required
    - `societes_civiles` object[], required
      - `denomination` string, nullable, required
      - `siren` string, nullable, required: SIREN lu dans le BODACC pour cette dénomination et ce code postal ; null s'il n'est pas rattaché sans ambiguïté.
      - `forme` string, nullable, required
      - `dernier_avis` string, nullable, required
      - `le` string, nullable, required
    - `permis` object, nullable, required
      - `n` integer, required
      - `dernier_le` string, nullable, required
      - `type` string, nullable, required
    - `copro` object, nullable, required
      - `lots` number, nullable, required
      - `syndic` string, nullable, required
    - `logements` object, required
      - `nombre` integer, nullable, required
      - `source` 'dpe' | 'copropriete' | 'maison', nullable, required
    - `frise` object[], required
      - `date` string, required
      - `type` 'dpe' | 'audit' | 'vente' | 'sci' | 'permis' | 'copro' | 'annonce', required
      - `libelle` string, required
      - `detail` string, nullable, required
      - `apres_dpe` boolean, required: Vrai si l'évènement est postérieur au dernier DPE.
  - `boitage` object, required
    - `logements` integer, required: Logements des adresses de la page, pour dimensionner un boîtage.
    - `adresses_sans_nombre` integer, 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.
  - `calcule_le` string, nullable, required
  - `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)