Localisation des annonces
Retrouver l'adresse d'une annonce floutée : le résultat déjà calculé, puis chaque étape du Hub, déterministe, appuyée sur la vision ou sur Google. 6 opérations servies.
Adresse retrouvée d'une annonce
Essayer en direct/api/v1/annonces/{id}/adresse/api/v1/annonces/par-url/adresseAdresse retrouvée d'une annonce floutée, par son lien Leboncoin, BienIci ou SeLoger ou par son identifiant, de quatre façons, chacune avec sa qualité : l'adresse retrouvée par le résolveur de Pillr, qui rapproche l'annonce des DPE de l'ADEME et de la Base Adresse Nationale, au meilleur niveau disponible (N1 adresse et bien sûrs, N2 adresse sûre, N3 adresse probable, E estimation qui peut désigner une autre adresse), avec son libellé, sa clé BAN, sa position et sa confiance ; les adresses que désigne l'empreinte du DPE affiché (numéro de DPE, clé BAN, écart de surface), ambiguë quand elle en désigne plusieurs ; l'adresse validée par un utilisateur de Pillr ; et, quand aucune adresse sûre, probable ou validée n'existe, les logements candidats calculés à l'appel dans le disque de flou par le DPE (même étiquette, surface à 3 m² près, même type). La résolution n'est pas relancée à l'appel : elle date du dernier passage du résolveur (resolue_le). Rien n'est débité si aucune de ces quatre réponses n'existe.
- Coût
- 5 crédits par appel réussi
- Accès
- À l'usage ou avec l'abonnement Data
- Portée
- annonces
- Outil MCP
- adresse_annonce
- Bac à sable
- Non
- Cache serveur
- 1 h
- Délai maximal
- 12 s
Paramètres de /api/v1/annonces/{id}/adresse
idtexteobligatoireIdentifiant de l'annonce : lbc:<numéro>, bienici:<identifiant>, seloger:<numéro> ou identifiant Pillr.
de 3 à 200 caractères
Paramètres de /api/v1/annonces/par-url/adresse
urltexteobligatoireLien de l'annonce sur le portail d'origine (Leboncoin, BienIci, SeLoger).
500 caractères au plus ; adresse web
Exemple d'appel
curl "https://pillr.fr/api/v1/annonces/par-url/adresse?url=https:%2F%2Fwww.leboncoin.fr%2Fad%2Fventes_immobilieres%2F2894512345" \
-H "Authorization: Bearer $PILLR_CLE"Réponse
idtexte ou nullIdentifiant Pillr de l'annonce dans la base servie ; null quand l'annonce n'est connue que des archives du lac.
id_portailtexte ou nullIdentifiant de l'annonce chez son portail : lbc:<n>, bienici:<id> ou seloger:<id>.
resolueobjet ou nullAdresse retrouvée de l'annonce, au meilleur niveau disponible : sûre (N1, N2), sinon probable (N3), sinon estimée (E), avec son libellé et sa clé BAN (depuis le 08/11/2026) ; null si le résolveur n'a pas retrouvé d'adresse.
Afficher les 13 champsMasquer
adressetexte ou nullLibellé de l'adresse retrouvée (« 8 Rue Exemple 35000 Rennes ») ; null si la base des adresses de Pillr ne le porte pas.
cle_bantexte ou nullClé BAN de l'adresse retrouvée, celle des opérations /adresses/{cle_ban} ; null si la résolution n'en donne pas.
niveautexteCe que vaut l'adresse : N1, adresse et bien sûrs ; N2, adresse sûre ; N3, adresse probable, à confirmer sur place ; E, estimation (l'annonce comparée aux DPE de la commune sans correspondance sûre), qui peut désigner une autre adresse, le plus souvent dans une autre rue.
Valeurs :
N1,N2,N3,Elatnombrelonnombreconfiancenombre ou nullConfiance du rattachement, de 0 à 1 : la probabilité du score du résolveur quand il en donne une (de 0,5 à 0,9 en N2 et N3, de 0,2 à 0,5 en E), sinon 0,95 en N1 et 0,85 en N2 ; null en N3 quand la règle n'en donne pas.
de 0 à 1
methodetexteMéthode du rattachement : v3:<niveau>:<règle> (v3:N2:empreinte, v3:E:score...) pour la résolution v3, en service depuis le 26/10/2026.
sourcesliste de textesToujours vide depuis la résolution v3 : la règle est dans methode.
concordance_mentier ou nullToujours null depuis la résolution v3.
rayon_disque_mentier ou nullToujours null depuis la résolution v3.
resolue_letexte ou nullversiontexte ou nullVersion des règles ou du score du résolveur.
qualiteobjetCe qui permet de juger la valeur : nombre, provenance, incertitude, drapeaux, date et source.
Afficher les 7 champsMasquer
nentier ou nullNombre d'observations derrière la valeur ; null si sans objet.
0 au moins
provenancetexte ou nullmesure : observé sur la donnée ; estime : modèle, barème ou imputation ; null : sans objet.
Valeurs :
mesure,estimeincertitudeobjet ou nullIncertitude de la valeur : fourchette et demi-largeur.
Afficher les 3 champsMasquer
demi_largeur_pctnombre ou nullDemi-largeur de la fourchette, en % de la valeur.
basnombre ou nullhautnombre ou null
drapeauxliste de textesCe qui doit faire lire la valeur avec prudence ; vide si rien.
Valeurs :
prix_atypique,surface_atypique,vente_en_bloc,doublon_probable,date_estimee,peu_d_observations,valeur_imputee,rattachement_incertain,donnee_anciennemethodetexte ou nullMéthode de calcul ou de rattachement, en clair.
donnees_dutexte ou nullDate de la donnée (AAAA-MM-JJ ou horodatage ISO 8601).
sourcetexteSource publique ou moteur Pillr, en clair.
empreinte_dpeobjet ou nullAdresses retrouvées par l'empreinte du DPE affiché (étiquette, surface, date) ; null si aucune.
Afficher les 3 champsMasquer
n_adressesentierAdresses que l'empreinte du DPE affiché désigne ; plus d'une : empreinte ambiguë.
candidatsliste d'objetsAfficher les 5 champsMasquer
numero_dpetextecle_bantexte ou nulldate_dpetexte ou nulltype_batimenttexte ou nullecart_surface_m2nombre ou nullÉcart entre la surface du DPE et celle de l'annonce, en m².
qualiteobjetCe qui permet de juger la valeur : nombre, provenance, incertitude, drapeaux, date et source.
Afficher les 7 champsMasquer
nentier ou nullNombre d'observations derrière la valeur ; null si sans objet.
0 au moins
provenancetexte ou nullmesure : observé sur la donnée ; estime : modèle, barème ou imputation ; null : sans objet.
Valeurs :
mesure,estimeincertitudeobjet ou nullIncertitude de la valeur : fourchette et demi-largeur.
Afficher les 3 champsMasquer
demi_largeur_pctnombre ou nullDemi-largeur de la fourchette, en % de la valeur.
basnombre ou nullhautnombre ou null
drapeauxliste de textesCe qui doit faire lire la valeur avec prudence ; vide si rien.
Valeurs :
prix_atypique,surface_atypique,vente_en_bloc,doublon_probable,date_estimee,peu_d_observations,valeur_imputee,rattachement_incertain,donnee_anciennemethodetexte ou nullMéthode de calcul ou de rattachement, en clair.
donnees_dutexte ou nullDate de la donnée (AAAA-MM-JJ ou horodatage ISO 8601).
sourcetexteSource publique ou moteur Pillr, en clair.
candidats_dpeobjet ou nullCalculé à l'appel quand la résolution n'a ni adresse sûre ni adresse probable et qu'aucune adresse n'est validée : les logements dont le DPE enregistré à l'ADEME a la même étiquette, la même surface à 3 m² près et le même type de bâtiment, dans le disque de flou de l'annonce, du plus proche au plus éloigné (l'étape dpe de localiser_annonce). Un seul candidat désigne le plus souvent l'adresse ; plusieurs forment une liste à vérifier. null si la recherche n'a pas pu se faire (annonce sans DPE, sans surface ou sans position) ou n'a pas été nécessaire.
Afficher les 5 champsMasquer
n_candidatsentierAdresses candidates rendues (logements distincts du DPE).
liste_completebooléenFaux quand la recherche s'est arrêtée à 12 candidats, les plus proches : d'autres logements peuvent correspondre.
rayon_recherche_mentierRayon du disque cherché autour de la position affichée : le flou du portail (ou un rayon supposé) plus une marge.
candidatsliste d'objetsAfficher les 8 champsMasquer
adressetexte ou nullcle_bantexte ou nullClé BAN du logement du DPE, celle des opérations /adresses/{cle_ban} ; null si l'ADEME ne la donne pas.
distance_mentier ou nullDistance au centre du disque, en mètres.
ecart_surface_m2nombre ou nullSurface du DPE moins celle de l'annonce, en m².
date_dpetexte ou nulltype_batimenttexte ou nulllatnombre ou nulllonnombre ou null
qualiteobjetCe qui permet de juger la valeur : nombre, provenance, incertitude, drapeaux, date et source.
Afficher les 7 champsMasquer
nentier ou nullNombre d'observations derrière la valeur ; null si sans objet.
0 au moins
provenancetexte ou nullmesure : observé sur la donnée ; estime : modèle, barème ou imputation ; null : sans objet.
Valeurs :
mesure,estimeincertitudeobjet ou nullIncertitude de la valeur : fourchette et demi-largeur.
Afficher les 3 champsMasquer
demi_largeur_pctnombre ou nullDemi-largeur de la fourchette, en % de la valeur.
basnombre ou nullhautnombre ou null
drapeauxliste de textesCe qui doit faire lire la valeur avec prudence ; vide si rien.
Valeurs :
prix_atypique,surface_atypique,vente_en_bloc,doublon_probable,date_estimee,peu_d_observations,valeur_imputee,rattachement_incertain,donnee_anciennemethodetexte ou nullMéthode de calcul ou de rattachement, en clair.
donnees_dutexte ou nullDate de la donnée (AAAA-MM-JJ ou horodatage ISO 8601).
sourcetexteSource publique ou moteur Pillr, en clair.
valideeobjet ou nullAdresse confirmée par un utilisateur de Pillr (cache partagé des localisations) ; null si aucune.
Afficher les 7 champsMasquer
adressetextelatnombre ou nulllonnombre ou nullprecisiontexte ou nullValeurs :
numero,rue,lieu_dit,communeconfiancetexte ou nullCe qui a fondé la validation, en clair (Street View, DPE...).
letexte ou nullDate de la validation.
qualiteobjetCe qui permet de juger la valeur : nombre, provenance, incertitude, drapeaux, date et source.
Afficher les 7 champsMasquer
nentier ou nullNombre d'observations derrière la valeur ; null si sans objet.
0 au moins
provenancetexte ou nullmesure : observé sur la donnée ; estime : modèle, barème ou imputation ; null : sans objet.
Valeurs :
mesure,estimeincertitudeobjet ou nullIncertitude de la valeur : fourchette et demi-largeur.
Afficher les 3 champsMasquer
demi_largeur_pctnombre ou nullDemi-largeur de la fourchette, en % de la valeur.
basnombre ou nullhautnombre ou null
drapeauxliste de textesCe qui doit faire lire la valeur avec prudence ; vide si rien.
Valeurs :
prix_atypique,surface_atypique,vente_en_bloc,doublon_probable,date_estimee,peu_d_observations,valeur_imputee,rattachement_incertain,donnee_anciennemethodetexte ou nullMéthode de calcul ou de rattachement, en clair.
donnees_dutexte ou nullDate de la donnée (AAAA-MM-JJ ou horodatage ISO 8601).
sourcetexteSource publique ou moteur Pillr, en clair.
creditsobjetCré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).
Afficher les 2 champsMasquer
debitesentier0 au moins
restantsentier ou null
Erreurs possibles
- 400parametres_invalidesUn paramètre manque ou ne passe pas son contrôle ; le détail est donné champ par champ
- 403hors_bac_a_sableUne clé pk_test_ l'appelle : l'opération n'a pas de bac à sable
Afficher les 11 erreurs communes à toute l'APIMasquer les erreurs communes
- 401cle_absenteL'en-tête Authorization manque
- 401cle_invalideLa clé est inconnue, révoquée ou expirée
- 403organisation_suspendueL'organisation de la clé n'est pas active
- 403portee_insuffisanteLa clé ou l'accès de l'organisation n'ouvre pas cette opération
- 402credits_insuffisantsLes crédits ne suffisent plus pour cet appel
- 429plafond_cleLe plafond mensuel de crédits de la clé est atteint
- 429quota_minuteLe débit par minute de l'organisation est atteint
- 503charge_globaleL'API est momentanément surchargée, tous clients confondus ; rien n'est débité
- 504delai_depasseLe calcul dépasse le délai de l'opération ; rien n'est débité
- 503service_indisponibleL'API est momentanément indisponible
- 500erreur_interneUne erreur de notre côté ; rien n'est servi ni débité
Une ressource absente répond par un code de la famille des ressources absentes, propre à l'opération, sans débit. Guide des erreurs
Localisation pas à pas (étapes déterministes)
Essayer en direct/api/v1/annonces/{id}/localisationÉtapes déterministes de la localisation d'une annonce floutée, une par appel (etape), celles de l'outil du Hub : disque (centre et rayon du flou du portail, adresse BAN du centre, précision honnête des coordonnées, immeuble annoncé, adresse validée) ; dpe (DPE du miroir ADEME dans le disque, à la même étiquette, à la surface près et du même type, repli sur l'API de l'ADEME) ; dvf (ventes DVF de 2014 à 2026 du même type à 3 % de surface près, adresse retrouvée par la BAN) ; copro (copropriétés du registre national au nombre de lots annoncé) ; parcelle (maisons : parcelles du cadastre IGN à la contenance du terrain annoncé) ; batiments (bâtiments BD TOPO du disque, compatibles d'abord avec l'étage annoncé) ; geocoder (saisie q géocodée par la Base Adresse Nationale, au code postal de l'annonce ou à code_postal, et contrôlée contre le flou). Les candidats sont croisés avec les disques des rediffusions du même bien sur d'autres portails. tolerance règle l'étape : surface en m² pour dpe (1 à 15), lots pour copro (1 à 8), contenance en % pour parcelle (1 à 30). Street View, Google Maps et l'image aérienne ne sont donnés qu'en lien. Rien n'est débité quand l'annonce ne permet pas l'étape (sans étiquette DPE, sans surface, sans position, hors copropriété, sans terrain).
- Coût
- 5 crédits par appel réussi
- Accès
- À l'usage ou avec l'abonnement Data
- Portée
- annonces
- Outil MCP
- localiser_annonce
- Bac à sable
- Non
- Cache serveur
- 1 h
- Délai maximal
- 30 s
Paramètres
idtexteobligatoireIdentifiant de l'annonce : lbc:<numéro>, bienici:<identifiant>, seloger:<numéro> ou identifiant Pillr.
de 3 à 200 caractères
etapetexteobligatoireL'étape à exécuter.
Valeurs :
disque,dpe,dvf,copro,parcelle,batiments,geocodertolerancenombreTolérance de l'étape dpe (m²), copro (lots) ou parcelle (% de contenance), bornée par l'étape.
de 1 à 30
qtextegeocoder : la rue, le lieu ou l'adresse à géocoder.
de 2 à 200 caractères
code_postaltextegeocoder : code postal de la recherche (par défaut, celui de l'annonce).
Exemple d'appel
curl "https://pillr.fr/api/v1/annonces/lbc:2894512345/localisation?etape=dpe" \
-H "Authorization: Bearer $PILLR_CLE"Réponse
idtexte ou nullIdentifiant Pillr de l'annonce dans la base servie ; null quand l'annonce n'est connue que des archives du lac.
id_portailtexte ou nullIdentifiant de l'annonce chez son portail : lbc:<n>, bienici:<id> ou seloger:<id>.
etapetexteValeurs :
disque,dpe,dvf,copro,parcelle,batiments,geocodercriteresobjetLes critères que l'étape a appliqués.
Afficher les 12 champsMasquer
dpetexte ou nullValeurs :
A,B,C,D,E,F,Gtype_bientexte ou nullsurface_m2nombre ou nulltolerancenombre ou nullTolérance appliquée, après bornage par l'étape.
unite_tolerancetexte ou nullValeurs :
m2,lots,pctlotsentier ou nullterrain_m2nombre ou nulletageentier ou nulletage_minimumentier ou nullcode_postaltexte ou nullqtexte ou nullanneesliste d'entiers ou null
disqueobjet ou nullAfficher les 5 champsMasquer
centreobjetAfficher les 2 champsMasquer
latnombrelonnombre
rayon_flou_mentier ou nullRayon du flou donné par le portail ; null quand il ne le donne pas.
rayon_recherche_mentierRayon de recherche : le flou, ou le rayon supposé, plus la marge de géocodage.
originetexteValeurs :
flou_du_portail,coordonnees_annoncerediffusions_croiseesentier ou nullDisques des rediffusions du même bien sur d'autres portails, croisés avec celui-ci ; null quand l'étape ne les croise pas.
nb_candidatsentiercandidatsliste d'objetsAfficher les 27 champsMasquer
adressetexte ou nullcle_bantexte ou nullClé BAN du candidat quand il est retrouvé au numéro ; null sinon.
latnombre ou nulllonnombre ou nulldistance_mentier ou nullDistance au centre du disque, en mètres.
ecartnombre ou nullÉcart au critère de l'étape : m² de surface (dpe, dvf), lots (copro), m² de terrain (parcelle) ; null pour batiments et geocoder.
dpetexte ou nullValeurs :
A,B,C,D,E,F,Ggestexte ou nullValeurs :
A,B,C,D,E,F,Gdatetexte ou nullDate du DPE (dpe) ou de la vente (dvf).
surface_m2nombre ou nulltypetexte ou nullType de bâtiment du DPE (dpe).
periode_constructiontexte ou nullvaleur_foncierenombre ou nullPrix de la vente DVF, en euros (dvf).
lots_totalentier ou nulllots_habitationentier ou nullnom_coproprietetexte ou nullNom d'usage de la copropriété au registre (copro).
contenance_m2nombre ou nullsectiontexte ou nullnumero_parcelletexte ou nullniveauxentier ou nullNiveaux du bâtiment BD TOPO, sinon estimés par sa hauteur (batiments).
hauteur_mnombre ou nullusagetexte ou nulllogementsentier ou nullcompatible_etagebooléen ou nullVrai si l'étage annoncé existe dans le bâtiment ; null sans étage annoncé ou sans hauteur connue.
precisiontexte ou nullType du résultat de la Base Adresse Nationale (geocoder) : housenumber, street, locality, municipality.
scorenombre ou nullScore de la Base Adresse Nationale, de 0 à 1 (geocoder).
liensobjetLiens vers le point ; null quand le point manque.
Afficher les 3 champsMasquer
street_viewtexte ou nullLien Google Street View du point (un lien : aucune image Google n'est servie).
mapstexte ou nullLien Google Maps du point.
orthotexte ou nullImage aérienne de l'IGN (Géoplateforme, service WMS) centrée sur le point.
dans_le_disquebooléen ou nullgeocoder : vrai si l'adresse tombe dans le flou du portail, faux pour une voie homonyme hors du disque ; null sans flou.
situationobjet ou nulldisque : ce que l'annonce dit de sa position ; null pour les autres étapes.
Afficher les 8 champsMasquer
precisiontextePrécision honnête des coordonnées affichées : avec un flou, jamais au numéro.
Valeurs :
aucune,disque_de_flou,numero,rue,approcheeadresse_procheobjet ou nullAdresse BAN la plus proche du centre : celle du centre du flou, pas celle du bien.
Afficher les 4 champsMasquer
adressetextecle_bantexte ou nulltypetextescorenombre
communetexte ou nullcode_postaltexte ou nullinseetexte ou nullquartiertexte ou nullbatimentobjetAfficher les 5 champsMasquer
etageentier ou nullnb_etagesentier ou nullen_coproprietebooléen ou nulllots_coproentier ou nullascenseurbooléen ou null
liensobjetLiens vers le point ; null quand le point manque.
Afficher les 3 champsMasquer
street_viewtexte ou nullLien Google Street View du point (un lien : aucune image Google n'est servie).
mapstexte ou nullLien Google Maps du point.
orthotexte ou nullImage aérienne de l'IGN (Géoplateforme, service WMS) centrée sur le point.
adresse_valideeobjet ou nullAdresse confirmée par un utilisateur de Pillr (cache partagé des localisations) ; null si aucune.
Afficher les 7 champsMasquer
adressetextelatnombre ou nulllonnombre ou nullprecisiontexte ou nullValeurs :
numero,rue,lieu_dit,communeconfiancetexte ou nullCe qui a fondé la validation, en clair (Street View, DPE...).
letexte ou nullDate de la validation.
qualiteobjetCe qui permet de juger la valeur : nombre, provenance, incertitude, drapeaux, date et source.
Afficher les 7 champsMasquer
nentier ou nullNombre d'observations derrière la valeur ; null si sans objet.
0 au moins
provenancetexte ou nullmesure : observé sur la donnée ; estime : modèle, barème ou imputation ; null : sans objet.
Valeurs :
mesure,estimeincertitudeobjet ou nullIncertitude de la valeur : fourchette et demi-largeur.
Afficher les 3 champsMasquer
demi_largeur_pctnombre ou nullDemi-largeur de la fourchette, en % de la valeur.
basnombre ou nullhautnombre ou null
drapeauxliste de textesCe qui doit faire lire la valeur avec prudence ; vide si rien.
Valeurs :
prix_atypique,surface_atypique,vente_en_bloc,doublon_probable,date_estimee,peu_d_observations,valeur_imputee,rattachement_incertain,donnee_anciennemethodetexte ou nullMéthode de calcul ou de rattachement, en clair.
donnees_dutexte ou nullDate de la donnée (AAAA-MM-JJ ou horodatage ISO 8601).
sourcetexteSource publique ou moteur Pillr, en clair.
qualiteobjetCe qui permet de juger la valeur : nombre, provenance, incertitude, drapeaux, date et source.
Afficher les 7 champsMasquer
nentier ou nullNombre d'observations derrière la valeur ; null si sans objet.
0 au moins
provenancetexte ou nullmesure : observé sur la donnée ; estime : modèle, barème ou imputation ; null : sans objet.
Valeurs :
mesure,estimeincertitudeobjet ou nullIncertitude de la valeur : fourchette et demi-largeur.
Afficher les 3 champsMasquer
demi_largeur_pctnombre ou nullDemi-largeur de la fourchette, en % de la valeur.
basnombre ou nullhautnombre ou null
drapeauxliste de textesCe qui doit faire lire la valeur avec prudence ; vide si rien.
Valeurs :
prix_atypique,surface_atypique,vente_en_bloc,doublon_probable,date_estimee,peu_d_observations,valeur_imputee,rattachement_incertain,donnee_anciennemethodetexte ou nullMéthode de calcul ou de rattachement, en clair.
donnees_dutexte ou nullDate de la donnée (AAAA-MM-JJ ou horodatage ISO 8601).
sourcetexteSource publique ou moteur Pillr, en clair.
creditsobjetCré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).
Afficher les 2 champsMasquer
debitesentier0 au moins
restantsentier ou null
Erreurs possibles
- 400parametres_invalidesUn paramètre manque ou ne passe pas son contrôle ; le détail est donné champ par champ
- 403hors_bac_a_sableUne clé pk_test_ l'appelle : l'opération n'a pas de bac à sable
Afficher les 11 erreurs communes à toute l'APIMasquer les erreurs communes
- 401cle_absenteL'en-tête Authorization manque
- 401cle_invalideLa clé est inconnue, révoquée ou expirée
- 403organisation_suspendueL'organisation de la clé n'est pas active
- 403portee_insuffisanteLa clé ou l'accès de l'organisation n'ouvre pas cette opération
- 402credits_insuffisantsLes crédits ne suffisent plus pour cet appel
- 429plafond_cleLe plafond mensuel de crédits de la clé est atteint
- 429quota_minuteLe débit par minute de l'organisation est atteint
- 503charge_globaleL'API est momentanément surchargée, tous clients confondus ; rien n'est débité
- 504delai_depasseLe calcul dépasse le délai de l'opération ; rien n'est débité
- 503service_indisponibleL'API est momentanément indisponible
- 500erreur_interneUne erreur de notre côté ; rien n'est servi ni débité
Une ressource absente répond par un code de la famille des ressources absentes, propre à l'opération, sans débit. Guide des erreurs
Indices de localisation lus sur les photos
Essayer en direct/api/v1/annonces/{id}/localisation/indices-photosLecture par vision (Gemini) des 4 premières photos et de la description d'une annonce : noms de rue, enseignes, numéros de voirie, monuments, lieux cités, vue depuis les fenêtres, quartier et indice le plus fort. Seuls des indices lus sont rendus, jamais devinés : un indice se géocode ensuite par localiser_annonce (etape geocoder) ou lieu_par_indice. Les photos sont lues sur les serveurs des portails ; la description d'un particulier est passée au modèle sans ses coordonnées.
- Coût
- 20 crédits par appel réussi
- Accès
- À l'usage ou avec l'abonnement Data
- Portée
- annonces
- Outil MCP
- indices_photos
- Bac à sable
- Non
- Cache serveur
- 24 h
- Délai maximal
- 60 s
Paramètres
idtexteobligatoireIdentifiant de l'annonce : lbc:<numéro>, bienici:<identifiant>, seloger:<numéro> ou identifiant Pillr.
de 3 à 200 caractères
Exemple d'appel
curl https://pillr.fr/api/v1/annonces/lbc:2894512345/localisation/indices-photos \
-H "Authorization: Bearer $PILLR_CLE"Réponse
idtexte ou nullIdentifiant Pillr de l'annonce dans la base servie ; null quand l'annonce n'est connue que des archives du lac.
id_portailtexte ou nullIdentifiant de l'annonce chez son portail : lbc:<n>, bienici:<id> ou seloger:<id>.
vues_exterieuresbooléenVrai si au moins une photo montre l'extérieur, la façade, la rue ou une vue.
quartiertexte ou nullruesliste de textesNoms de rue ou de place lus sur un panneau ou dans la description.
enseignesliste de textesEnseignes de commerces lisibles.
numerosliste de textesNuméros de voirie visibles.
monumentsliste de textesMonuments, églises, gares, écoles identifiés par leur nom.
lieux_prochesliste de textesLieux nommés dans la description.
vuetexte ou nullCe qui se voit depuis les fenêtres ou le balcon.
indice_principaltexte ou nullL'indice le plus exploitable pour situer le bien.
photos_analyseesentierqualiteobjetCe qui permet de juger la valeur : nombre, provenance, incertitude, drapeaux, date et source.
Afficher les 7 champsMasquer
nentier ou nullNombre d'observations derrière la valeur ; null si sans objet.
0 au moins
provenancetexte ou nullmesure : observé sur la donnée ; estime : modèle, barème ou imputation ; null : sans objet.
Valeurs :
mesure,estimeincertitudeobjet ou nullIncertitude de la valeur : fourchette et demi-largeur.
Afficher les 3 champsMasquer
demi_largeur_pctnombre ou nullDemi-largeur de la fourchette, en % de la valeur.
basnombre ou nullhautnombre ou null
drapeauxliste de textesCe qui doit faire lire la valeur avec prudence ; vide si rien.
Valeurs :
prix_atypique,surface_atypique,vente_en_bloc,doublon_probable,date_estimee,peu_d_observations,valeur_imputee,rattachement_incertain,donnee_anciennemethodetexte ou nullMéthode de calcul ou de rattachement, en clair.
donnees_dutexte ou nullDate de la donnée (AAAA-MM-JJ ou horodatage ISO 8601).
sourcetexteSource publique ou moteur Pillr, en clair.
creditsobjetCré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).
Afficher les 2 champsMasquer
debitesentier0 au moins
restantsentier ou null
Erreurs possibles
- 400parametres_invalidesUn paramètre manque ou ne passe pas son contrôle ; le détail est donné champ par champ
- 403hors_bac_a_sableUne clé pk_test_ l'appelle : l'opération n'a pas de bac à sable
Afficher les 11 erreurs communes à toute l'APIMasquer les erreurs communes
- 401cle_absenteL'en-tête Authorization manque
- 401cle_invalideLa clé est inconnue, révoquée ou expirée
- 403organisation_suspendueL'organisation de la clé n'est pas active
- 403portee_insuffisanteLa clé ou l'accès de l'organisation n'ouvre pas cette opération
- 402credits_insuffisantsLes crédits ne suffisent plus pour cet appel
- 429plafond_cleLe plafond mensuel de crédits de la clé est atteint
- 429quota_minuteLe débit par minute de l'organisation est atteint
- 503charge_globaleL'API est momentanément surchargée, tous clients confondus ; rien n'est débité
- 504delai_depasseLe calcul dépasse le délai de l'opération ; rien n'est débité
- 503service_indisponibleL'API est momentanément indisponible
- 500erreur_interneUne erreur de notre côté ; rien n'est servi ni débité
Une ressource absente répond par un code de la famille des ressources absentes, propre à l'opération, sans débit. Guide des erreurs
Lieu réel d'un indice par Google Maps
Essayer en direct/api/v1/annonces/{id}/localisation/lieuxRésout un indice de localisation (enseigne, repère, ligne de tram) en lieu réel par Gemini avec l'outil Google Maps, biaisé sur le centre du flou de l'annonce (sinon sur lat et lon, sinon sur sa position affichée) pour écarter les homonymes lointains : la réponse du modèle et 5 lieux Google Maps au plus. Le lieu trouvé se contrôle ensuite par localiser_annonce (etape geocoder), qui dit s'il tombe dans le disque. Résultat soumis aux conditions de Google Maps Platform : jamais gardé en mémoire par Pillr, la source est citée.
- Coût
- 40 crédits par appel réussi
- Accès
- À l'usage ou avec l'abonnement Data
- Portée
- annonces
- Outil MCP
- lieu_par_indice
- Bac à sable
- Non
- Cache serveur
- Jamais mis en cache
- Délai maximal
- 30 s
Paramètres
idtexteobligatoireIdentifiant de l'annonce : lbc:<numéro>, bienici:<identifiant>, seloger:<numéro> ou identifiant Pillr.
de 3 à 200 caractères
qtexteobligatoireL'indice à résoudre : enseigne, repère, ligne de transport.
de 2 à 200 caractères
latnombreLatitude du biais, quand l'annonce n'a pas de flou.
de -90 à 90
lonnombreLongitude du biais, quand l'annonce n'a pas de flou.
de -180 à 180
Exemple d'appel
curl "https://pillr.fr/api/v1/annonces/lbc:2894512345/localisation/lieux?q=pharmacie+rue+de+la+R%C3%A9publique" \
-H "Authorization: Bearer $PILLR_CLE"Réponse
idtexte ou nullIdentifiant Pillr de l'annonce dans la base servie ; null quand l'annonce n'est connue que des archives du lac.
id_portailtexte ou nullIdentifiant de l'annonce chez son portail : lbc:<n>, bienici:<id> ou seloger:<id>.
qtextereponsetexteLa réponse du modèle : le lieu le plus probable, son adresse ou son quartier.
lieuxliste d'objetsLes lieux Google Maps cités par la réponse.
Afficher les 3 champsMasquer
titretexteuritexte ou nullplace_idtexte ou null
point_de_biaisobjet ou nullLe point autour duquel la recherche est biaisée : le centre du flou, sinon lat et lon, sinon la position affichée.
Afficher les 2 champsMasquer
latnombrelonnombre
sourcetextequaliteobjetCe qui permet de juger la valeur : nombre, provenance, incertitude, drapeaux, date et source.
Afficher les 7 champsMasquer
nentier ou nullNombre d'observations derrière la valeur ; null si sans objet.
0 au moins
provenancetexte ou nullmesure : observé sur la donnée ; estime : modèle, barème ou imputation ; null : sans objet.
Valeurs :
mesure,estimeincertitudeobjet ou nullIncertitude de la valeur : fourchette et demi-largeur.
Afficher les 3 champsMasquer
demi_largeur_pctnombre ou nullDemi-largeur de la fourchette, en % de la valeur.
basnombre ou nullhautnombre ou null
drapeauxliste de textesCe qui doit faire lire la valeur avec prudence ; vide si rien.
Valeurs :
prix_atypique,surface_atypique,vente_en_bloc,doublon_probable,date_estimee,peu_d_observations,valeur_imputee,rattachement_incertain,donnee_anciennemethodetexte ou nullMéthode de calcul ou de rattachement, en clair.
donnees_dutexte ou nullDate de la donnée (AAAA-MM-JJ ou horodatage ISO 8601).
sourcetexteSource publique ou moteur Pillr, en clair.
creditsobjetCré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).
Afficher les 2 champsMasquer
debitesentier0 au moins
restantsentier ou null
Erreurs possibles
- 400parametres_invalidesUn paramètre manque ou ne passe pas son contrôle ; le détail est donné champ par champ
- 403hors_bac_a_sableUne clé pk_test_ l'appelle : l'opération n'a pas de bac à sable
Afficher les 11 erreurs communes à toute l'APIMasquer les erreurs communes
- 401cle_absenteL'en-tête Authorization manque
- 401cle_invalideLa clé est inconnue, révoquée ou expirée
- 403organisation_suspendueL'organisation de la clé n'est pas active
- 403portee_insuffisanteLa clé ou l'accès de l'organisation n'ouvre pas cette opération
- 402credits_insuffisantsLes crédits ne suffisent plus pour cet appel
- 429plafond_cleLe plafond mensuel de crédits de la clé est atteint
- 429quota_minuteLe débit par minute de l'organisation est atteint
- 503charge_globaleL'API est momentanément surchargée, tous clients confondus ; rien n'est débité
- 504delai_depasseLe calcul dépasse le délai de l'opération ; rien n'est débité
- 503service_indisponibleL'API est momentanément indisponible
- 500erreur_interneUne erreur de notre côté ; rien n'est servi ni débité
Une ressource absente répond par un code de la famille des ressources absentes, propre à l'opération, sans débit. Guide des erreurs
Comparaison de façade avec Street View
Essayer en direct/api/v1/annonces/{id}/localisation/street-viewCompare par vision (Gemini) la façade des 4 premières photos de l'annonce aux images Google Street View de 1 à 3 adresses candidates, en une seule passe : verdict (oui, non, incertain), confiance, raison et classement des candidats. Un candidat sans couverture Street View n'est pas comparé ni payé. Les images Street View ne sont jamais servies ni gardées : seul un lien l'est. Rien n'est débité sans photo d'annonce, sans couverture ou si le service est coupé.
- Coût
- 40 crédits par appel réussi
- Accès
- À l'usage ou avec l'abonnement Data
- Portée
- annonces
- Outil MCP
- street_view
- Bac à sable
- Non
- Cache serveur
- Jamais mis en cache
- Délai maximal
- 60 s
Paramètres
idtexteobligatoireIdentifiant de l'annonce : lbc:<numéro>, bienici:<identifiant>, seloger:<numéro> ou identifiant Pillr.
de 3 à 200 caractères
candidatsliste d'objetsLes adresses candidates.
1 éléments au moins ; 3 éléments au plus
Afficher les 3 champsMasquer
latnombreobligatoirede -90 à 90
lonnombreobligatoirede -180 à 180
libelletexteAdresse ou nom du candidat, repris dans le classement.
200 caractères au plus
latnombreUn seul candidat : sa latitude (sans candidats).
de -90 à 90
lonnombreUn seul candidat : sa longitude (sans candidats).
de -180 à 180
capnombreCap de la prise de vue Street View, en degrés.
de 0 à 360
Exemple d'appel
curl -X POST https://pillr.fr/api/v1/annonces/lbc%3A2894512345/localisation/street-view \
-H "Authorization: Bearer $PILLR_CLE" \
-H "Content-Type: application/json" \
-d '{"lat":49.4431,"lon":1.0993}'Réponse
idtexte ou nullIdentifiant Pillr de l'annonce dans la base servie ; null quand l'annonce n'est connue que des archives du lac.
id_portailtexte ou nullIdentifiant de l'annonce chez son portail : lbc:<n>, bienici:<id> ou seloger:<id>.
correspondancetexteVerdict du candidat retenu : oui, non ou incertain.
Valeurs :
oui,non,incertainconfiancenombre ou nullConfiance déclarée par le modèle, de 0 à 1.
de 0 à 1
raisontexte ou nulllien_street_viewtexte ou nullLien Google Street View du candidat retenu (aucune image n'est servie).
images_compareesentierImages Street View réellement comparées (un candidat sans couverture n'est pas payé).
classementliste d'objetsAfficher les 8 champsMasquer
candidatentierRang du candidat dans la demande, à partir de 1.
libelletexte ou nullcorrespondancetexteValeurs :
oui,non,incertainconfiancenombre ou nullde 0 à 1
raisontexte ou nulllatnombre ou nulllonnombre ou nulllien_street_viewtexte ou null
qualiteobjetCe qui permet de juger la valeur : nombre, provenance, incertitude, drapeaux, date et source.
Afficher les 7 champsMasquer
nentier ou nullNombre d'observations derrière la valeur ; null si sans objet.
0 au moins
provenancetexte ou nullmesure : observé sur la donnée ; estime : modèle, barème ou imputation ; null : sans objet.
Valeurs :
mesure,estimeincertitudeobjet ou nullIncertitude de la valeur : fourchette et demi-largeur.
Afficher les 3 champsMasquer
demi_largeur_pctnombre ou nullDemi-largeur de la fourchette, en % de la valeur.
basnombre ou nullhautnombre ou null
drapeauxliste de textesCe qui doit faire lire la valeur avec prudence ; vide si rien.
Valeurs :
prix_atypique,surface_atypique,vente_en_bloc,doublon_probable,date_estimee,peu_d_observations,valeur_imputee,rattachement_incertain,donnee_anciennemethodetexte ou nullMéthode de calcul ou de rattachement, en clair.
donnees_dutexte ou nullDate de la donnée (AAAA-MM-JJ ou horodatage ISO 8601).
sourcetexteSource publique ou moteur Pillr, en clair.
creditsobjetCré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).
Afficher les 2 champsMasquer
debitesentier0 au moins
restantsentier ou null
Erreurs possibles
- 400parametres_invalidesUn paramètre manque ou ne passe pas son contrôle ; le détail est donné champ par champ
- 415type_contenuLe corps n'est pas envoyé en application/json
- 400corps_illisibleLe corps n'est pas un JSON lisible
- 413corps_trop_lourdLe corps dépasse la taille permise
- 403hors_bac_a_sableUne clé pk_test_ l'appelle : l'opération n'a pas de bac à sable
Afficher les 11 erreurs communes à toute l'APIMasquer les erreurs communes
- 401cle_absenteL'en-tête Authorization manque
- 401cle_invalideLa clé est inconnue, révoquée ou expirée
- 403organisation_suspendueL'organisation de la clé n'est pas active
- 403portee_insuffisanteLa clé ou l'accès de l'organisation n'ouvre pas cette opération
- 402credits_insuffisantsLes crédits ne suffisent plus pour cet appel
- 429plafond_cleLe plafond mensuel de crédits de la clé est atteint
- 429quota_minuteLe débit par minute de l'organisation est atteint
- 503charge_globaleL'API est momentanément surchargée, tous clients confondus ; rien n'est débité
- 504delai_depasseLe calcul dépasse le délai de l'opération ; rien n'est débité
- 503service_indisponibleL'API est momentanément indisponible
- 500erreur_interneUne erreur de notre côté ; rien n'est servi ni débité
Une ressource absente répond par un code de la famille des ressources absentes, propre à l'opération, sans débit. Guide des erreurs
Enregistrer l'adresse validée d'une annonce
Essayer en direct/api/v1/annonces/{id}/adresse-valideeEnregistre l'adresse que l'utilisateur de la clé a confirmée pour une annonce, dans le cache partagé des localisations de Pillr : une adresse par annonce, la dernière validation remplace la précédente. Elle est ensuite rendue par adresse_annonce et par localiser_annonce (etape disque), et le Hub la lit aussi. Exige une clé rattachée à un compte Pillr.
- Coût
- 0 crédit par appel réussi
- Accès
- À l'usage ou avec l'abonnement Data
- Portée
- compte
- Outil MCP
- valider_adresse
- Bac à sable
- Non
- Cache serveur
- Jamais mis en cache
- Délai maximal
- 8 s
Paramètres
idtexteobligatoireIdentifiant de l'annonce : lbc:<numéro>, bienici:<identifiant>, seloger:<numéro> ou identifiant Pillr.
de 3 à 200 caractères
libelletexteobligatoireL'adresse confirmée, en clair.
de 5 à 300 caractères
latnombrede -90 à 90
lonnombrede -180 à 180
precisiontextePrécision de l'adresse confirmée.
Valeurs :
numero,rue,lieu_dit,communeconfiancetexteCe qui fonde la validation (Street View, DPE...).
120 caractères au plus
Exemple d'appel
curl -X POST https://pillr.fr/api/v1/annonces/lbc%3A2894512345/adresse-validee \
-H "Authorization: Bearer $PILLR_CLE" \
-H "Content-Type: application/json" \
-d '{"libelle":"55 rue du Faubourg Saint-Honoré 75008 Paris"}'Réponse
enregistrebooléenidtexteIdentifiant Pillr de l'annonce.
libelletextenotetextecreditsobjetCré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).
Afficher les 2 champsMasquer
debitesentier0 au moins
restantsentier ou null
Erreurs possibles
- 400parametres_invalidesUn paramètre manque ou ne passe pas son contrôle ; le détail est donné champ par champ
- 415type_contenuLe corps n'est pas envoyé en application/json
- 400corps_illisibleLe corps n'est pas un JSON lisible
- 413corps_trop_lourdLe corps dépasse la taille permise
- 403hors_bac_a_sableUne clé pk_test_ l'appelle : l'opération n'a pas de bac à sable
Afficher les 11 erreurs communes à toute l'APIMasquer les erreurs communes
- 401cle_absenteL'en-tête Authorization manque
- 401cle_invalideLa clé est inconnue, révoquée ou expirée
- 403organisation_suspendueL'organisation de la clé n'est pas active
- 403portee_insuffisanteLa clé ou l'accès de l'organisation n'ouvre pas cette opération
- 402credits_insuffisantsLes crédits ne suffisent plus pour cet appel
- 429plafond_cleLe plafond mensuel de crédits de la clé est atteint
- 429quota_minuteLe débit par minute de l'organisation est atteint
- 503charge_globaleL'API est momentanément surchargée, tous clients confondus ; rien n'est débité
- 504delai_depasseLe calcul dépasse le délai de l'opération ; rien n'est débité
- 503service_indisponibleL'API est momentanément indisponible
- 500erreur_interneUne erreur de notre côté ; rien n'est servi ni débité
Une ressource absente répond par un code de la famille des ressources absentes, propre à l'opération, sans débit. Guide des erreurs