Flux d'évènements des annonces

Les évènements datés du catalogue des annonces de vente, dans l'ordre où ils ont été écrits : nouvelle annonce, analyse publiée ou refaite, baisse et hausse de prix, retrait, réactivation, passage à plusieurs agences. Chaque évènement porte l'état avant et après, et l'annonce au format liste. Filtres : depuis (date), genres, communes, codes postaux, départements. Le curseur_suivant est rendu même sur la dernière page : repassez-le plus tard, avec les mêmes filtres, pour ne lire que la suite ; a_jour dit qu'il n'y a plus rien à lire pour l'instant. Les baisses de prix sont dédoublonnées au jour et au nouveau prix. Coût : 1 crédit par évènement livré.

get/flux/annonces

Request

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

Query parameters

depuisstring

Ne lire que les évènements écrits depuis cette date (AAAA-MM-JJ ou horodatage ISO 8601).

'nouvelle' | 'analyse' | 'reanalyse' | 'baisse_prix' | 'hausse_prix' | 'retrait' | 'reactivation' | 'multi_agences'

nouvelle (annonce entrée au catalogue), analyse (première analyse publiée), reanalyse (analyse refaite), baisse_prix, hausse_prix, retrait (annonce retirée du portail), reactivation, multi_agences (le bien passe à deux agences ou plus).

OR
string[]
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[]
limiteinteger

Nombre d'éléments par page (1000 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).

a_jourboolean required

Vrai quand le flux n'a plus rien à lire pour l'instant : repassez curseur_suivant plus tard pour reprendre.

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.