Retour au blog
api annonces immobilièresAPI SeLogerAPI LeboncoinDVFAPI

API annonces immobilières : SeLoger, Leboncoin, agrégateurs et prix de vente DVF

IM

Immo API

·8 min de lecture
API annonces immobilières : SeLoger, Leboncoin, agrégateurs et prix de vente DVF

Vous développez un outil immobilier et vous cherchez une « API annonces immobilières » pour récupérer les biens en vente sur SeLoger ou Leboncoin. Avant d'écrire une ligne de code, il faut savoir ce qui existe vraiment, ce qui est autorisé, et pourquoi un prix d'annonce ne remplace pas un prix de vente.

Réponse courte. En France, ni SeLoger ni Leboncoin ne proposent d'API publique pour lire les annonces du marché. Leurs API officielles sont réservées aux professionnels partenaires et servent à publier et suivre leurs propres annonces. Pour lire des annonces de plusieurs portails, il reste deux voies : un agrégateur d'annonces payant, sous contrat, ou une collecte maison encadrée par les CGU des sites et le RGPD. Une annonce donne un prix demandé. Le prix réellement payé vient du DVF, que vous pouvez interroger en JSON avec GET /api/mutations/nearby d'Immo API pour comparer une annonce aux ventes signées autour d'elle.

Annonce ou vente : deux données qui ne disent pas la même chose

Une API d'annonces renvoie l'offre : le bien mis en vente, son prix affiché, ses photos, sa description, souvent honoraires d'agence inclus. Les demandes de valeurs foncières (DVF) renvoient la transaction : la valeur foncière déclarée dans l'acte, la date de mutation, la surface réelle bâtie, la parcelle. L'une décrit ce que le vendeur espère, l'autre ce que l'acheteur a payé.

CritèreAPI d'annoncesDVF (ventes)
PrixPrix demandé, souvent honoraires inclusValeur foncière déclarée à l'acte
MomentMise en vente, en continuSignature, publiée plusieurs mois après
SourcePortails, sites d'agences, particuliersDGFiP, open data diffusé par Etalab
AccèsPartenariat ou fournisseur payantFichiers publics ou API DVF
Usage typeAlertes, veille de l'offre, prospectionComparables, prix au m² vendu, estimation

Ce point explique aussi pourquoi les prix diffèrent d'un site à l'autre : voir pourquoi les prix immobiliers diffèrent selon les sources.

API annonces immobilières ou DVF : prix affiché contre valeur foncière, moment, source, accès et usage

Existe-t-il une API SeLoger ?

Oui, mais pas celle que l'on imagine. AVIV Group, maison mère de SeLoger, documente sur son portail développeurs des API pour les partenaires français : publication d'annonces depuis un logiciel d'agence, statistiques et contacts reçus sur ces annonces, estimation. L'accès se demande à l'équipe partenaires (partners@groupeseloger.com), qui valide l'éligibilité avant de fournir un bac à sable. Chaque agence délègue ensuite ses droits à l'éditeur depuis son compte MySeLoger Pro.

Ces API portent sur les données du partenaire : vos annonces, vos statistiques, vos contacts. Elles ne donnent pas accès aux annonces des autres agences. Pour un éditeur de logiciel d'agence, c'est le bon canal pour diffuser. Pour un outil qui veut analyser tout le marché, ce n'est pas une source.

Et une API Leboncoin pour l'immobilier ?

Même logique. Leboncoin propose aux professionnels abonnés de diffuser leurs annonces immobilières depuis leur logiciel de gestion, via des flux de multidiffusion. Aucun portail développeur ni clé d'API en libre-service ne permet de lire les annonces du site. Les services qui se présentent comme une « API Leboncoin » sont des tiers qui lisent les pages publiques et les renvoient en JSON.

Deux contraintes à garder en tête avant d'en dépendre. Les conditions d'utilisation des grands portails encadrent ou interdisent l'extraction automatisée sans autorisation. Et une annonce de particulier contient des données personnelles (nom, téléphone), soumises au RGPD : base légale, minimisation, durée de conservation.

Les trois voies réelles pour lire des annonces par API

  1. L'API officielle du portail. Réservée aux professionnels, pour publier et suivre leurs propres annonces. Utile pour un CRM d'agence, pas pour une veille de marché.
  2. Un agrégateur d'annonces. Un fournisseur collecte plusieurs portails, dédoublonne et livre un flux JSON. Lisez le contrat : sources couvertes, fraîcheur, droit de réafficher les textes et les photos, tarif à l'appel ou au volume. Notre comparatif des API de données immobilières range ces fournisseurs par famille.
  3. Une collecte maison. Techniquement possible, mais coûteuse : protections anti-robots, parseurs à maintenir à chaque refonte, risque juridique à faire valider. Réservée aux volumes ciblés et à l'analyse interne.
Lire des annonces immobilières par API : API officielle du portail, agrégateur d'annonces, scraping maison

Pourquoi croiser une annonce avec les ventes DVF

Un flux d'annonces seul ne dit pas si un bien est au prix du marché. Le croisement avec les ventes signées le dit. Trois usages reviennent souvent :

  • Repérer les annonces au-dessus du marché : prix affiché au m² comparé au prix au m² vendu médian autour du bien.
  • Estimer une marge de négociation par quartier, en suivant l'écart entre l'offre et les ventes.
  • Alimenter un outil de prospection ou un repérage d'opportunités avec des comparables vérifiables.

