Essai en direct

Appelez une opération de l'API depuis votre navigateur avec une clé de test pk_test_ : la réponse, ses en-têtes de crédits et l'appel équivalent en curl. Une clé de test se crée dans le mon espace.

/

Opération

1 crédit par élément rendu. Bac à sable : une clé de test reçoit la réponse sur un jeu figé, sans débit. Référence

GET/api/v1/annonces/archives

Paramètres facultatifs (25)

fondstexte, requête

lac (défaut) : toutes les annonces balayées par Pillr ; pige et scraper_lbc : archives figées de l'ancienne pige et de l'ancien balayage Leboncoin.

inseevaleur, requête

Code INSEE d'une commune, ou liste de 10 codes au plus (paramètre répété).

cpvaleur, requête

Code postal, ou liste de 10 codes au plus.

departementvaleur, requête

Code de département, ou liste de 8 codes au plus.

latnombre, requête

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

lonnombre, requête

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

rayon_kmnombre, requête

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

sirentexte, requête

typetexte, requête

Type de bien : appartement, maison ou immeuble entier.

prix_minnombre, requête

0 au moins

prix_maxnombre, requête

0 au moins

surface_minnombre, requête

0 au moins

surface_maxnombre, requête

0 au moins

publie_aprestexte, requête

Parues à partir de cette date (AAAA-MM-JJ).

publie_avanttexte, requête

Parues avant cette date.

retire_aprestexte, requête

Retirées à partir de cette date.

retire_avanttexte, requête

Retirées avant cette date.

statuttexte, requête

toutes par défaut.

sourcetexte, requête

type_vendeurtexte, requête

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

avec_baissevaleur, requête

Vrai : seulement les annonces dont le prix a baissé.

tritexte, requête

date (défaut, plus récentes d'abord), prix, prix_desc.

limiteentier, requête

Nombre d'éléments par page (50 au plus). de 1 à 50 ; par défaut 20

curseurtexte, requête

Curseur opaque rendu par la page précédente (curseur_suivant), à repasser tel quel. de 1 à 1 024 caractères

champsvaleur, requête

Champs rendus, séparés par des virgules (« prix,surface,analyse.score ») ; tous si absent.

Clé de test

Seule une clé pk_test_ est acceptée : sans débit, sur le bac à sable. Elle reste dans cette page, le temps de la visite : ni conservée, ni journalisée, ni envoyée ailleurs qu'à l'API.

Appel équivalent

curl https://pillr.fr/api/v1/annonces/archives \
  -H "Authorization: Bearer $PILLR_CLE"

La réponse, ses en-têtes de crédits et sa durée s'affichent ici.