Annonce par lien ou identifiant

Fiche complète d'une annonce de vente analysée, retrouvée par son lien Leboncoin, BienIci ou SeLoger, ou par son identifiant : faits du bien et détails du portail (honoraires, taxe foncière, copropriété, équipements), vendeur professionnel nommé avec son enseigne, son SIREN et son mandat, photos et description, analyse complète (score et sous-scores, verdict, forces et faiblesses, leviers et cibles de négociation, loyer, rendements recalculés, budget, travaux par poste lus sur les photos, stratégie locative, régime fiscal), valeurs brutes du modèle à côté des valeurs recalculées, coût de sortie de passoire, échéance de location, historique des prix et diffusion en nombres. Données brutes du portail avec inclure=brut, pour un professionnel. Rien n'est débité si l'annonce est absente ou pas encore analysée. Coût : 3 crédits par appel réussi.

get/annonces/par-url

Request

Base URL: https://pillr.fr/api/v1
URL: https://pillr.fr/api/v1/annonces/par-url
Auth: HTTP bearer

Query parameters

urlstring uri

Lien de l'annonce sur le portail d'origine.

Response

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

idstring required

Identifiant Pillr de l'annonce.

id_portailstring nullable

Identifiant chez le portail (lbc:<n>, bienici:<id>, seloger:<id>), servi avec la portée lien_origine.

lienstring nullable

Lien d'origine de l'annonce, servi avec la portée lien_origine.

sourcestring

statut'actif' | 'retire' | 'masque'

actif : en ligne ; retire : retirée du portail ; masque : ni l'un ni l'autre (contrôle en cours).

actifboolean

typestring

neuf_ancienstring nullable

communestring nullable

code_postalstring nullable

inseestring nullable

departementstring nullable

regionstring nullable

prixnumber nullable

prix_m2number nullable

Prix divisé par la surface (jamais la valeur du portail).

prix_m2_portailnumber nullable

Prix au m² affiché par le portail, servi à côté.

surfacenumber nullable

piecesnumber nullable

chambresnumber nullable

etagenumber nullable

nb_etagesnumber nullable

salles_de_bainnumber nullable

salles_d_eaunumber nullable

terrain_m2number nullable

jardin_privatif_m2number nullable

terrain_portail_m2number nullable

terrain_suspectboolean nullable

Vrai si le terrain d'une maison est plus petit que sa surface habitable.

annee_constructionnumber nullable

type_vendeur'pro' | 'particulier' | 'inconnu'

Statut du vendeur déclaré par le portail : pro (agence, réseau, promoteur), particulier, ou inconnu.

titrestring nullable

descriptionstring nullable

Description du portail, en texte ; les coordonnées d'un vendeur qui n'est pas un professionnel en sont retirées.

photosstring[]

Liens des photos chez le portail.

vu_lestring nullable

retire_lestring nullable

entree_lestring nullable

maj_lestring nullable

bien_uidstring nullable

Bien dédoublonné qui porte l'annonce (opération bien).

brutobject nullable

Données brutes du portail, avec inclure=brut, pour un vendeur professionnel seulement ; null sinon.

drapeauxstring[]

Ce qui doit faire lire l'annonce avec prudence ; vide si rien.

Changes

No recorded changes to this operation across all 1 revision of this API.