Ventes DVF autour d'un point, dans une commune ou par mutation

Les mutations DVF une par une, avec toutes leurs lignes, leur adresse DVF, leurs lots, leurs parcelles et leur position : autour d'un point (rayon de 2000 m au plus), dans une commune (l'arrondissement à Paris, Lyon et Marseille), ou par identifiant de mutation. Filtres : type de local, nature de la mutation, période, surface des logements, valeur foncière. Tri par date (le plus récent d'abord) ou par distance. Le prix au m² est recalculé à la mutation sur la surface de ses logements, avec sa qualité (vente en bloc, prix atypique et son motif). Les filtres de surface et de valeur s'appliquent après lecture : une page peut compter moins de mutations que la limite, curseur_suivant dit s'il en reste. Ventes de 2021 et suivantes ; les lignes d'une mutation situées dans une autre commune ne sont pas relues. Coût : 1 crédit par élément rendu.

get/ventes

Request

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

Query parameters

latnumber

Latitude du point (WGS 84), avec lon.

lonnumber

Longitude du point (WGS 84), avec lat.

rayon_minteger

Rayon autour du point, en mètres (300 par défaut, 2000 au plus).

inseestring

Code INSEE de la commune DVF (l'arrondissement à Paris, Lyon et Marseille).

type'appartement' | 'maison' | 'dependance' | 'local'

Ne garder que les mutations qui comptent ce type de local.

nature'vente' | 'vefa' | 'terrain_a_batir' | 'adjudication' | 'echange' | 'expropriation'

Nature de la mutation : vente, vefa, terrain_a_batir, adjudication, echange, expropriation.

depuisstring

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

jusqu_astring

Mutations jusqu'à cette date comprise (AAAA-MM-JJ).

surface_minnumber

Surface bâtie des logements, minimum, en m².

surface_maxnumber

Surface bâtie des logements, maximum, en m².

prix_minnumber

Valeur foncière de la mutation, minimum, en euros.

prix_maxnumber

Valeur foncière de la mutation, maximum, en euros.

tri'date' | 'distance'

date (le plus récent d'abord) ou distance (autour d'un point seulement). Par défaut : distance autour d'un point, date sinon.

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.

Response

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

limitesstring[] required

Ce que la page ne couvre pas, en clair.

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.