La route GET /api/mutations/nearby d'Immo API prend lat et lng, un rayon radius en kilomètres (5 par défaut, de 0,1 à 50), et les filtres type_local, annee et limit (20 par défaut, 100 au maximum). Elle ne garde que les ventes avec une valeur foncière positive et des coordonnées, ajoute un champ distance_km et trie par distance puis par date. Le détail est dans la documentation.

Le script Python : écart entre prix affiché et prix vendu

Le script part d'une annonce déjà géolocalisée (si vous n'avez que l'adresse, voir géocoder une adresse avec l'API Adresse), récupère les ventes proches du même type et calcule l'écart.

import os, statistics, requests

DVF = "https://immoapi.app/api/mutations/nearby"
KEY = os.environ["IMMOAPI_KEY"]  # clé dvf_live_...

annonce = {"prix": 389000, "surface": 68, "type_local": "Appartement",
           "lat": 47.2184, "lng": -1.5536}

def ecart_annonce_dvf(a, rayon_km=0.5):
    r = requests.get(DVF, headers={"x-api-key": KEY}, timeout=15, params={
        "lat": a["lat"], "lng": a["lng"], "radius": rayon_km,
        "type_local": a["type_local"], "limit": 100,
    })
    r.raise_for_status()
    prix_m2 = []
    for v in r.json()["data"]:
        s = v.get("surface_reelle_bati")
        if s and 0.7 * a["surface"] <= s <= 1.3 * a["surface"]:
            prix_m2.append(float(v["valeur_fonciere"]) / s)
    if len(prix_m2) < 10:
        return {"erreur": "trop peu de comparables", "n": len(prix_m2)}
    mediane = statistics.median(prix_m2)
    affiche = a["prix"] / a["surface"]
    return {"prix_m2_affiche": round(affiche),
            "prix_m2_vendu_median": round(mediane),
            "ecart_pct": round((affiche / mediane - 1) * 100, 1),
            "comparables": len(prix_m2)}

print(ecart_annonce_dvf(annonce))

valeur_fonciere arrive sous forme de texte décimal, d'où le float(). Les valeurs de l'annonce sont un exemple : remplacez-les par celles de votre flux.

Comparer une annonce immobilière aux ventes DVF : annonce, requête nearby, filtrage, médiane du prix au m² vendu, écart

Les pièges du croisement annonces et DVF

  • Le décalage dans le temps. Une annonce est d'aujourd'hui, une vente DVF est publiée plusieurs mois après l'acte. Sur un marché qui bouge, l'écart mélange tendance et négociation. Voir le calendrier de mise à jour du DVF.
  • Les honoraires. Un prix affiché « honoraires inclus » n'est pas comparable tel quel à une valeur foncière. Retirez les honoraires quand l'annonce les précise.
  • Les ventes multi-lots. Une même mutation peut porter plusieurs lignes et répéter la valeur foncière. Regroupez-les avant de calculer un prix au m² : méthode dans DVF en Python avec pandas.
  • Les surfaces. L'annonce affiche souvent la surface Carrez, le DVF la surface réelle bâtie : voir surface Carrez et surface réelle bâtie.
  • Les zones sans DVF. Le Bas-Rhin, le Haut-Rhin et la Moselle ne sont pas dans le DVF : une annonce à Strasbourg n'aura pas de comparables.
  • Les doublons d'annonces. Un même bien peut être publié par plusieurs agences et sur plusieurs portails. Dédoublonnez avant de compter l'offre.

FAQ : API annonces immobilières

Existe-t-il une API publique d'annonces immobilières en France ?

Pas du côté des grands portails. SeLoger et Leboncoin réservent leurs API aux professionnels, pour leurs propres annonces. Les flux d'annonces multi-portails passent par des agrégateurs privés, sous contrat.

L'API SeLoger permet-elle de lire les annonces du site ?

Non. Les API documentées par AVIV Group servent à publier des annonces, suivre leurs statistiques et recevoir les contacts d'un partenaire. Elles ne renvoient pas les annonces des autres agences.

Peut-on scraper Leboncoin ou SeLoger ?

C'est techniquement possible, mais leurs conditions d'utilisation encadrent l'extraction automatisée et les annonces de particuliers contiennent des données personnelles. Faites valider tout projet par un juriste avant de collecter.

Quelle différence entre un prix d'annonce et un prix DVF ?

Le prix d'annonce est le prix demandé au moment de la mise en vente. Le prix DVF est la valeur foncière déclarée dans l'acte signé, publiée plusieurs mois plus tard par la DGFiP.

Immo API fournit-elle des annonces immobilières ?

Non. Immo API donne accès aux ventes DVF : recherche de mutations, ventes autour d'un point, statistiques par commune ou code postal et serveur MCP. Pour les biens actuellement en vente, il faut une source d'annonces à côté.

Comment savoir si une annonce est au prix du marché ?

Comparez son prix au m² au prix au m² médian des ventes DVF du même type de bien dans un rayon de quelques centaines de mètres, avec une surface proche, en tenant compte des honoraires et du décalage de publication.

Pour démarrer

Gardez une source d'annonces pour l'offre et le DVF pour les prix réellement payés. Les paramètres des routes sont dans la documentation, les offres sur la page tarifs, et le parcours d'intégration dans le guide développeur de l'API DVF. Pour une estimation complète, voir la méthode des comparables (AVM).