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 tranche de 10 lignes rendues. Pas de bac à sable : une clé de test reçoit l'erreur hors_bac_a_sable. Référence

GET/api/v1/annonces/carte

bboxtexte, requêteobligatoire

Emprise de la carte : sud,ouest,nord,est en degrés décimaux (3 degrés de côté au plus). 120 caractères au plus

Paramètres facultatifs (11)

inseevaleur, requête

departementvaleur, requête

cpvaleur, requête

mots_clestexte, requête

de 3 à 100 caractères

typetexte, requête

Type de bien : appartement, maison ou immeuble entier.

type_vendeurtexte, requête

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

dpevaleur, requête

travaux_maxnombre, requête

0 au moins

sous_le_marchevaleur, requête

limiteentier, requête

Nombre d'éléments par page (1000 au plus). de 1 à 1 000 ; par défaut 500

curseurtexte, requête

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

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/carte?bbox=%3Cbbox%3E" \
  -H "Authorization: Bearer $PILLR_CLE"

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