Aller au contenu

Documentation

Flux d'évènements

8 opérations servies.

Flux d'évènements des annonces

GET/api/v1/flux/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é
Accès
Avec l'abonnement Data
Portée
flux
Outil MCP
flux_annonces
Bac à sable
Non
Mémoire
0 min
Délai
6 s

Essayer en direct

Paramètres

  • depuistexte

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

    40 caractères au plus

  • genresvaleur

    Genre, ou liste de genres (paramètre répété) ; tous si absent.

  • inseevaleur

    Code INSEE, ou liste de 20 codes au plus (paramètre répété).

  • cpvaleur

    Code postal, ou liste de 20 codes au plus.

  • departementvaleur

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

  • limiteentier

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

    de 1 à 1 000 ; par défaut 100

  • curseurtexte

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

    de 1 à 1 024 caractères

Exemple d'appel

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

Réponse

  • evenementsliste d'objets

    Les évènements, dans l'ordre du flux.

    Afficher les 7 champs
    • idtexte

      Identifiant de l'évènement, croissant dans l'ordre du flux.

    • genretexte

      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).

      Valeurs : nouvelle, analyse, reanalyse, baisse_prix, hausse_prix, retrait, reactivation, multi_agences

    • letexte

      Horodatage de l'évènement (ISO 8601).

    • annonce_idtexte

      Identifiant Pillr de l'annonce.

    • avantobjet ou null

      État de l'annonce avant ou après l'évènement.

      Afficher les 10 champs
      • prixnombre ou null

        Prix, en euros (baisse_prix, hausse_prix, nouvelle).

      • ecart_pctnombre ou null

        Écart du prix, en % (baisse_prix, hausse_prix).

      • detecte_letexte ou null

        Date de détection du changement de prix.

      • actifbooléen ou null

        Annonce en ligne (retrait, reactivation, nouvelle).

      • analyse_letexte ou null

        Date de l'analyse (analyse, reanalyse).

      • scorenombre ou null

        Score Pillr de l'analyse (analyse, reanalyse).

      • nb_agencesnombre ou null

        Agences qui publient le bien (multi_agences).

      • nb_portailsnombre ou null

        Portails qui publient le bien (multi_agences).

      • prix_minnombre ou null

        Prix le plus bas entre les annonces du bien (multi_agences).

      • prix_maxnombre ou null

        Prix le plus haut entre les annonces du bien (multi_agences).

    • apresobjet ou null

      État de l'annonce avant ou après l'évènement.

      Afficher les 10 champs
      • prixnombre ou null

        Prix, en euros (baisse_prix, hausse_prix, nouvelle).

      • ecart_pctnombre ou null

        Écart du prix, en % (baisse_prix, hausse_prix).

      • detecte_letexte ou null

        Date de détection du changement de prix.

      • actifbooléen ou null

        Annonce en ligne (retrait, reactivation, nouvelle).

      • analyse_letexte ou null

        Date de l'analyse (analyse, reanalyse).

      • scorenombre ou null

        Score Pillr de l'analyse (analyse, reanalyse).

      • nb_agencesnombre ou null

        Agences qui publient le bien (multi_agences).

      • nb_portailsnombre ou null

        Portails qui publient le bien (multi_agences).

      • prix_minnombre ou null

        Prix le plus bas entre les annonces du bien (multi_agences).

      • prix_maxnombre ou null

        Prix le plus haut entre les annonces du bien (multi_agences).

    • annonceobjet ou null

      L'annonce au format liste ; null si elle n'est plus servie (doublon d'un autre portail, sortie du catalogue).

      Afficher les 26 champs
      • idtexte

        Identifiant Pillr de l'annonce (à repasser à /annonces/{id}).

      • id_portailtexte ou null

        Identifiant chez le portail, servi avec la portée lien_origine.

      • lientexte ou null

        Lien d'origine de l'annonce, servi avec la portée lien_origine.

      • sourcetexte ou null

        Portail d'origine : lbc, bienici ou seloger.

      • statuttexte ou null

        actif, retire ou masque.

      • typetexte ou null

        appartement, maison ou immeuble.

      • communetexte ou null
      • code_postaltexte ou null
      • inseetexte ou null
      • departementtexte ou null
      • latnombre ou null
      • lonnombre ou null
      • precision_coordonneestexte ou null

        adresse, approchee, centre_commune ou inconnue.

      • prixnombre ou null
      • surfacenombre ou null
      • piecesnombre ou null
      • prix_m2nombre ou null

        Prix divisé par la surface (jamais la valeur du portail).

      • dpetexte ou null

        Valeurs : A, B, C, D, E, F, G

      • scorenombre ou null

        Score Pillr sur 100 ; null tant que l'annonce n'est pas analysée.

      • rendement_brutnombre ou null

        Rendement brut en %, recalculé depuis le loyer estimé et le prix.

      • rendement_netnombre ou null

        Rendement net en %, recalculé sur le budget total.

      • etat_visuelnombre ou null

        État visuel lu sur les photos, sur 100.

      • premiere_parutiontexte ou null
      • type_vendeurtexte

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

        Valeurs : pro, particulier, inconnu

      • annonceurobjet

        Le vendeur : un professionnel est nommé, un particulier jamais.

        Afficher les 4 champs
        • type_vendeurtexte

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

          Valeurs : pro, particulier, inconnu

        • nomtexte ou null

          Nom de l'agence ou du professionnel ; null pour un particulier.

        • enseignetexte ou null

          Enseigne ou réseau du professionnel ; null pour un particulier.

        • sirentexte ou null

          SIREN du professionnel quand le portail le publie ; null pour un particulier.

      • drapeauxliste de textes

        Ce qui doit faire lire l'annonce avec prudence ; vide si rien.

        Valeurs : prix_atypique, surface_atypique, vente_en_bloc, doublon_probable, date_estimee, peu_d_observations, valeur_imputee, rattachement_incertain, donnee_ancienne

  • a_jourbooléen

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

  • qualiteobjet

    Ce qui permet de juger la valeur : nombre, provenance, incertitude, drapeaux, date et source.

    Afficher les 7 champs
    • nentier ou null

      Nombre d'observations derrière la valeur ; null si sans objet.

      0 au moins

    • provenancetexte ou null

      mesure : observé sur la donnée ; estime : modèle, barème ou imputation ; null : sans objet.

      Valeurs : mesure, estime

    • incertitudeobjet ou null

      Incertitude de la valeur : fourchette et demi-largeur.

      Afficher les 3 champs
      • demi_largeur_pctnombre ou null

        Demi-largeur de la fourchette, en % de la valeur.

      • basnombre ou null
      • hautnombre ou null
    • drapeauxliste de textes

      Ce qui doit faire lire la valeur avec prudence ; vide si rien.

      Valeurs : prix_atypique, surface_atypique, vente_en_bloc, doublon_probable, date_estimee, peu_d_observations, valeur_imputee, rattachement_incertain, donnee_ancienne

    • methodetexte ou null

      Méthode de calcul ou de rattachement, en clair.

    • donnees_dutexte ou null

      Date de la donnée (AAAA-MM-JJ ou horodatage ISO 8601).

    • sourcetexte

      Source publique ou moteur Pillr, en clair.

  • curseur_suivanttexte ou null

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

  • creditsobjet

    Crédits débités par cet appel (réservés, pour une tâche en cours), et crédits encore utilisables ce mois avant la coupure : crédits offerts, crédits inclus du mois et crédits facturables sous le plafond de dépense (null si inconnus ou en bac à sable).

    Afficher les 2 champs
    • debitesentier

      0 au moins

    • restantsentier ou null

Erreurs possibles

Une ressource absente répond par un code de la famille des ressources absentes, propre à l'opération, sans débit.

Flux de nouveautés à l'adresse

GET/api/v1/flux/adresses

Les nouveautés datées à l'adresse, lues dans le journal tenu chaque nuit après la reconstruction de la donnée à l'adresse : nouveau DPE, nouvel audit énergétique, nouvelle autorisation d'urbanisme, nouvel avis d'une société civile au siège, nouvelle vente DVF. Chaque évènement porte la clé BAN, la date à la source, le détail et la source publique. Filtres : depuis (date d'entrée au journal), genres, communes, codes postaux. 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.

Coût
1 crédit par évènement livré
Accès
Avec l'abonnement Data
Portée
flux
Outil MCP
flux_adresses
Bac à sable
Non
Mémoire
1 min
Délai
4 s

Essayer en direct

Paramètres

  • depuistexte

    Ne lire que les évènements entrés au journal depuis cette date.

    40 caractères au plus

  • genresvaleur

    Genre, ou liste de genres ; tous si absent.

  • inseevaleur

    Code INSEE, ou liste de 20 codes au plus (paramètre répété).

  • cpvaleur

    Code postal, ou liste de 20 codes au plus.

  • limiteentier

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

    de 1 à 1 000 ; par défaut 100

  • curseurtexte

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

    de 1 à 1 024 caractères

Exemple d'appel

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

Réponse

  • evenementsliste de valeurs

    Les évènements, dans l'ordre du journal.

  • a_jourbooléen

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

  • qualiteobjet

    Ce qui permet de juger la valeur : nombre, provenance, incertitude, drapeaux, date et source.

    Afficher les 7 champs
    • nentier ou null

      Nombre d'observations derrière la valeur ; null si sans objet.

      0 au moins

    • provenancetexte ou null

      mesure : observé sur la donnée ; estime : modèle, barème ou imputation ; null : sans objet.

      Valeurs : mesure, estime

    • incertitudeobjet ou null

      Incertitude de la valeur : fourchette et demi-largeur.

      Afficher les 3 champs
      • demi_largeur_pctnombre ou null

        Demi-largeur de la fourchette, en % de la valeur.

      • basnombre ou null
      • hautnombre ou null
    • drapeauxliste de textes

      Ce qui doit faire lire la valeur avec prudence ; vide si rien.

      Valeurs : prix_atypique, surface_atypique, vente_en_bloc, doublon_probable, date_estimee, peu_d_observations, valeur_imputee, rattachement_incertain, donnee_ancienne

    • methodetexte ou null

      Méthode de calcul ou de rattachement, en clair.

    • donnees_dutexte ou null

      Date de la donnée (AAAA-MM-JJ ou horodatage ISO 8601).

    • sourcetexte

      Source publique ou moteur Pillr, en clair.

  • curseur_suivanttexte ou null

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

  • creditsobjet

    Crédits débités par cet appel (réservés, pour une tâche en cours), et crédits encore utilisables ce mois avant la coupure : crédits offerts, crédits inclus du mois et crédits facturables sous le plafond de dépense (null si inconnus ou en bac à sable).

    Afficher les 2 champs
    • debitesentier

      0 au moins

    • restantsentier ou null

Erreurs possibles

Une ressource absente répond par un code de la famille des ressources absentes, propre à l'opération, sans débit.

Créer un agent de veille

POST/api/v1/veilles

Crée un agent de veille sur les annonces, rattaché au compte de la clé : à partir d'une mission en langage naturel, traduite en pré-filtre par un modèle de langage, ou de critères exacts (recherche), sans modèle. L'agent remonte chaque jour les nouvelles annonces qui collent, jugées contre la mission par le juge IA ; ses résultats se lisent par resultats_veilles. Le compte garde un plafond d'agents actifs. Un agent créé par l'API est rattaché à l'organisation de la clé et débité, tant qu'il est actif, de 1 crédit par jour (barème veille_jour).

Coût
20 crédits par appel réussi ; 0 crédit par appel réussi avec des critères exacts (recherche)
Accès
À l'usage ou avec l'abonnement Data
Portée
flux
Outil MCP
veilles_creer
Bac à sable
Non
Mémoire
Jamais gardée
Délai
30 s

Essayer en direct

Paramètres

  • missiontexte

    Ce que l'agent surveille, en une phrase.

    de 3 à 500 caractères

  • rechercheobjet

    Critères exacts, sans interprétation par un modèle.

    Afficher les 22 champs
    • communesliste de textes

      Noms de communes (le moteur des veilles suit les communes par leur nom).

      60 éléments au plus

    • cpliste de textes

      60 éléments au plus

    • departementliste de textes

      20 éléments au plus

    • autourobjet

      Un cercle autour d'un point ; il remplace les communes.

      Afficher les 3 champs
      • latnombreobligatoire

        de -90 à 90

      • lonnombreobligatoire

        de -180 à 180

      • rayon_kmnombreobligatoire

        de 0,5 à 100

    • typetexte

      Valeurs : appartement, maison, immeuble

    • prix_minnombre

      0 au moins

    • prix_maxnombre

      0 au moins

    • surface_minnombre

      0 au moins

    • surface_maxnombre

      0 au moins

    • pieces_minentier

      de 0 à 50

    • pieces_maxentier

      de 0 à 50

    • prix_m2_minnombre

      0 au moins

    • prix_m2_maxnombre

      0 au moins

    • terrain_minnombre

      0 au moins

    • terrain_maxnombre

      0 au moins

    • travaux_minnombre

      0 au moins

    • travaux_maxnombre

      0 au moins

    • rendement_minnombre

      Rendement brut minimal, en %.

      de 0 à 100

    • rendement_net_minnombre

      de 0 à 100

    • score_minnombre

      de 0 à 100

    • dpe_maxtexte

      Pire DPE accepté.

      Valeurs : A, B, C, D, E, F, G

    • exclure_residences_gereesbooléen
  • nomtexte

    de 1 à 120 caractères

  • frequencetexte

    immediate, daily (défaut) ou weekly : cadence des notifications du compte.

    Valeurs : immediate, daily, weekly

  • signauxobjet

    Les signaux suivis par l'agent.

    Afficher les 3 champs
    • nouvellesbooléen

      Nouvelles annonces qui correspondent (vrai par défaut).

    • baissesbooléen

      Baisses de prix des annonces qui correspondent (faux par défaut).

    • negociationbooléen

      Annonces dont la décote par rapport à la cible de négociation est forte (faux par défaut).

  • actifbooléen

    Faux : l'agent est créé en pause (vrai par défaut).

Exemple d'appel

curl -X POST https://pillr.fr/api/v1/veilles \
  -H "Authorization: Bearer $PILLR_CLE" \
  -H "Content-Type: application/json" \
  -d '{}'

Réponse

  • veilleobjet
    Afficher les 9 champs
    • idtexte
    • nomtexte ou null
    • missiontexte ou null

      Intention en langage naturel, lue chaque jour par le juge IA.

    • actifbooléen
    • frequencetexte ou null
    • criteresliste de textes

      Les critères enregistrés, en clair, relus sur la ligne enregistrée.

    • dernier_jugement_iatexte ou null
    • biens_7jentier

      Biens remontés par l'agent sur les 7 derniers jours.

    • cree_letexte ou null
  • non_reprisliste de textes

    Ce que le moteur des veilles ne filtre pas et que seul le juge IA lit dans la mission.

  • vivierentier ou null

    Annonces analysées qui collent déjà au pré-filtre ; null s'il n'a pas pu être compté.

  • creditsobjet

    Crédits débités par cet appel (réservés, pour une tâche en cours), et crédits encore utilisables ce mois avant la coupure : crédits offerts, crédits inclus du mois et crédits facturables sous le plafond de dépense (null si inconnus ou en bac à sable).

    Afficher les 2 champs
    • debitesentier

      0 au moins

    • restantsentier ou null

Erreurs possibles

Une ressource absente répond par un code de la famille des ressources absentes, propre à l'opération, sans débit.

Agents de veille du compte

GET/api/v1/veilles

Les agents de veille du compte de la clé, actifs d'abord : mission, critères enregistrés, date du dernier jugement IA et biens remontés sur 7 jours.

Coût
0 crédit par appel réussi
Accès
À l'usage ou avec l'abonnement Data
Portée
flux
Outil MCP
veilles
Bac à sable
Non
Mémoire
Jamais gardée
Délai
4 s

Essayer en direct

Paramètres

Aucun.

Exemple d'appel

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

Réponse

  • veillesliste d'objets
    Afficher les 9 champs
    • idtexte
    • nomtexte ou null
    • missiontexte ou null

      Intention en langage naturel, lue chaque jour par le juge IA.

    • actifbooléen
    • frequencetexte ou null
    • criteresliste de textes

      Les critères enregistrés, en clair, relus sur la ligne enregistrée.

    • dernier_jugement_iatexte ou null
    • biens_7jentier

      Biens remontés par l'agent sur les 7 derniers jours.

    • cree_letexte ou null
  • activesentier
  • max_activesentier

    Agents actifs permis au compte.

  • creditsobjet

    Crédits débités par cet appel (réservés, pour une tâche en cours), et crédits encore utilisables ce mois avant la coupure : crédits offerts, crédits inclus du mois et crédits facturables sous le plafond de dépense (null si inconnus ou en bac à sable).

    Afficher les 2 champs
    • debitesentier

      0 au moins

    • restantsentier ou null

Erreurs possibles

Une ressource absente répond par un code de la famille des ressources absentes, propre à l'opération, sans débit.

Modifier un agent de veille

PATCH/api/v1/veilles/{id}

Met un agent de veille en pause ou le réactive, le renomme, change sa mission ou sa fréquence. Une réactivation respecte le plafond d'agents actifs du compte. Le même appel répété laisse le même état.

Coût
0 crédit par appel réussi
Accès
À l'usage ou avec l'abonnement Data
Portée
flux
Outil MCP
veilles_modifier
Bac à sable
Non
Mémoire
Jamais gardée
Délai
6 s

Essayer en direct

Paramètres

  • idtexteobligatoire

    Identifiant de l'agent.

    format uuid

  • actifbooléen
  • nomtexte

    de 1 à 120 caractères

  • missiontexte

    de 3 à 500 caractères

  • frequencetexte

    Valeurs : immediate, daily, weekly

Exemple d'appel

curl -X POST https://pillr.fr/api/v1/veilles/{id} \
  -H "Authorization: Bearer $PILLR_CLE" \
  -H "Content-Type: application/json" \
  -d '{}'

Réponse

  • veilleobjet
    Afficher les 9 champs
    • idtexte
    • nomtexte ou null
    • missiontexte ou null

      Intention en langage naturel, lue chaque jour par le juge IA.

    • actifbooléen
    • frequencetexte ou null
    • criteresliste de textes

      Les critères enregistrés, en clair, relus sur la ligne enregistrée.

    • dernier_jugement_iatexte ou null
    • biens_7jentier

      Biens remontés par l'agent sur les 7 derniers jours.

    • cree_letexte ou null
  • creditsobjet

    Crédits débités par cet appel (réservés, pour une tâche en cours), et crédits encore utilisables ce mois avant la coupure : crédits offerts, crédits inclus du mois et crédits facturables sous le plafond de dépense (null si inconnus ou en bac à sable).

    Afficher les 2 champs
    • debitesentier

      0 au moins

    • restantsentier ou null

Erreurs possibles

Une ressource absente répond par un code de la famille des ressources absentes, propre à l'opération, sans débit.

Résultats des veilles et des alertes

GET/api/v1/resultats
GET/api/v1/veilles/{veille}/resultats
GET/api/v1/alertes/{alerte}/resultats

Ce que les veilles et les alertes du compte de la clé ont remonté, du plus ancien au plus récent : pour un agent de veille, les annonces retenues avec le signal et la raison du juge IA ; pour un suivi de zone, les signaux par volet avec leur clé, leur score et leur instantané ; pour une veille pré-marché, les adresses avec leur priorité et leur probabilité. Chaque résultat dit s'il est déjà parti dans une notification du compte. Un crédit par résultat rendu, sauf un résultat déjà livré et débité par un abonnement webhook.

Coût
1 crédit par évènement livré
Accès
À l'usage ou avec l'abonnement Data
Portée
flux
Outil MCP
resultats_veilles
Bac à sable
Non
Mémoire
Jamais gardée
Délai
5 s

Essayer en direct

Paramètres de /api/v1/resultats

  • depuistexte

    Ne lire que les résultats remontés depuis cette date.

    40 caractères au plus

  • genretexte

    Valeurs : annonce, signal_zone, adresse_pre_marche

  • volettexte

    Volet d'un suivi de zone.

    Valeurs : pre_marche, particuliers, marche

  • non_notifiesvaleur

    Vrai : seulement les résultats pas encore notifiés.

  • limiteentier

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

    de 1 à 50 ; par défaut 20

  • curseurtexte

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

    de 1 à 1 024 caractères

Paramètres de /api/v1/veilles/{veille}/resultats

  • veilletexteobligatoire

    Identifiant d'un agent de veille.

    format uuid

Paramètres de /api/v1/alertes/{alerte}/resultats

  • alertetexteobligatoire

    Identifiant d'un suivi de zone ou d'une veille pré-marché.

    format uuid

Exemple d'appel

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

Réponse

  • resultatsliste d'objets

    Les résultats, du plus ancien au plus récent.

    Afficher les 16 champs
    • idtexte
    • alerte_idtexte

      Identifiant de la veille ou de l'alerte qui a remonté ce résultat.

    • genretexte

      annonce (agent de veille), signal_zone (suivi de zone) ou adresse_pre_marche (veille pré-marché).

      Valeurs : annonce, signal_zone, adresse_pre_marche

    • annonce_idtexte ou null
    • cle_bantexte ou null
    • volettexte ou null

      Volet d'un suivi de zone : pre_marche, particuliers ou marche.

    • signaltexte ou null

      Le signal : new, price_drop, nego, multi_agency, ai (veilles) ; pre_marche, stagne, baisse_pap, republie, baisse, multi_mandat (zones).

    • detailobjet ou null

      Le contexte du signal (ancien et nouveau prix, décote, raison du juge IA).

    • scorenombre ou null

      Ordre d'affichage dans le volet d'un suivi de zone.

    • prioritenombre ou null

      Priorité d'une adresse du pré-marché (probabilité de mise en vente multipliée par la fenêtre de mandat).

    • p_mise_en_vente_6mnombre ou null

      Probabilité de mise en vente sous 6 mois d'une adresse du pré-marché.

    • instantaneobjet ou null

      L'annonce ou l'adresse telle qu'elle était au moment du signal.

    • letexte

      Date du résultat.

    • notifiebooléen

      Vrai si ce résultat est déjà parti dans une notification du compte.

    • livre_par_webhookbooléen

      Vrai si ce résultat a déjà été livré et débité par un abonnement webhook : il n'est pas débité de nouveau.

    • qualiteobjet

      Ce qui permet de juger la valeur : nombre, provenance, incertitude, drapeaux, date et source.

      Afficher les 7 champs
      • nentier ou null

        Nombre d'observations derrière la valeur ; null si sans objet.

        0 au moins

      • provenancetexte ou null

        mesure : observé sur la donnée ; estime : modèle, barème ou imputation ; null : sans objet.

        Valeurs : mesure, estime

      • incertitudeobjet ou null

        Incertitude de la valeur : fourchette et demi-largeur.

        Afficher les 3 champs
        • demi_largeur_pctnombre ou null

          Demi-largeur de la fourchette, en % de la valeur.

        • basnombre ou null
        • hautnombre ou null
      • drapeauxliste de textes

        Ce qui doit faire lire la valeur avec prudence ; vide si rien.

        Valeurs : prix_atypique, surface_atypique, vente_en_bloc, doublon_probable, date_estimee, peu_d_observations, valeur_imputee, rattachement_incertain, donnee_ancienne

      • methodetexte ou null

        Méthode de calcul ou de rattachement, en clair.

      • donnees_dutexte ou null

        Date de la donnée (AAAA-MM-JJ ou horodatage ISO 8601).

      • sourcetexte

        Source publique ou moteur Pillr, en clair.

  • curseur_suivanttexte ou null

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

  • creditsobjet

    Crédits débités par cet appel (réservés, pour une tâche en cours), et crédits encore utilisables ce mois avant la coupure : crédits offerts, crédits inclus du mois et crédits facturables sous le plafond de dépense (null si inconnus ou en bac à sable).

    Afficher les 2 champs
    • debitesentier

      0 au moins

    • restantsentier ou null

Erreurs possibles

Une ressource absente répond par un code de la famille des ressources absentes, propre à l'opération, sans débit.

Notifications du compte

GET/api/v1/compte/notifications

Les signaux détectés chaque matin sur ce que suit l'utilisateur de la clé : baisse de prix d'un favori (price_drop), annonce sur-cotée en ligne depuis plus de soixante jours sans baisse (nego_opportunity), valorisation possible après des travaux raisonnables (post_works_profit), prix en baisse dans une commune suivie (zone_trend). Les plus récentes d'abord, les écartées exclues sauf demande. Le scan ne tourne que pour les comptes qui ont un profil investisseur.

Coût
1 crédit par évènement livré
Accès
À l'usage ou avec l'abonnement Data
Portée
flux
Outil MCP
notifications
Bac à sable
Non
Mémoire
Jamais gardée
Délai
3 s

Essayer en direct

Paramètres

  • depuistexte

    Les notifications créées à partir de cette date.

  • typesvaleur

    Types à rendre (paramètre répétable).

  • non_luesvaleur

    Vrai : les non lues seulement.

  • ecarteesvaleur

    Vrai : inclut les notifications écartées.

  • limiteentier

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

    de 1 à 50 ; par défaut 30

  • curseurtexte

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

    de 1 à 1 024 caractères

Exemple d'appel

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

Réponse

  • notificationsliste d'objets
    Afficher les 10 champs
    • idtexte

      format uuid

    • typetexte

      price_drop, nego_opportunity, post_works_profit ou zone_trend.

    • annonce_idtexte ou null

      Identifiant Pillr de l'annonce concernée.

    • importancetexte

      basse, moyenne ou haute.

    • titretexte
    • messagetexte
    • chargeobjet

      Le détail du signal, tel que le scan l'a écrit.

    • cree_letexte ou null

      Horodatage ISO 8601.

    • lue_letexte ou null

      Horodatage ISO 8601.

    • ecartee_letexte ou null

      Horodatage ISO 8601.

  • non_luesentier

    Notifications non lues et non écartées du compte.

  • curseur_suivanttexte ou null

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

  • creditsobjet

    Crédits débités par cet appel (réservés, pour une tâche en cours), et crédits encore utilisables ce mois avant la coupure : crédits offerts, crédits inclus du mois et crédits facturables sous le plafond de dépense (null si inconnus ou en bac à sable).

    Afficher les 2 champs
    • debitesentier

      0 au moins

    • restantsentier ou null

Erreurs possibles

Une ressource absente répond par un code de la famille des ressources absentes, propre à l'opération, sans débit.

Marquer une notification

POST/api/v1/compte/notifications/{id}

Marque une notification du compte comme lue ou non lue, écartée ou non. Le même appel deux fois laisse le même état.

Coût
0 crédit par appel réussi
Accès
À l'usage ou avec l'abonnement Data
Portée
flux
Outil MCP
notifications_modifier
Bac à sable
Non
Mémoire
Jamais gardée
Délai
3 s

Essayer en direct

Paramètres

  • idtexteobligatoire

    Identifiant de la notification.

    format uuid

  • luebooléen
  • ecarteebooléen

Exemple d'appel

curl -X POST https://pillr.fr/api/v1/compte/notifications/{id} \
  -H "Authorization: Bearer $PILLR_CLE" \
  -H "Content-Type: application/json" \
  -d '{}'

Réponse

  • notificationobjet
    Afficher les 10 champs
    • idtexte

      format uuid

    • typetexte

      price_drop, nego_opportunity, post_works_profit ou zone_trend.

    • annonce_idtexte ou null

      Identifiant Pillr de l'annonce concernée.

    • importancetexte

      basse, moyenne ou haute.

    • titretexte
    • messagetexte
    • chargeobjet

      Le détail du signal, tel que le scan l'a écrit.

    • cree_letexte ou null

      Horodatage ISO 8601.

    • lue_letexte ou null

      Horodatage ISO 8601.

    • ecartee_letexte ou null

      Horodatage ISO 8601.

  • creditsobjet

    Crédits débités par cet appel (réservés, pour une tâche en cours), et crédits encore utilisables ce mois avant la coupure : crédits offerts, crédits inclus du mois et crédits facturables sous le plafond de dépense (null si inconnus ou en bac à sable).

    Afficher les 2 champs
    • debitesentier

      0 au moins

    • restantsentier ou null

Erreurs possibles

Une ressource absente répond par un code de la famille des ressources absentes, propre à l'opération, sans débit.

    Flux d'évènements : référence de l'API | Pillr Data