Recherche d'annonces analysées

Annonces de vente actives et analysées, par communes, codes postaux, départements ou autour d'un point, filtrées par type (appartement, maison, immeuble), prix, pièces, chambres, surface, prix au m², rendement brut ou net, score, DPE, passoires, état visuel, travaux, type de vendeur, SIREN ou enseigne de l'agence, mots-clés, date de parution, résidences gérées et règle « sous le marché ». Tri par rendement, score, état, date, prix, prix au m², distance ou opportunité (le radar du Hub : décote sur la commune, rendement, score, ancienneté). Chaque annonce porte son vendeur (professionnel nommé), sa diffusion multi-agences et ses drapeaux. Un crédit par annonce rendue. Coût : 1 crédit par élément rendu.

get/annonces

Request

  • Base URL: https://pillr.fr/api/v1
  • URL: https://pillr.fr/api/v1/annonces
  • Auth: HTTP bearer

Query parameters

string

Code INSEE de la commune ou de l'arrondissement (5 caractères, 2A ou 2B pour la Corse).

OR
string[]
string

Code postal.

OR
string[]
string

Code du département (01 à 95, 2A, 2B, 971 à 976).

OR
string[]
latnumber

Latitude du point de recherche (avec lon et rayon_km).

lonnumber

Longitude du point de recherche (avec lat et rayon_km).

rayon_kmnumber

Rayon autour du point, en km (50 au plus).

mots_clesstring

Mots à trouver dans le titre ou la description (4 mots au plus, accents indifférents).

type'appartement' | 'maison' | 'immeuble'

Type de bien : appartement, maison ou immeuble entier.

prix_minnumber
prix_maxnumber
pieces_mininteger
pieces_maxinteger
chambres_mininteger
surface_minnumber
surface_maxnumber
prix_m2_maxnumber
rendement_minnumber

Rendement brut minimal, en %.

rendement_net_minnumber

Rendement net minimal, en %.

score_minnumber
'A' | 'B' | 'C' | 'D' | 'E' | 'F' | 'G'
OR
string[]
dpe_max'A' | 'B' | 'C' | 'D' | 'E' | 'F' | 'G'

Étiquette DPE la moins bonne acceptée (D : de A à D).

boolean
OR
string
etat_visuel_maxnumber

État visuel maximal sur 100 (pour chercher des biens à rénover).

travaux_minnumber

Travaux minimaux, sur le bas de la fourchette, en euros.

travaux_maxnumber

Travaux maximaux, sur le haut de la fourchette (le pire cas), en euros.

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

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

sirenstring

SIREN de l'agence ou du professionnel.

enseignestring

Nom ou enseigne de l'agence (début du nom).

boolean
OR
string
boolean
OR
string
publie_depuisstring

Annonces parues depuis cette date (AAAA-MM-JJ).

tri'rendement' | 'rendement_net' | 'score' | 'etat' | 'date' | 'prix' | 'prix_desc' | 'prix_m2' | 'opportunite' | 'distance'

rendement (défaut), rendement_net, score, etat (meilleur état d'abord), date (plus récentes), prix, prix_desc, prix_m2, distance (avec lat, lon, rayon_km), opportunite (radar du Hub, sur les 250 annonces les mieux notées de la recherche).

limiteinteger

Nombre d'éléments par page (50 au plus).

curseurstring

Curseur opaque rendu par la page précédente (curseur_suivant), à repasser tel quel.

string
OR
string[]

Response

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

totalinteger nullable required

Annonces qui répondent, comptées sur la première page jusqu'à 10 000 ; null au-delà ou sur les pages suivantes.

notesstring[] required
curseur_suivantstring nullable required

Curseur de la page suivante, à repasser dans curseur ; null sur la dernière page.

Changes

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