Aller au contenu

Pillr Data

Le serveur MCP

Le serveur MCP de Pillr relie un assistant, comme Claude, ChatGPT ou Le Chat, ou un agent aux données de Pillr. Une seule adresse : sans clé, les outils gratuits ; avec une clé d'API, les outils de l'API en plus, au coût de l'appel REST jumeau.

L'adresse

Serveur MCP, transport HTTP
https://pillr.fr/api/mcp

En lecture seule. Une clé, quand vous en passez une, va dans l'en-tête Authorization, sous la forme Bearer suivi de la clé : pk_live_ pour la production, pk_test_ pour le bac à sable, sans débit. Elle se lit dans une variable d'environnement (PILLR_CLE dans les exemples) et ne s'écrit jamais en clair dans une commande.

Connecter votre client

Avec une clé, il faut un client qui sache envoyer un en-tête fixe. La connexion par compte Pillr, qui ouvrirait les outils de l'API aux autres, n'existe pas encore. Les intitulés des menus sont ceux des éditeurs à ce jour ; ils peuvent changer.

  • Claude CodeOutils gratuitsOutils de l'API avec une clé
  • Claude DesktopOutils gratuitsOutils de l'API avec une clé
  • claude.aiOutils gratuitsOutils de l'API : pas encore
  • ChatGPTOutils gratuitsOutils de l'API : pas encore
  • CursorOutils gratuitsOutils de l'API avec une clé
  • Le ChatOutils gratuitsOutils de l'API avec une clé
  • n8nOutils gratuitsOutils de l'API avec une clé

Claude Code

  1. Créez une clé dans le tableau de bord et gardez-la dans la variable PILLR_CLE.
  2. Ajoutez le serveur avec la commande ci-dessous ; sans clé, gardez seulement sa première ligne, sans la barre oblique finale.
  3. Dans Claude Code, la commande /mcp liste le serveur et ses outils.
Terminal
claude mcp add --transport http pillr https://pillr.fr/api/mcp \
  --header "Authorization: Bearer $PILLR_CLE"

Le shell remplace la variable avant d'exécuter la commande : Claude Code enregistre donc la clé, en clair, dans sa configuration sur votre machine. Gardez la portée par défaut ; la portée d'un projet (--scope project) l'écrirait dans le fichier .mcp.json du projet, souvent versionné.

Claude Desktop

  1. Sans clé : Réglages, puis Connecteurs, puis Ajouter un connecteur personnalisé, avec l'adresse du serveur, selon votre formule Claude.
  2. Avec une clé : ouvrez le fichier de configuration (Réglages, Développeur, Modifier la configuration) et ajoutez le serveur ci-dessous. Le pont mcp-remote passe l'en-tête ; il demande Node.js sur la machine.
  3. Redémarrez Claude Desktop : les outils de Pillr apparaissent dans la liste des outils.
claude_desktop_config.json
{
  "mcpServers": {
    "pillr": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://pillr.fr/api/mcp",
        "--header",
        "Authorization:${PILLR_AUTH}"
      ],
      "env": {
        "PILLR_AUTH": "Bearer pk_live_..."
      }
    }
  }
}

La clé est écrite dans ce fichier : gardez-le sur votre machine, hors de tout dépôt partagé.

claude.ai

  1. Réglages, puis Connecteurs, puis Ajouter un connecteur personnalisé, selon votre formule Claude.
  2. Donnez l'adresse du serveur, sans authentification : les outils gratuits sont aussitôt disponibles (le connecteur gratuit, pas à pas).

Un connecteur de claude.ai n'envoie pas d'en-tête fixe. La connexion par compte Pillr, qui y ouvrirait les outils de l'API sans en-tête, n'existe pas encore : avec ce client, seuls les outils gratuits répondent aujourd'hui.

ChatGPT

  1. L'application Pillr est publiée dans ChatGPT : ouvrez sa fiche et connectez-la, sans compte Pillr.
  2. Ou, en mode développeur, ajoutez un connecteur avec l'adresse du serveur, sans authentification.
L'application Pillr dans ChatGPT

Un connecteur de ChatGPT n'envoie pas d'en-tête fixe. La connexion par compte Pillr, qui y ouvrirait les outils de l'API sans en-tête, n'existe pas encore : avec ce client, seuls les outils gratuits répondent aujourd'hui.

Cursor

  1. Ajoutez le serveur à ~/.cursor/mcp.json (tous vos projets) ou à .cursor/mcp.json (un projet). Cursor lit la clé dans la variable PILLR_CLE de l'environnement où il est lancé.
  2. Sans clé, retirez le bloc headers.
  3. Le serveur et ses outils apparaissent dans les réglages MCP de Cursor ; rechargez-le après une modification.
mcp.json
{
  "mcpServers": {
    "pillr": {
      "url": "https://pillr.fr/api/mcp",
      "headers": {
        "Authorization": "Bearer ${env:PILLR_CLE}"
      }
    }
  }
}

Ne mettez jamais la clé en clair dans un .cursor/mcp.json versionné avec un projet.

Le Chat

  1. Dans Le Chat de Mistral AI, ouvrez les connecteurs, puis ajoutez un connecteur MCP personnalisé avec l'adresse du serveur (droits d'administrateur de l'espace requis).
  2. Sans clé : aucune authentification. Avec une clé : authentification par jeton d'API, en-tête Authorization, type Bearer, et la clé en valeur.

n8n

  1. Dans un agent IA, ajoutez l'outil MCP Client avec l'adresse du serveur en point d'accès, transport HTTP Streamable.
  2. Avec une clé : authentification Bearer, avec la clé pour jeton (ou un en-tête Authorization de valeur Bearer pk_...).
  3. L'agent voit les outils de Pillr ; chaque appel payant est débité comme l'appel REST jumeau.

Sans clé

3 outils gratuits, sans compte : 60 appels d'outil par heure et par adresse IP. Ils rendent des données communales et des règles générales, jamais une annonce.

  • Prix au m² d'une commune

    Le prix de référence au m² d'une commune, appartement et maison, avec sa provenance et son millésime.

    prix_m2_commune

  • Synthèse de marché d'une commune

    Un aperçu du marché d'une commune : prix, loyer médian et loyer par type de logement, rendement brut, évolutions sur 1 et 3 ans, tension locative, et le marché en vente du dernier mois.

    marche_commune

  • Formalité d'urbanisme d'un projet

    La formalité d'urbanisme d'un projet de travaux, son Cerfa, l'architecte, les pièces et le délai, chaque conclusion avec sa règle et sa source.

    demarche_urbanisme_projet

Le connecteur gratuit, pas à pas

Avec une clé d'API

Chaque outil payant est le jumeau d'une opération de l'API REST : même entrée, même JSON, même coût en crédits. Un appel réussi débite les crédits de l'organisation de la clé ; une clé pk_test_ ne sert que le jeu figé du bac à sable, sans débit. Avec une clé, les outils gratuits suivent le débit par minute de votre organisation, et ne débitent aucun crédit.

  • annonce

    Annonce par lien ou identifiant

    Fiche complète d'une annonce de vente analysée, retrouvée par son lien Leboncoin, BienIci ou SeLoger, ou par son identifiant : faits du bien et détails du portail (honoraires, taxe foncière, copropriété, équipements), vendeur professionnel nommé avec son enseigne, son SIREN et son mandat, photos et description, analyse complète (score et sous-scores, verdict, forces et faiblesses, leviers et cibles de négociation, loyer, rendements recalculés, budget, travaux par poste lus sur les photos, stratégie locative, régime fiscal), valeurs brutes du modèle à côté des valeurs recalculées, coût de sortie de passoire, échéance de location, historique des prix et diffusion en nombres. Données brutes du portail avec inclure=brut, pour un professionnel. Rien n'est débité si l'annonce est absente ou pas encore analysée.

    Coût
    3 crédits par appel réussi
    Accès
    À l'usage ou avec l'abonnement Data
    Domaine
    Annonces
    Paramètres et réponse
  • annonce_lot

    Annonce par lien ou identifiant, en lot

    Annonce par lien ou identifiant pour 100 éléments au plus en un appel : chaque élément est servi ou refusé seul, avec son code d'erreur, et seuls les éléments servis sont débités. Fiche complète d'une annonce de vente analysée, retrouvée par son lien Leboncoin, BienIci ou SeLoger, ou par son identifiant : faits du bien et détails du portail (honoraires, taxe foncière, copropriété, équipements), vendeur professionnel nommé avec son enseigne, son SIREN et son mandat, photos et description, analyse complète (score et sous-scores, verdict, forces et faiblesses, leviers et cibles de négociation, loyer, rendements recalculés, budget, travaux par poste lus sur les photos, stratégie locative, régime fiscal), valeurs brutes du modèle à côté des valeurs recalculées, coût de sortie de passoire, échéance de location, historique des prix et diffusion en nombres. Données brutes du portail avec inclure=brut, pour un professionnel. Rien n'est débité si l'annonce est absente ou pas encore analysée.

    Coût
    3 crédits par élément rendu
    Accès
    À l'usage ou avec l'abonnement Data
    Domaine
    Annonces
    Paramètres et réponse
  • rechercher_annonces

    Recherche d'annonces analysées

    Annonces de vente actives et analysées, par communes, codes postaux, départements ou autour d'un point, filtrées par type (appartement, maison, immeuble), prix, pièces, chambres, surface, prix au m², rendement brut ou net, score, DPE, passoires, état visuel, travaux, type de vendeur, SIREN ou enseigne de l'agence, mots-clés, date de parution, résidences gérées et règle « sous le marché ». Tri par rendement, score, état, date, prix, prix au m², distance ou opportunité (le radar du Hub : décote sur la commune, rendement, score, ancienneté). Chaque annonce porte son vendeur (professionnel nommé), sa diffusion multi-agences et ses drapeaux. Un crédit par annonce rendue.

    Coût
    1 crédit par élément rendu
    Accès
    À l'usage ou avec l'abonnement Data
    Domaine
    Annonces
    Paramètres et réponse
  • recherche_phrase

    Recherche d'annonces en langage naturel

    Une phrase libre (« T3 avec balcon sous 250 000 euros à Nantes ») traduite en filtres de rechercher_annonces, d'abord par le parseur de règles du site, sinon par un modèle de langage, puis exécutée comme rechercher_annonces : 12 annonces au plus, comprises dans le prix. La réponse dit les filtres retenus, ce qui a été ignoré et l'interprétation de la phrase. Les crédits sont rendus si la traduction échoue.

    Coût
    15 crédits par appel réussi
    Accès
    À l'usage ou avec l'abonnement Data
    Domaine
    Annonces
    Paramètres et réponse
  • annonces_similaires

    Biens semblables à une annonce

    Annonces actives et analysées proches d'une annonce de référence. Mode memes_criteres (défaut, outil du Hub) : même type, même commune, surface et prix à plus ou moins 20 %, classées par score. Mode proximite (fiche du site) : même code postal, surface et prix à plus ou moins 30 %, élargi à la commune (surface seule) quand il y a moins de quatre candidats, classées par une note qui mêle score, type, code postal, distance et écarts de prix et de surface. Une seule page. Un crédit par annonce rendue ; rien si la référence est absente.

    Coût
    1 crédit par élément rendu
    Accès
    À l'usage ou avec l'abonnement Data
    Domaine
    Annonces
    Paramètres et réponse
  • vie_annonce

    Vie d'une annonce : prix, diffusion, fatigue vendeur

    La vie d'une annonce en un appel : chaque variation de prix datée (doublons et corrections de prix mal lus signalés et écartés des calculs), baisse nette et cumulée, nombre de baisses et de hausses, plus forte baisse, prix en yo-yo, jours sur le marché et depuis la dernière baisse ; diffusion du même bien chez tous ses annonceurs, agences nommées avec leur SIREN quand il se rapproche, prix par agence, écart et agence la moins chère, première parution réelle ; parcours du bien étape par étape (annonceur, portails, début et fin, prix d'entrée et de sortie, mandat exclusif, republications) et date du passage en multi-mandat ; fatigue vendeur et republications. Un particulier n'est jamais nommé. Rien n'est débité si l'annonce est absente.

    Coût
    2 crédits par appel réussi
    Accès
    À l'usage ou avec l'abonnement Data
    Domaine
    Annonces
    Paramètres et réponse
  • bien

    Bien dédoublonné et toutes ses annonces

    Le bien unique derrière ses annonces, tous portails et toutes périodes confondus, par son identifiant ou par celui d'une de ses annonces : toutes les annonces rattachées, actives et retirées, avec leur vendeur (professionnel nommé) ; verdict et méthode du rattachement, servis tels quels, indécis compris ; clés d'identité et empreintes des photos ; agrégat (statut, agences, portails, republications, prix minimal, maximal et dernier) ; journal de certification des doublons. Rien n'est débité si le bien est inconnu.

    Coût
    3 crédits par appel réussi
    Accès
    À l'usage ou avec l'abonnement Data
    Domaine
    Annonces
    Paramètres et réponse
  • annonces_archives

    Pige complète : annonces actives et retirées du lac

    Toutes les annonces collectées par Pillr, actives et retirées, analysées ou non, avec les champs du portail et la vie de l'annonce (jours en ligne, baisses, republications, retrait) : par commune, code postal, département, point et rayon, ou SIREN d'agence, filtrées par type, prix, surface, dates de parution et de retrait, statut, portail, type de vendeur et baisse de prix. Le fonds pige et le fonds scraper_lbc servent les archives figées de l'ancienne pige et de l'ancien balayage Leboncoin, sans code INSEE, date de retrait ni statut actuel (un filtre qu'un fonds ne connaît pas est refusé sans débit).Un vendeur professionnel est servi en entier ; un particulier jamais par son nom ni ses coordonnées. Lecture lourde : servie depuis la mémoire seulement entre 20h30 et minuit. Un crédit par annonce rendue.

    Coût
    1 crédit par élément rendu
    Accès
    À l'usage ou avec l'abonnement Data
    Domaine
    Annonces
    Paramètres et réponse
  • annonces_carte

    Annonces dans une emprise de carte

    Les points des annonces actives et analysées dans une emprise de carte (sud, ouest, nord, est ; 3 degrés de côté au plus), filtrables par communes, départements, mots-clés, type, type de vendeur, DPE, travaux et règle « sous le marché » (rendement brut d'au moins 7 % et score d'au moins 70, comme la carte du site). Chaque point porte sa position et sa précision, son prix, sa surface, son score, son rendement et son identifiant. Les mieux notés d'abord, 1 000 points par page au plus.

    Coût
    1 crédit par tranche de 10 lignes rendues
    Accès
    À l'usage ou avec l'abonnement Data
    Domaine
    Annonces
    Paramètres et réponse
  • analyse_detaillee

    Lecture photo par photo et rapport complet

    Ce que le moteur d'analyse de Pillr a produit sur une annonce analysée, en deux volets. Volet photos : chaque photo lue (pièce, état sur 100, défauts, observations, travaux déduits, exploitable ou motif du rejet), travaux groupés par poste et chiffrés par le barème déterministe avec leurs photos sources, postes écartés et leur motif, défauts par gravité, pièces vues et manquantes, plancher énergétique, score de qualité de l'annonce. Volet rapport, celui de la page d'analyse : plan financier avec crédit, notation sur six axes, anomalies du moteur de règles, analyse rédigée (forces, points d'attention, verdict, confiance) et photo du marché communal. Avec des photos de catalogue, l'état visuel n'est pas servi et la lecture le dit. Rien n'est débité si l'annonce est absente ou pas encore analysée.

    Coût
    5 crédits par appel réussi
    Accès
    À l'usage ou avec l'abonnement Data
    Domaine
    Analyse des photos
    Paramètres et réponse
  • ecart_marche

    Écart au marché, anomalies et ventes du rayon

    Écart du prix au m² d'une annonce analysée au prix de référence Pillr de sa commune (le chiffre de la fiche, calculé par le même module canonique), avec le signal du modèle prédictif, les anomalies annonce contre marché du moteur de règles, les données de l'analyse (travaux, rendements, loyer, score, profil), les cibles et leviers de négociation, et toutes les ventes DVF du rayon une par une, reconstituées à la mutation entière, avec leurs agrégats par type et par année. Aucun seuil ne masque : chaque agrégat porte son nombre de ventes, chaque vente atypique son drapeau. Rien n'est débité si l'annonce est absente.

    Coût
    3 crédits par appel réussi
    Accès
    À l'usage ou avec l'abonnement Data
    Domaine
    Annonces
    Paramètres et réponse
  • negociation

    Recommandation de négociation et lettre d'offre

    Recommandation de négociation et lettre de proposition d'achat pour une annonce analysée : prix proposé (le vôtre, ou le prix demandé moins les travaux estimés et une marge de négociation, borné, comme sur la fiche), cibles et leviers relevés par l'analyse, vie de l'annonce (jours en ligne, baisses de prix), écart au prix de référence de la commune, puis arguments et lettre rédigés par l'IA à partir de ce seul contexte, au ton et au destinataire choisis. Un appel à un modèle Gemini par appel. Rien n'est débité si l'annonce est absente ou si l'IA ne rend rien d'exploitable.

    Coût
    20 crédits par appel réussi
    Accès
    À l'usage ou avec l'abonnement Data
    Domaine
    Annonces
    Paramètres et réponse
  • division

    Potentiel de division d'un bien

    Potentiel de division d'une annonce analysée, par la règle du Hub : la parcelle cadastrale du point de l'annonce (contenance, section, numéro, lue en direct à l'API Carto de l'IGN) croisée avec la surface habitable, le terrain déclaré, le prix au m² face au prix de référence de la commune et la demande locative. Rend un verdict (faible, modéré ou élevé) et ses signaux. Le point d'une annonce est souvent approché : la parcelle est celle du point servi, avec sa précision. Rien n'est débité si l'annonce est absente.

    Coût
    3 crédits par appel réussi
    Accès
    À l'usage ou avec l'abonnement Data
    Domaine
    Annonces
    Paramètres et réponse
  • adresse_annonce

    Adresse retrouvée d'une annonce

    Adresse retrouvée d'une annonce floutée, de trois façons, chacune avec sa qualité : l'adresse résolue par le croisement de sources indépendantes dans le disque de flou (ventes DVF, DPE, copropriétés, parcelles), avec sa confiance, sa méthode, la distance entre les sources et la clé BAN quand la Base Adresse Nationale la retrouve au numéro ; les adresses que désigne l'empreinte du DPE affiché (numéro de DPE, clé BAN, écart de surface), ambiguë quand elle en désigne plusieurs ; l'adresse validée par un utilisateur de Pillr. La résolution n'est pas relancée à l'appel : elle date du dernier passage du résolveur (resolue_le). Rien n'est débité si aucune des trois n'existe.

    Coût
    5 crédits par appel réussi
    Accès
    À l'usage ou avec l'abonnement Data
    Domaine
    Annonces
    Paramètres et réponse
  • localiser_annonce

    Localisation pas à pas (étapes déterministes)

    Étapes déterministes de la localisation d'une annonce floutée, une par appel (etape), celles de l'outil du Hub : disque (centre et rayon du flou du portail, adresse BAN du centre, précision honnête des coordonnées, immeuble annoncé, adresse validée) ; dpe (DPE du miroir ADEME dans le disque, à la même étiquette, à la surface près et du même type, repli sur l'API de l'ADEME) ; dvf (ventes DVF de 2018 à 2025 du même type à 3 % de surface près, adresse retrouvée par la BAN) ; copro (copropriétés du registre national au nombre de lots annoncé) ; parcelle (maisons : parcelles du cadastre IGN à la contenance du terrain annoncé) ; batiments (bâtiments BD TOPO du disque, compatibles d'abord avec l'étage annoncé) ; geocoder (saisie q géocodée par la Base Adresse Nationale, au code postal de l'annonce ou à code_postal, et contrôlée contre le flou). Les candidats sont croisés avec les disques des rediffusions du même bien sur d'autres portails. tolerance règle l'étape : surface en m² pour dpe (1 à 15), lots pour copro (1 à 8), contenance en % pour parcelle (1 à 30). Street View, Google Maps et l'image aérienne ne sont donnés qu'en lien. Rien n'est débité quand l'annonce ne permet pas l'étape (sans étiquette DPE, sans surface, sans position, hors copropriété, sans terrain).

    Coût
    5 crédits par appel réussi
    Accès
    À l'usage ou avec l'abonnement Data
    Domaine
    Annonces
    Paramètres et réponse
  • indices_photos

    Indices de localisation lus sur les photos

    Lecture par vision (Gemini) des 4 premières photos et de la description d'une annonce : noms de rue, enseignes, numéros de voirie, monuments, lieux cités, vue depuis les fenêtres, quartier et indice le plus fort. Seuls des indices lus sont rendus, jamais devinés : un indice se géocode ensuite par localiser_annonce (etape geocoder) ou lieu_par_indice. Les photos sont lues sur les serveurs des portails ; la description d'un particulier est passée au modèle sans ses coordonnées.

    Coût
    20 crédits par appel réussi
    Accès
    À l'usage ou avec l'abonnement Data
    Domaine
    Annonces
    Paramètres et réponse
  • lieu_par_indice

    Lieu réel d'un indice par Google Maps

    Résout un indice de localisation (enseigne, repère, ligne de tram) en lieu réel par Gemini avec l'outil Google Maps, biaisé sur le centre du flou de l'annonce (sinon sur lat et lon, sinon sur sa position affichée) pour écarter les homonymes lointains : la réponse du modèle et 5 lieux Google Maps au plus. Le lieu trouvé se contrôle ensuite par localiser_annonce (etape geocoder), qui dit s'il tombe dans le disque. Résultat soumis aux conditions de Google Maps Platform : jamais gardé en mémoire par Pillr, la source est citée.

    Coût
    40 crédits par appel réussi
    Accès
    À l'usage ou avec l'abonnement Data
    Domaine
    Annonces
    Paramètres et réponse
  • street_view

    Comparaison de façade avec Street View

    Compare par vision (Gemini) la façade des 4 premières photos de l'annonce aux images Google Street View de 1 à 3 adresses candidates, en une seule passe : verdict (oui, non, incertain), confiance, raison et classement des candidats. Un candidat sans couverture Street View n'est pas comparé ni payé. Les images Street View ne sont jamais servies ni gardées : seul un lien l'est. Rien n'est débité sans photo d'annonce, sans couverture ou si le service est coupé.

    Coût
    40 crédits par appel réussi
    Accès
    À l'usage ou avec l'abonnement Data
    Domaine
    Annonces
    Paramètres et réponse
  • valider_adresse

    Enregistrer l'adresse validée d'une annonce

    Enregistre l'adresse que l'utilisateur de la clé a confirmée pour une annonce, dans le cache partagé des localisations de Pillr : une adresse par annonce, la dernière validation remplace la précédente. Elle est ensuite rendue par adresse_annonce et par localiser_annonce (etape disque), et le Hub la lit aussi. Exige une clé rattachée à un compte Pillr.

    Coût
    0 crédit par appel réussi
    Accès
    À l'usage ou avec l'abonnement Data
    Domaine
    Compte et personnalisation
    Paramètres et réponse
  • resoudre_adresse

    Résoudre une adresse ou un point

    Géocodage par la Base Adresse Nationale d'une adresse en texte (avec son code postal pour départager) ou d'un point (géocodage inverse, du plus proche au plus lointain). Chaque candidat porte sa clé BAN, son numéro, sa voie, sa commune et son ancienne commune, sa position, son score ou sa distance, et pour un numéro le type de position, les parcelles cadastrales et la certification lus dans la copie de la BAN de Pillr. La clé BAN d'un numéro sert aux autres opérations du domaine.

    Coût
    0 crédit par appel réussi
    Accès
    À l'usage ou avec l'abonnement Data
    Domaine
    Adresse et DPE
    Paramètres et réponse
  • faits_adresse

    Faits complets d'une adresse

    La ligne complète d'une adresse BAN dans la table d'adresses de Pillr, en groupes : identité (parcelles, îlot, position), bâtiment, DPE détaillé (chauffage, isolation, ventilation, méthode, numéro, historique daté), audit, ventes DVF au numéro avec leur historique, îlot (ventes sur 5 ans, médiane au m² et son nombre de ventes, annonces actives, copropriétés), copropriété, autorisations d'urbanisme avec leur historique, sociétés civiles nommées avec leur SIREN, mise en vente (annonce rattachée, confiance et méthode), contexte de la commune et variables du pré-marché. Le paramètre champs choisit des groupes ou des colonnes. Un seul DPE par adresse : le plus récent.

    Coût
    5 crédits par appel réussi
    Accès
    À l'usage ou avec l'abonnement Data
    Domaine
    Adresse et DPE
    Paramètres et réponse
  • histoire_adresse

    Histoire datée d'une adresse

    La frise datée et sourcée d'une adresse, par sa clé BAN, l'adresse en texte ou un point : construction déclarée, DPE depuis 2013 et audits énergétiques, autorisations d'urbanisme depuis 2013 (demandeur personne morale nommé), ventes DVF depuis 2018 au numéro, à la parcelle ou par position, copropriété (syndic professionnel nommé), sociétés civiles domiciliées nommées avec leur SIREN, annonces passées et baisses de prix avec l'agence nommée, catastrophes naturelles de la commune depuis 1982 (Géorisques). Chaque évènement dit son rattachement (adresse, parcelle, immeuble, position ou commune) et chaque source son état. Le même moteur que l'outil Historimmo du Hub ; le nombre d'évènements est plafonné, la construction et la première vente toujours gardées.

    Coût
    10 crédits par appel réussi
    Accès
    À l'usage ou avec l'abonnement Data
    Domaine
    Adresse et DPE
    Paramètres et réponse
  • annonces_adresse

    Annonces vues à une adresse

    Toutes les annonces de vente rattachées à une adresse BAN, actives et passées : l'annonce concordante (dé-floutée par croisement), l'annonce reconnue par l'empreinte de l'adresse, les annonces reconnues par l'empreinte d'un DPE de l'adresse et celles dont l'adresse résolue tombe à moins de 25 m. Pour chacune : portail, prix, surface, type de vendeur, agence nommée avec son SIREN pour un professionnel, dates de parution et de retrait, baisses de prix, méthode et confiance du rattachement. La réponse dit aussi si l'adresse est en vente et depuis quand. Rien n'est débité quand aucune annonce n'est rattachée à l'adresse.

    Coût
    3 crédits par appel réussi
    Accès
    À l'usage ou avec l'abonnement Data
    Domaine
    Adresse et DPE
    Paramètres et réponse
  • parcelle

    Parcelle cadastrale et ce qui s'y rattache

    Une parcelle cadastrale, par son identifiant à 14 caractères ou par la clé BAN d'une adresse : contenance, section, numéro et géométrie (API Carto de l'IGN, en direct), adresses BAN rattachées, ventes DVF de la parcelle, autorisations d'urbanisme Sitadel qui la citent (demandeur personne morale nommé), copropriétés qui la citent et zone du document d'urbanisme à son point intérieur. Par une clé BAN, la parcelle servie est la première de l'adresse, ou celle qui contient le numéro, et la réponse liste les autres.

    Coût
    3 crédits par appel réussi
    Accès
    À l'usage ou avec l'abonnement Data
    Domaine
    Adresse et DPE
    Paramètres et réponse
  • batiments

    Bâtiments autour d'un point ou sur une parcelle

    Les bâtiments de la BD TOPO de l'IGN (service WFS de la Géoplateforme, en direct) autour d'un point, dans un rayon de 200 m au plus (50 m par défaut), ou sur une parcelle cadastrale : niveaux (estimés sur la hauteur quand la BD TOPO ne les donne pas, et la réponse le dit), hauteur, usage, nature, nombre de logements, emprise au sol et adresse BAN la plus proche. Avec un étage, chaque bâtiment dit s'il compte assez de niveaux.

    Coût
    2 crédits par appel réussi
    Accès
    À l'usage ou avec l'abonnement Data
    Domaine
    Adresse et DPE
    Paramètres et réponse
  • coproprietes

    Copropriétés du Registre national

    Les copropriétés immatriculées au Registre national des copropriétés, par numéro d'immatriculation, par la clé BAN d'une adresse (immatriculation portée par le DPE, sinon parcelle commune, sinon position à 30 m au plus), ou par filtres (commune, code postal, ou point et rayon, puis nombre de lots, type de syndic, copropriété aidée) : adresse et nom d'usage, lots (total, habitation, stationnement), période de construction, syndic professionnel nommé (raison sociale, SIRET, APE), mandat en cours et fin du dernier mandat, parcelles, dispositifs publics et aide. Le représentant d'un syndic bénévole n'est jamais servi. L'agrégat de la commune accompagne la liste.

    Coût
    1 crédit par élément rendu
    Accès
    À l'usage ou avec l'abonnement Data
    Domaine
    Adresse et DPE
    Paramètres et réponse
  • ventes_adresse

    DVF à l'adresse : toutes les mutations

    Toutes les mutations DVF enregistrées à une adresse de la Base Adresse Nationale (par sa clé), ou à une parcelle cadastrale, regroupées par mutation. Les ventes de 2021 et suivantes sont lues au numéro (code de voie et numéro DVF), sinon aux parcelles de l'adresse ; celles de 2018 à 2020, dont le fichier n'a ni adresse ni parcelle, sont rapprochées par position autour du numéro. Pour chaque mutation : date, nature, valeur foncière, adresse DVF, locaux (type, surface bâtie, pièces, lots et surfaces Carrez), terrains, parcelles, volumes, position. Le prix au m² est recalculé à la mutation sur la surface de ses logements, avec sa qualité : vente en bloc, dépendance, local professionnel, prix atypique et son motif, rattachement incertain. Aucune vente : 404 ressource_absente, rien n'est débité. L'Alsace-Moselle (livre foncier) n'est pas dans DVF.

    Coût
    5 crédits par appel réussi
    Accès
    À l'usage ou avec l'abonnement Data
    Domaine
    Adresse et DPE
    Paramètres et réponse
  • ventes

    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
    Accès
    À l'usage ou avec l'abonnement Data
    Domaine
    Adresse et DPE
    Paramètres et réponse
  • ventes_rue

    Ventes d'une rue ou d'une commune

    Les ventes DVF d'une rue (par son nom géocodé dans la Base Adresse Nationale, ou par son code de voie) ou d'une commune (l'arrondissement à Paris, Lyon et Marseille), lues à la vente entière : une vente d'un seul logement, hors local professionnel et vente en bloc, comme le barème Pillr. Par type de bien, sur la période entière puis année par année : nombre de ventes, médiane, quartiles dès 2 ventes, minimum, maximum, surface médiane, dernière vente, sans seuil de publication. Les ventes au prix atypique sont écartées des agrégats et comptées. À la voie, chaque vente est listée avec son numéro et sa qualité. Le prix de référence de la commune est le barème Pillr, le même que les pages communes. Mêmes calculs que l'outil ventes_rue du Hub.

    Coût
    5 crédits par appel réussi
    Accès
    À l'usage ou avec l'abonnement Data
    Domaine
    Adresse et DPE
    Paramètres et réponse
  • ventes_commune

    Volumes et prix des ventes d'une commune

    Les volumes et les prix des ventes DVF d'une commune, par son code INSEE ou par un code postal (la commune la plus peuplée du code postal) : ventes par trimestre (total, appartements, maisons) et médiane au m² ; série annuelle du prix au m² (appartement, maison, ensemble) avec transactions, minimum, maximum et drapeaux de basse confiance ; vélocité au code postal, année par année, évolution du volume et sa lecture, comme l'outil de vélocité du Hub. La vélocité compte des lignes DVF d'appartements et de maisons (une par lot), pas des mutations. Chaque valeur porte son nombre d'observations.

    Coût
    2 crédits par appel réussi
    Accès
    À l'usage ou avec l'abonnement Data
    Domaine
    Marché des communes
    Paramètres et réponse
  • dpe_adresse

    Tous les DPE d'une adresse, logement par logement

    Tous les DPE d'une adresse de la Base Adresse Nationale, logement par logement : numéro, dates, étiquettes énergie et GES, consommation et émissions, surface, type, étage et complément d'adresse, méthode, fin de validité, DPE remplacé, échéance d'interdiction de louer. Sources : DPE de logements existants et neufs et DPE tertiaires portant la clé BAN, DPE d'avant juillet 2021 rapprochés par position (30 m au plus). S'y ajoutent l'historique des étiquettes de l'adresse, ses audits énergétiques (classe visée, coût maximal) et la répartition des DPE de sa commune. Aucun DPE, aucun audit ni aucun historique : 404 ressource_absente, rien n'est débité.

    Coût
    3 crédits par appel réussi
    Accès
    À l'usage ou avec l'abonnement Data
    Domaine
    Adresse et DPE
    Paramètres et réponse
  • dpe

    Un DPE par son numéro, ou les DPE d'un disque ou d'une commune

    Un DPE par son numéro (logement existant ou neuf, tertiaire, ou d'avant juillet 2021) avec toutes ses colonnes ADEME : étiquettes, consommations et émissions par usage et par énergie, coûts, déperditions, isolation, chauffage, eau chaude, ventilation, copropriété, identifiant RNB. Ou les DPE de logements existants autour d'un point (2000 m au plus, le plus proche d'abord) ou dans une commune (le plus récent d'abord), filtrés par étiquette, GES, surface, type de bâtiment et date : le DPE inversé. Les annonces dont l'empreinte concorde avec le DPE sont jointes. Le paramètre champs réduit chaque DPE aux champs demandés.

    Coût
    1 crédit par élément rendu
    Accès
    À l'usage ou avec l'abonnement Data
    Domaine
    Adresse et DPE
    Paramètres et réponse
  • audits_energetiques

    Audits énergétiques et leurs scénarios

    Les audits énergétiques réglementaires de l'ADEME, par numéro d'audit ou à une adresse de la Base Adresse Nationale, avec tous leurs scénarios et leurs étapes de travaux : classe atteinte, consommation, coût de l'étape et coût cumulé, gains de facture et de consommation, travaux décrits par l'auditeur. Ce sont des estimations d'auditeur, pas des devis. Aucun audit : 404 ressource_absente, rien n'est débité.

    Coût
    3 crédits par élément rendu
    Accès
    À l'usage ou avec l'abonnement Data
    Domaine
    Adresse et DPE
    Paramètres et réponse
  • sortie_passoire

    Échéance de location et coût de sortie de passoire

    L'échéance d'interdiction de louer d'un logement selon son étiquette (calendrier de la loi Climat et résilience en métropole : G 2025, F 2028, E 2034) et les mois restants. Pour une étiquette E, F ou G, le coût pour atteindre D, C ou B, mesuré sur les audits énergétiques ADEME de logements comparables (type, zone climatique, période de construction) : médiane et quartiles, euros par m², coût à la surface du bien, part des audits qui dépassent la cible, finesse de la cellule retenue. Une estimation d'auditeur, pas un devis. Métropole seulement : le calendrier des outre-mer n'est pas servi.

    Coût
    1 crédit par appel réussi
    Accès
    À l'usage ou avec l'abonnement Data
    Domaine
    Adresse et DPE
    Paramètres et réponse
  • pre_marche_adresse

    Pré-marché d'une adresse

    Pour une adresse (clé BAN), la probabilité calibrée qu'une vente DVF y soit enregistrée dans les 12 mois, calculée à la lecture comme dans le Hub : indice des coefficients mesurés, bande de calibration et son taux de vente réel, lift, fenêtre de mandat et priorité, fiabilité (mesure sur les maisons positionnées, indicatif ailleurs), raisons chiffrées, coefficients retenus, faits datés au jour du DPE, frise des évènements de l'adresse (DPE, audit, ventes, sociétés civiles, permis, copropriété, annonce) et sociétés civiles domiciliées, nommées avec leur SIREN quand le BODACC le rattache. Hors du périmètre calibré (Alsace-Moselle notamment), la raison est servie à la place du calcul.

    Coût
    10 crédits par appel réussi
    Accès
    À l'usage ou avec l'abonnement Data
    Domaine
    Pré-marché
    Paramètres et réponse
  • pre_marche_zone

    Adresses à prospecter d'un secteur

    Les adresses d'un secteur (une commune, une liste de communes, une intercommunalité, un code postal ou un cercle) dont le DPE a moins de 24 mois, classées par priorité de prospection : la probabilité calibrée de vente DVF à 12 mois multipliée par la fenêtre de mandat. La réponse comprend le comptage du secteur, la précision mesurée, puis pour chaque adresse ses raisons, sa frise, l'annonce et l'agence quand elle est déjà en vente, ses sociétés civiles nommées, sa dernière vente, sa copropriété et son nombre de logements, et le total des logements pour un boîtage. Les adresses déjà en vente ou vendues depuis le DPE sont exclues, sauf demande.

    Coût
    10 crédits par élément rendu
    Accès
    À l'usage ou avec l'abonnement Data
    Domaine
    Pré-marché
    Paramètres et réponse
  • secteur

    Mon secteur en 30 secondes

    Pour un code postal, les deux signaux de la page « Mon secteur » de pillr.fr : les adresses en pré-marché pur (DPE individuel de moins de 90 jours, ni en vente ni vendues depuis, dont les passoires F et G), et les particuliers qui vendent seuls depuis plus de 50 jours et sont encore en ligne, dont ceux qui ont baissé leur prix ; avec detail=true, la liste de leurs annonces, sans le nom ni les coordonnées du vendeur. Sans annonce de particulier dans le code postal, le compte passe au département et le dit.

    Coût
    2 crédits par appel réussi
    Accès
    À l'usage ou avec l'abonnement Data
    Domaine
    Marché des communes
    Paramètres et réponse
  • estimer_bien_affine

    Estimation affinée par IA

    La même estimation qu'estimer_bien (même moteur, même sortie), affinée par un modèle de langage à partir de l'état, des qualités, de la description, de l'exposition, des annexes, des équipements et de photos lues sur des liens https publics (JPEG, PNG ou WebP). Rend en plus la liste unique des ajustements, chacun avec sa nature, son pourcentage, son motif et sa source (barème ou IA, chaque ligne IA vérifiée par le serveur), l'état de l'affinage et la lecture des photos. Les photos sont lues le temps de l'appel, jamais écrites ni renvoyées. Une panne de l'IA rend l'estimation déterministe, et le dit.

    Coût
    30 crédits par appel réussi
    Accès
    À l'usage ou avec l'abonnement Data
    Domaine
    Estimation
    Paramètres et réponse
  • terrain_reference

    Terrain de référence d'une maison

    La surface de terrain médiane d'une maison vendue dans le département, pour le type de commune (groupe déduit du zonage ABC et de la population), telle que le moteur d'estimation la retient : c'est le terrain que le prix du secteur porte déjà. Le niveau dit si la cellule département et groupe est mesurée ou si la médiane nationale du groupe sert de repli. Par commune (code INSEE), ou par département avec le groupe.

    Coût
    1 crédit par appel réussi
    Accès
    À l'usage ou avec l'abonnement Data
    Domaine
    Estimation
    Paramètres et réponse
  • marche_zone

    Marché d'une commune

    Marché immobilier d'une commune ou d'un arrondissement, par code INSEE : prix de référence au m² des appartements et des maisons avec leur provenance (mesuré sur les ventes DVF ou estimé) et le nombre de ventes, loyer d'annonce au m² et loyers par type de logement (Carte des loyers), rendement brut théorique, évolution des prix sur 1 et 3 ans, zone ABC, et le marché en vente du dernier mois calculé (annonces en ligne, nouvelles annonces, prix affiché médian, part des baisses, délai médian en ligne). Mêmes chiffres que les pages communes de pillr.fr. Paris, Lyon et Marseille sont servies en agrégat de leurs arrondissements.

    Coût
    1 crédit par appel réussi
    Accès
    À l'usage ou avec l'abonnement Data
    Domaine
    Marché des communes
    Paramètres et réponse
  • synthese_zone

    Synthèse complète d'une commune

    Une commune en un appel, avec les chiffres de l'outil de zone du Hub : marché (prix et provenance, rendements, demande, vacance, loyer, évolutions, passoires, transactions), démographie, moyennes des annonces analysées par Pillr dans la commune, score Pillr et ses huit sous-scores, marchabilité et équipements à 500 m, loyer prédit avec son intervalle à 95 %, loyers par typologie et loyer d'un logement donné (typologie, surface), mesures de zone (équipements, gare et aéroport, délinquance, risques), signal de prix, QPV et zone ABC, ratios d'accessibilité, courte durée, points forts et signaux d'alerte de l'analyse rédigée, marché en vente du dernier mois. Paris, Lyon et Marseille se lisent par arrondissement.

    Coût
    3 crédits par appel réussi
    Accès
    À l'usage ou avec l'abonnement Data
    Domaine
    Marché des communes
    Paramètres et réponse
  • scores_commune

    Score Pillr et scores d'une commune

    Scores d'une commune tels que le pipeline de Pillr les publie : score Pillr sur 100 et ses huit sous-scores (rentabilité, demande, liquidité, croissance, stabilité, qualité, services, sécurité), scores d'attractivité, de location longue et courte durée, de tourisme et de démographie, z-scores et percentiles des prix, du rendement et des loyers, volatilité, prix attendu par le modèle départemental et écart au prix observé, ratios d'accessibilité. Un sous-score de rentabilité posé par défaut faute de rendement mesuré est signalé. Paris, Lyon et Marseille se lisent par arrondissement.

    Coût
    2 crédits par appel réussi
    Accès
    À l'usage ou avec l'abonnement Data
    Domaine
    Marché des communes
    Paramètres et réponse
  • profil_commune

    Profil socio-démographique et politique

    Profil d'une commune, chaque bloc lu dans sa source publique et servi avec sa qualité : population et codes postaux (recensement), âge moyen, chômage et part de HLM, revenus par unité de consommation, déciles 1 et 9, pauvreté et indice de Gini (Filosofi), quartiers prioritaires (nombre et codes), indice de position sociale des lycées, premier tour de la présidentielle 2022 (orientation, candidat en tête, parts par bloc, abstention). Un bloc absent de sa source est servi vide, avec n = 0.

    Coût
    2 crédits par appel réussi
    Accès
    À l'usage ou avec l'abonnement Data
    Domaine
    Marché des communes
    Paramètres et réponse
  • parc_commune

    Parc de logements d'une commune

    Parc de logements d'une commune, chaque bloc depuis sa source : résidences principales, secondaires et vacantes, propriétaires et locataires (recensement) ; vacance du parc privé par année, dont plus de deux ans (LOVAC) ; diagnostics de performance énergétique par étiquette, part de passoires et série mensuelle des DPE et des audits (ADEME) ; copropriétés, lots, sans mandat, aidées, en plan de sauvegarde, gérées par un syndic bénévole, en nombre (RNC) ; autorisations et logements créés par mois, permis sur 12 et 24 mois (Sitadel). Les séries partent du mois demandé.

    Coût
    2 crédits par appel réussi
    Accès
    À l'usage ou avec l'abonnement Data
    Domaine
    Marché des communes
    Paramètres et réponse
  • prix_commune

    Prix au m² d'une commune : barème, série, évolutions

    Prix de référence au m² d'une commune par type de bien, avec toute sa qualité : provenance (mesuré ou estimé), ventes et ventes récentes, communes voisines et ventes du bassin, poids local, dominance, demi-bande d'incertitude, prix local brut. Rien n'est masqué : un prix sur peu de ventes est servi avec son nombre et son drapeau. S'y ajoutent la série annuelle (prix, transactions, minimum, maximum, basse confiance), les évolutions sur 1, 3 et 5 ans avec leur confiance et celle du département, l'indice annuel du département et la ligne indexée (barème multiplié par l'indice). Paris, Lyon et Marseille se lisent par arrondissement.

    Coût
    2 crédits par appel réussi
    Accès
    À l'usage ou avec l'abonnement Data
    Domaine
    Marché des communes
    Paramètres et réponse
  • prix_iris

    Prix au m² par quartier IRIS

    Prix au m² des appartements et des maisons par quartier IRIS, avec le nombre de ventes, la provenance (mesuré au quartier ou estimé depuis le prix de la commune), le poids local, la demi-bande d'incertitude, le nom du quartier et, sur demande, son contour GeoJSON. Un quartier par son code IRIS, ou tous les quartiers d'une commune. Tous les quartiers sont servis, ceux à peu de ventes avec leur drapeau.

    Coût
    1 crédit par élément rendu
    Accès
    À l'usage ou avec l'abonnement Data
    Domaine
    Marché des communes
    Paramètres et réponse
  • prix_territoire

    Prix d'un département ou d'une région

    Prix médians au m² des appartements et des maisons d'un département ou d'une région, ceux de la carte des prix de Pillr, avec la surface médiane, la population et le nombre de communes, l'emprise, l'indice annuel par type et les coefficients semestriels du barème. Une région se donne par son code INSEE ou son nom court.

    Coût
    1 crédit par appel réussi
    Accès
    À l'usage ou avec l'abonnement Data
    Domaine
    Marché des communes
    Paramètres et réponse
  • vie_annonces_zone

    Vie des annonces d'une zone

    Vie des annonces d'une commune ou d'un code postal, mois par mois : entrées (particuliers, professionnels, exclusifs, maisons, appartements), part nationale, sorties rapides et longues, stock, durée médiane en ligne, prix affiché médian au m², baisses et baisse moyenne, chaque mois marqué comparable ou non selon la stabilisation de la collecte. Pour une zone de plusieurs communes, les comptes s'additionnent et les médianes restent vides. S'y ajoutent la durée en ligne par code postal et type de bien (médiane et quartiles, avec l'effectif) et, sur demande, les évènements des derniers jours : baisses de prix et annonces diffusées par plusieurs agences, par identifiant d'annonce.

    Coût
    5 crédits par appel réussi
    Accès
    À l'usage ou avec l'abonnement Data
    Domaine
    Marché des communes
    Paramètres et réponse
  • signaux_commune

    Tableau mensuel des signaux d'une commune

    Tableau mensuel consolidé d'une commune, tel que le lac de Pillr le calcule : DPE (existants, passoires, maisons, appartements, neufs, tertiaires) et audits, sociétés civiles (créations, modifications, radiations), permis et logements autorisés, flux d'annonces (entrées, sorties, stock, durée, prix affiché, baisses), agences actives, part du leader et concentration, vacance du parc privé, copropriétés, ventes DVF du trimestre. Les avis BODACC des codes postaux de la commune sont comptés par famille. La date de calcul est servie, et un tableau ancien le dit.

    Coût
    3 crédits par appel réussi
    Accès
    À l'usage ou avec l'abonnement Data
    Domaine
    Marché des communes
    Paramètres et réponse
  • radar_prospection

    Radar de prospection d'une commune ou d'un département

    Radar de prospection mensuel d'une commune, ou de toutes les communes d'un département classées par score : score sur 100, rang dans le département, cinq blocs (vendeurs sans agence, mandats qui patinent, absence d'agence dominante, parc immobile, signaux amont) et leur détail (pression des DPE, vente directe, mandats essoufflés, stock, agences présentes, part du leader et concentration, exclusifs, prix au m² médian, durée médiane, baisses). Le dernier mois calculé, ou le mois demandé. Des agrégats communaux, sans adresse ni nom. Liste paginée.

    Coût
    3 crédits par élément rendu
    Accès
    À l'usage ou avec l'abonnement Data
    Domaine
    Pré-marché
    Paramètres et réponse
  • plan_prospection

    Plan de prospection rédigé

    Plan de prospection d'une commune, rédigé par un modèle de langage à partir des faits du radar du mois (score, blocs, flux d'annonces, vente directe, agences, vacance, copropriétés, ventes), rendus avec le plan : trois à cinq phrases, aucun chiffre absent des faits (une réponse qui en invente est rejetée), aucune adresse ni aucun nom, jamais de démarchage téléphonique d'un particulier. Sans plan fiable, rien n'est débité.

    Coût
    20 crédits par appel réussi
    Accès
    À l'usage ou avec l'abonnement Data
    Domaine
    Pré-marché
    Paramètres et réponse
  • classement_communes

    Classement de communes (screener)

    Communes classées par rendement brut théorique (loyer multiplié par douze, divisé par le prix au m², pour les appartements ou les maisons), par score Pillr ou par distance, avec la logique de l'outil de screening du Hub. Filtres : budget et surface type, prix au m² maximal, rendement minimal, population, sécurité, vacance, évolution à 3 ans, exclusion des QPV, type de bien, distance réelle autour d'une commune (entre centres habités), et les stratégies cashflow, patrimonial, pinel et deal de la page des opportunités. Chaque commune porte la provenance et le nombre de ventes de son prix. Liste paginée.

    Coût
    1 crédit par élément rendu
    Accès
    À l'usage ou avec l'abonnement Data
    Domaine
    Marché des communes
    Paramètres et réponse
  • analyse_ia_zone

    Analyse rédigée d'une commune

    Analyse rédigée de la commune, déjà générée et stockée par Pillr : note de synthèse sur 100 et sous-notes, points forts, signaux d'alerte avec leur atténuation, recommandations. Servie comme sur les pages communes : les affirmations que le modèle ne pouvait pas sourcer (transport, délinquance, risques, équipements) sont remplacées par les mesures du jour, rendues à côté, et les textes sont réécrits pour la lecture. Aucun modèle n'est appelé. Paris, Lyon et Marseille se lisent par arrondissement.

    Coût
    2 crédits par appel réussi
    Accès
    À l'usage ou avec l'abonnement Data
    Domaine
    Marché des communes
    Paramètres et réponse
  • gentrification

    Signaux de valorisation d'une commune

    Signaux de valorisation d'une commune, comme l'outil du Hub : évolutions des prix sur 1, 3 et 5 ans, salaire médian, demande, commerces signaux (coworking, bien-être, bio, créatif) comptés en direct dans la base Sirene et rapportés à 100 000 habitants, et un verdict par une règle dont les seuils sont rendus. Signal indicatif à la maille de la commune. Si l'API publique ne répond pas, rien n'est servi ni débité. Paris, Lyon et Marseille se lisent par arrondissement.

    Coût
    3 crédits par appel réussi
    Accès
    À l'usage ou avec l'abonnement Data
    Domaine
    Marché des communes
    Paramètres et réponse
  • geographie

    Contours, centre et voisins d'un territoire

    Contour GeoJSON d'une commune, d'un arrondissement, d'un quartier IRIS, d'un département ou d'une région, simplifiable à une tolérance en mètres, avec son emprise. Pour une commune : son centre habité (celui des distances du Hub), ses communes voisines et son intercommunalité. Pour un quartier IRIS : sa commune et son intercommunalité.

    Coût
    1 crédit par appel réussi
    Accès
    À l'usage ou avec l'abonnement Data
    Domaine
    Marché des communes
    Paramètres et réponse
  • tuiles_prix

    Tuiles vectorielles de la carte des prix

    Une tuile vectorielle (Mapbox Vector Tile) de la carte des prix de Pillr, prête à poser dans MapLibre : régions jusqu'au zoom 6, départements jusqu'au 8, communes ensuite, avec les prix au m² des appartements et des maisons. En REST, la tuile part en octets ; en MCP, ses métadonnées et la tuile en ressource. Une tuile hors de la pyramide générée est refusée sans débit.

    Coût
    1 crédit par appel réussi
    Accès
    À l'usage ou avec l'abonnement Data
    Domaine
    Marché des communes
    Paramètres et réponse
  • referentiels

    Référentiels de communes et de codes postaux

    Correspondances entre nom de commune, code INSEE, code postal, libellé d'acheminement et intercommunalité, lues dans le Code officiel géographique, la base officielle des codes postaux et le référentiel des intercommunalités : recherche d'une commune par son nom (q), communes d'un code postal (cp) ou d'une intercommunalité (siren). Chaque commune porte ses codes postaux, son intercommunalité, ses communes déléguées ou associées et ses mouvements au COG.

    Coût
    0 crédit par appel réussi
    Accès
    À l'usage ou avec l'abonnement Data
    Domaine
    Marché des communes
    Paramètres et réponse
  • verdict_commune

    Verdict d'investissement d'une commune

    Verdict factuel sur une commune, calculé sans IA par la règle des pages communes : niveau (acheter, surveiller ou cher), libellé, ton et raisons chiffrées, à partir de l'écart au prix attendu du département, du rendement brut et de la tendance des prix, pondérés selon l'optique (achat ou rendement). Les entrées utilisées sont rendues. Quand les données manquent, le verdict le dit. Paris, Lyon et Marseille sont jugées sur l'agrégat de leurs arrondissements.

    Coût
    1 crédit par appel réussi
    Accès
    À l'usage ou avec l'abonnement Data
    Domaine
    Marché des communes
    Paramètres et réponse
  • comparer_communes

    Comparaison de communes

    De deux à quatre communes côte à côte, avec les chiffres des pages communes : prix au m² des appartements et des maisons avec leur provenance et leur nombre de ventes, loyer, rendements, évolutions sur 1 et 3 ans, zone ABC, population, score Pillr, part de passoires et verdict d'investissement sans IA. Pour chaque indicateur, la commune la mieux placée est désignée. Paris, Lyon et Marseille sont comparées sur l'agrégat de leurs arrondissements.

    Coût
    1 crédit par élément rendu
    Accès
    À l'usage ou avec l'abonnement Data
    Domaine
    Marché des communes
    Paramètres et réponse
  • palmares_communes

    Palmarès de communes par indicateur

    Communes classées sur un indicateur publié par Pillr, avec les filtres et les tris des pages de classement du site : rendement locatif, cashflow positif, zones A et A bis, prix bas, prix élevés, peu de passoires, score Pillr, communes sous le prix attendu de leur département, meilleur rendement, ou les deux à la fois. En France, dans un département ou dans une région. Chaque ligne porte son rang, sa valeur, sa population et ses ventes ; les seuils de fiabilité appliqués sont rendus en clair. Liste paginée.

    Coût
    1 crédit par élément rendu
    Accès
    À l'usage ou avec l'abonnement Data
    Domaine
    Marché des communes
    Paramètres et réponse
  • avis_zone

    Avis des investisseurs sur une commune

    Avis déposés par les utilisateurs de Pillr sur une commune, triés par utilité puis par date (ou par date) : note globale et quatre notes (rentabilité, qualité de vie, demande locative, valorisation), titre, texte, profil déclaré de l'auteur et mention de vérification, avec les moyennes de la commune. L'identité de l'auteur n'est jamais servie, ni les coordonnées citées dans un texte. Liste paginée.

    Coût
    1 crédit par appel réussi
    Accès
    À l'usage ou avec l'abonnement Data
    Domaine
    Marché des communes
    Paramètres et réponse
  • avis_zone_publier

    Publier un avis sur une commune

    Publie l'avis de l'utilisateur de la clé sur une commune, avec les règles du site : note globale de 1 à 5, quatre notes facultatives, titre, texte et profil. Un seul avis par compte et par commune ; un second est refusé. L'avis est servi ensuite sans l'identité de son auteur.

    Coût
    0 crédit par appel réussi
    Accès
    À l'usage ou avec l'abonnement Data
    Domaine
    Marché des communes
    Paramètres et réponse
  • avis_zone_voter

    Voter pour l'utilité d'un avis

    Pose le vote d'utilité de l'utilisateur de la clé sur un avis : utile (par défaut) ou non. Le même appel deux fois laisse le même état ; le compteur d'utilité est recalculé depuis les votes.

    Coût
    0 crédit par appel réussi
    Accès
    À l'usage ou avec l'abonnement Data
    Domaine
    Marché des communes
    Paramètres et réponse
  • loyer_marche

    Loyer de marché d'un logement

    Loyer d'annonce, charges comprises, d'un logement d'une commune selon sa typologie (T1 à T5, maison) et sa surface, lu dans les quatre segments de la Carte des loyers (ANIL, DHUP) : loyer au m², loyer mensuel, fourchette à 95 %, segment retenu et repli éventuel sur l'ensemble des appartements, rendement brut de marché, et le modèle derrière chaque segment (type de prédiction, annonces observées, R² ajusté). Sans typologie ni surface, rend la synthèse de la commune (une ligne par typologie à surface d'exemple). Mêmes fonctions que les pages loyer de pillr.fr ; Paris, Lyon et Marseille sont agrégés depuis leurs arrondissements.

    Coût
    1 crédit par appel réussi
    Accès
    À l'usage ou avec l'abonnement Data
    Domaine
    Marché des communes
    Paramètres et réponse
  • encadrement_loyers

    Encadrement des loyers

    Encadrement des loyers d'un logement à Paris, décrit par son code postal, son nombre de pièces, son époque de construction, la location meublée ou non et sa surface, ou par une annonce du catalogue : loyers de référence, minoré et majoré au m² du barème le plus récent (quartier nommé, ou moyenne des quartiers de l'arrondissement), loyer maximal légal hors complément de loyer, et dépassement d'un loyer envisagé. Hors de Paris, applicable vaut faux et encadrement_en_vigueur dit si la commune figure parmi les communes encadrées ; leur barème n'est pas servi.

    Coût
    1 crédit par appel réussi
    Accès
    À l'usage ou avec l'abonnement Data
    Domaine
    Marché des communes
    Paramètres et réponse
  • zonage_logement

    Zonage ABC, plafonds et contraintes locales

    Zone ABC d'une commune (corrigée des révisions officielles que la base n'intègre pas encore), statut à la date de l'appel des dispositifs d'investissement locatif (Pinel, Relance logement, Denormandie, Loc'Avantages, déficit foncier) avec leur source officielle, plafond de loyer de la location intermédiaire au m² et, pour une surface donnée, au mois avec le coefficient de surface, comparé à un loyer, et contraintes locales à vérifier en mairie : encadrement des loyers, location de courte durée, tension du marché. Mêmes faits sourcés que les pages de pillr.fr ; aucun conseil fiscal.

    Coût
    1 crédit par appel réussi
    Accès
    À l'usage ou avec l'abonnement Data
    Domaine
    Marché des communes
    Paramètres et réponse
  • simuler_rendement

    Rendement, cash-flow et crédit

    Simulation d'un investissement locatif avec le moteur du simulateur de la fiche annonce de pillr.fr : pour la location nue, la location meublée longue durée et la courte durée, loyer, rendements brut et net, mensualité du crédit, cash-flow mensuel avant et après l'impôt de la première année (régime le moins imposé), décomposé poste par poste, et projection année par année. Recommandation sur le cash-flow avant impôt et sur le TRI après impôt et revente, taux d'effort au sens du HCSF quand les revenus sont donnés. Le loyer est celui donné, sinon le loyer de marché de la commune ; la courte durée suit le profil de marché AirDNA et le statut réglementaire de la commune. Les frais d'acquisition suivent le barème du département. Calcul déterministe, aucun conseil fiscal.

    Coût
    2 crédits par appel réussi
    Accès
    À l'usage ou avec l'abonnement Data
    Domaine
    Estimation
    Paramètres et réponse
  • taux_credit

    Taux de crédit du moment

    Taux de crédit immobilier du moment par durée (bon taux, très bon taux, taux excellent), lus dans le tableau du baromètre public de meilleurtaux.com, avec la date de sa simulation. Lecture d'une page tierce sans API ni contrat : si le tableau change de forme ou ne répond pas, l'opération répond « donnée indisponible », jamais un taux de repli. Réponse gardée 6 heures.

    Coût
    1 crédit par appel réussi
    Accès
    À l'usage ou avec l'abonnement Data
    Domaine
    Estimation
    Paramètres et réponse
  • simuler_fiscalite

    Simulation fiscale sur l'horizon de détention

    Simulation fiscale déterministe d'un investissement locatif, décrit ou désigné par une annonce, avec le moteur du simulateur de pillr.fr et de l'agent du Hub : location nue, meublée longue durée et courte durée, chacune évaluée sous chacun de ses régimes (micro-foncier, réel avec déficit, bailleur privé, micro-BIC, micro-BIC classé, réel LMNP, SCI à l'IS). Pour chaque régime : impôt et cash-flow année par année, revente nette et impôt de plus-value, TRI, VAN, enrichissement, et le motif d'un régime inaccessible. Recommandation motivée au meilleur TRI après impôt, prix maximum pour un TRI visé et pour un cash-flow nul, test de résistance, contraintes locales. Règles fiscales codées dans le moteur et citées dans ses avertissements ; aucun conseil fiscal.

    Coût
    2 crédits par appel réussi
    Accès
    À l'usage ou avec l'abonnement Data
    Domaine
    Estimation
    Paramètres et réponse
  • plus_value

    Plus-value immobilière à la revente

    Plus-value immobilière d'un particulier à la revente, avec le moteur fiscal de pillr.fr : durée de détention, prix d'acquisition majoré des frais (réels, ou forfait de 7,5 %) et des travaux (réels, ou forfait de 15 % après 5 ans), amortissements réintégrés en LMNP ou en bailleur privé, abattements pour durée de détention à l'impôt sur le revenu et aux prélèvements sociaux, impôt, prélèvements, surtaxe des plus-values élevées, impôt total et net vendeur. Exonération de la résidence principale. Aucun conseil fiscal.

    Coût
    1 crédit par appel réussi
    Accès
    À l'usage ou avec l'abonnement Data
    Domaine
    Estimation
    Paramètres et réponse
  • taxe_amenagement

    Taxe d'aménagement d'un projet

    Taxe d'aménagement d'un projet de construction, d'agrandissement, de piscine ou de places de stationnement extérieures, avec le moteur des démarches d'urbanisme de pillr.fr : parts communale, départementale et régionale (Île-de-France) aux taux votés par les collectivités (délibérations notifiées à la DGFiP), ou au barème légal en fourchette quand la commune n'en publie pas, abattement de la résidence principale, piscine et places au forfait, taxe d'archéologie préventive, déclaration et paiement, chaque valeur avec sa source. Un fait manquant revient en question. Estimation indicative : seul l'avis de la DGFiP fixe le montant dû.

    Coût
    1 crédit par appel réussi
    Accès
    À l'usage ou avec l'abonnement Data
    Domaine
    Urbanisme
    Paramètres et réponse
  • courte_duree_commune

    Marché de la courte durée d'une commune

    Marché de la location courte durée d'une commune : profil AirDNA (annonces actives, revenu, occupation, prix de nuit, revenu par nuit disponible, évolutions sur un an, score de marché et sous-scores), à la maille de la commune, de la ville pour un arrondissement, du département ajusté à la part de résidences secondaires ou de la France, avec sa confiance ; rentabilité de la courte durée, scores Pillr de courte durée, de longue durée et de tourisme, part de résidences secondaires, et statut réglementaire de la courte durée. Mêmes profils que le simulateur de pillr.fr. Données aspirées des pages publiques d'AirDNA.

    Coût
    2 crédits par appel réussi
    Accès
    À l'usage ou avec l'abonnement Data
    Domaine
    Marché des communes
    Paramètres et réponse
  • estimer_courte_duree

    Revenu de courte durée d'un logement

    Revenu de location courte durée d'un logement décrit par sa commune, sa surface et ses chambres, avec le modèle du simulateur de pillr.fr : capacité d'accueil, prix de nuit et occupation ajustés à la capacité depuis le profil de marché AirDNA de la commune, nuits ouvertes et réservées, montée en charge de la première année ; coûts d'exploitation (plateforme, conciergerie, renouvellement, ménage, linge, énergie, internet, assurance, classement), revenu net, statut réglementaire de la commune et du DPE, hypothèses et avertissements. Sans profil de marché, le revenu est un multiple du loyer nu, et le dit.

    Coût
    2 crédits par appel réussi
    Accès
    À l'usage ou avec l'abonnement Data
    Domaine
    Estimation
    Paramètres et réponse
  • risques_commune

    Risques naturels et technologiques

    Risques d'une commune : inondation, remontée de nappe, séisme, mouvement de terrain, argiles, radon, feu de forêt, site industriel, nucléaire, pollution des sols, rupture de barrage et risque minier, avec leur niveau et un score composite là où Géorisques est relevé en base, et les risques recensés par l'API publique Géorisques en direct ailleurs ; potentiel radon de l'IRSN pour toutes les communes ; arrêtés de catastrophe naturelle depuis 1982. Chaque bloc dit sa source. Ne remplace pas l'état des risques d'une adresse, obligatoire avant un achat.

    Coût
    2 crédits par appel réussi
    Accès
    À l'usage ou avec l'abonnement Data
    Domaine
    Marché des communes
    Paramètres et réponse
  • mesures_zone

    Équipements, accès, délinquance et cadre de vie

    Mesures d'une commune, chacune avec sa phrase et sa source, celles de l'analyse de zone de pillr.fr : équipements de la Base permanente des équipements (quinze comptes sur la commune entière et les essentiels absents), gare de voyageurs et aéroport les plus proches avec la distance, délinquance enregistrée par catégorie (faits et taux pour 1 000 habitants, comparés à la moyenne des communes publiées), potentiel radon et risques relevés, points d'intérêt à 500 m et score de marche à pied là où ils sont calculés.

    Coût
    2 crédits par appel réussi
    Accès
    À l'usage ou avec l'abonnement Data
    Domaine
    Marché des communes
    Paramètres et réponse
  • urbanisme_adresse

    Urbanisme à l'adresse

    Urbanisme à une adresse, par sa clé BAN, par l'adresse en texte ou par un point (lat et lon), d'après les documents publiés sur le Géoportail de l'Urbanisme : zone du PLU, du PLUi ou de la carte communale avec le lien du règlement, prescriptions et informations qui couvrent le point ou passent tout près, servitudes d'utilité publique avec le lien de l'acte, constats factuels, et un statut explicite quand aucune zone n'est rendue (commune au RNU, document non publié pour la commune, point hors des zones publiées). Le règlement n'est pas lu, son lien est donné. Seul un certificat d'urbanisme engage la commune.

    Coût
    2 crédits par appel réussi
    Accès
    À l'usage ou avec l'abonnement Data
    Domaine
    Urbanisme
    Paramètres et réponse
  • lire_plu

    Règlement du PLU lu et cité

    Les règles écrites du règlement de la zone du PLU ou du PLUi d'une adresse (clé BAN, adresse en texte ou point), par thème : voies, limites séparatives, distances entre constructions, emprise au sol, hauteur, piscines, annexes, stationnement, espaces verts, aspect et clôtures. Chaque règle porte sa valeur ou sa formule, son article, sa page et la citation exacte retrouvée dans le texte du PDF ; une règle dont la citation n'est pas retrouvée est écartée, jamais affirmée. La réponse donne aussi les définitions du lexique, les renvois et les thèmes non trouvés. Une zone déjà lue vient du cache des lectures de Pillr ; sinon le règlement est lu par un modèle, ce qui prend de l'ordre d'une minute : la réponse est une tâche (202) dont le résultat se lit ensuite. Une lecture nouvelle est bornée par le débit du serveur. Sans règlement à lire (commune au RNU, carte communale, aucun PDF publié), rien n'est débité. Seul un certificat d'urbanisme engage la commune.

    Coût
    60 crédits par appel réussi
    Accès
    À l'usage ou avec l'abonnement Data
    Domaine
    Règlement du PLU
    Paramètres et réponse
  • resultat_lire_plu

    Résultat : règlement du PLU lu et cité

    État et résultat d'une tâche lancée par POST /urbanisme/reglements (outil lire_plu) : statut, sortie complète quand elle est terminée, erreur quand elle a échoué (ses crédits sont alors rendus). Le paramètre attendre patiente jusqu'à 60 s.

    Coût
    0 crédit par appel réussi
    Accès
    À l'usage ou avec l'abonnement Data
    Domaine
    Règlement du PLU
    Paramètres et réponse
  • documents_urbanisme

    Documents d'urbanisme d'une commune

    Les documents d'urbanisme d'une commune publiés sur le Géoportail de l'Urbanisme : PLU, PLUi ou carte communale avec leur identifiant, type, état, dates et lien ; le RNU ; la liste des zones avec le lien de leur règlement et l'état de sa lecture par Pillr ; les secteurs de carte communale ; les servitudes d'utilité publique dont l'emprise touche celle de la commune, avec leurs actes. Pour un arrondissement de Paris, Lyon ou Marseille, les documents de la commune sont lus aussi.

    Coût
    2 crédits par appel réussi
    Accès
    À l'usage ou avec l'abonnement Data
    Domaine
    Urbanisme
    Paramètres et réponse
  • objets_urbanisme

    Objets d'urbanisme dans une emprise

    Les objets du Géoportail de l'Urbanisme dont l'emprise touche une boîte d'environ 2 km de côté au plus, avec leur géométrie GeoJSON et leurs propriétés brutes : zones, secteurs de carte communale, prescriptions et informations (surfaces, lignes, points), assiettes de servitudes. Liste paginée par curseur, dans l'ordre des couches puis des identifiants. Un objet est retenu quand sa boîte englobante touche l'emprise : sa géométrie peut rester en dehors.

    Coût
    1 crédit par élément rendu
    Accès
    À l'usage ou avec l'abonnement Data
    Domaine
    Urbanisme
    Paramètres et réponse
  • permis_adresse

    Autorisations d'urbanisme d'une adresse ou d'une parcelle

    Toutes les autorisations d'urbanisme Sitadel d'une adresse (clé BAN) ou d'une parcelle cadastrale : permis de construire, déclarations préalables, permis d'aménager et de démolir, locaux non résidentiels. Pour chacune : type, état, dates d'autorisation, d'ouverture de chantier et d'achèvement, nature du projet, logements créés par taille, sociaux et en prêt à taux zéro, surfaces, superficie du terrain, demandeur personne morale nommé avec son SIREN (une personne physique n'est jamais nommée), parcelles, et tous les champs publiés. Le rattachement se fait par une parcelle du terrain, sinon par le numéro et la voie, et chaque autorisation dit lequel. Les dates postérieures à aujourd'hui sont des dates prévisionnelles de la source, signalées.

    Coût
    3 crédits par appel réussi
    Accès
    À l'usage ou avec l'abonnement Data
    Domaine
    Adresse et DPE
    Paramètres et réponse
  • permis

    Recherche d'autorisations d'urbanisme

    Les autorisations d'urbanisme Sitadel d'une commune, d'un demandeur personne morale (SIREN) ou d'un numéro, filtrées par période, type (PC, DP, PA, PD), nature du projet et nombre de logements créés, des plus récentes aux plus anciennes. Chaque autorisation porte les mêmes champs que permis_adresse, l'adresse du terrain, la clé BAN rapprochée (par une parcelle du terrain, sinon par le numéro et la voie) et tous les champs publiés. Pour Paris, Lyon et Marseille, Sitadel range les autorisations sous la commune entière : un code d'arrondissement est lu avec celui de sa commune.

    Coût
    1 crédit par élément rendu
    Accès
    À l'usage ou avec l'abonnement Data
    Domaine
    Urbanisme
    Paramètres et réponse
  • demarche_urbanisme

    Démarche d'urbanisme d'un projet

    Démarche d'urbanisme d'un projet de travaux décrit, sans adresse : formalité (aucune, déclaration préalable, permis de construire, d'aménager ou de démolir), formulaire Cerfa, architecte obligatoire ou non, pièces du dossier avec l'opération qui les prépare, délai d'instruction et valeur du silence de la mairie, taxe d'aménagement estimée (aux taux votés par la commune quand son code INSEE est donné, sinon en fourchette du barème légal) et redevance d'archéologie préventive, chaque conclusion avec sa règle et sa source, et la date de la base de règles. Un fait manquant revient en question, jamais en supposition. La zone du PLU et les servitudes ne sont pas lues : les protections du terrain se déclarent en paramètres (urbanisme_adresse les donne pour une adresse). Information générale, ni conseil juridique ni décision de la mairie.

    Coût
    1 crédit par appel réussi
    Accès
    À l'usage ou avec l'abonnement Data
    Domaine
    Urbanisme
    Paramètres et réponse
  • croquis_projet

    Plan de situation, plan de masse et implantation

    Le plan de situation et le plan de masse coté d'un projet (extension, annexe, abri, garage, carport, piscine, terrasse, véranda) sur la parcelle cadastrale et les bâtiments de la BD TOPO de l'IGN, lus en direct, pour une adresse, un identifiant de parcelle ou un point. Les projets se placent contre un côté du bâtiment principal, à une distance d'une limite, par un contour donné, ou automatiquement : trois emplacements notés sur l'ensoleillement au 21 juin et au 21 mars, les distances, le relief et les limites. La réponse donne les emprises et les mesures, les alertes (débord, chevauchement), la formalité établie depuis les projets dessinés, la zone du PLU et les servitudes lues en un point de la parcelle, les règles du règlement déjà lu (reculs, emprise, hauteur) et les vues du plan de situation. Le plan de masse n'est pas dessiné quand un architecte est obligatoire ou que des faits manquent : la réponse le dit, avec les questions. Croquis indicatif, à vérifier avant dépôt.

    Coût
    20 crédits par appel réussi
    Accès
    À l'usage ou avec l'abonnement Data
    Domaine
    Urbanisme
    Paramètres et réponse
  • coupes_facades

    Coupes, façades et toitures

    Le plan en coupe et le plan des façades et des toitures des projets d'un croquis, à l'échelle : terrain naturel lu en direct sur le RGE ALTI de l'IGN (altitudes NGF), hauteur maximale au-dessus du terrain, distances aux limites, surfaces de déblai et de remblai, toitures (plate, un ou deux pans), ouvertures et matériaux, silhouettes des bâtiments existants accolés. Les projets se décrivent comme pour croquis_projet, avec leurs niveaux, leur toiture et leurs ouvertures. Un fait manquant revient en question et le projet n'est pas dessiné ; si l'altimétrie de l'IGN ne répond pas, rien n'est dessiné ni débité.

    Coût
    20 crédits par appel réussi
    Accès
    À l'usage ou avec l'abonnement Data
    Domaine
    Urbanisme
    Paramètres et réponse
  • preparer_dossier

    Dossier de dépôt

    Le dossier de dépôt en mairie d'un projet, établi dans l'appel : le croquis de la parcelle (comme croquis_projet), les coupes et façades quand les projets en portent les faits (comme coupes_facades), puis la formalité et le Cerfa retenus, les pièces dans l'ordre du bordereau avec leur code, leur rôle et leur état (prête, à produire par une opération, à fournir par le demandeur), ce qui manque, les alertes du croquis et les données du Cerfa à passer à l'opération cerfa. La réponse est une tâche (202) dont le résultat se lit ensuite. L'archive ZIP du dossier (pièces graphiques à l'échelle, Cerfa, bordereau) se fabrique dans le Hub : par l'API, chaque pièce se produit par son opération.

    Coût
    200 crédits par appel réussi
    Accès
    À l'usage ou avec l'abonnement Data
    Domaine
    Urbanisme
    Paramètres et réponse
  • resultat_preparer_dossier

    Résultat : dossier de dépôt

    État et résultat d'une tâche lancée par POST /urbanisme/dossiers (outil preparer_dossier) : statut, sortie complète quand elle est terminée, erreur quand elle a échoué (ses crédits sont alors rendus). Le paramètre attendre patiente jusqu'à 60 s.

    Coût
    0 crédit par appel réussi
    Accès
    À l'usage ou avec l'abonnement Data
    Domaine
    Urbanisme
    Paramètres et réponse
  • cerfa

    Cerfa d'urbanisme pré-rempli

    Le PDF officiel d'un Cerfa d'urbanisme (lu sur formulaires.service-public.gouv.fr, dans la version vérifiée par Pillr), rempli des seules cases connues du dossier : adresse et superficie du terrain, références cadastrales, nature des travaux, annexes, emprise au sol créée, description du projet. L'identité, les coordonnées, l'engagement et la signature du demandeur ne sont jamais remplis : la réponse les liste avec les cases restées vides. En REST, la réponse est le PDF ; en MCP, la liste des cases remplies et vides, et le PDF en ressource. Si le formulaire officiel a changé depuis sa vérification, rien n'est rempli ni débité et les valeurs sont rendues pour une saisie à la main.

    Coût
    5 crédits par appel réussi
    Accès
    À l'usage ou avec l'abonnement Data
    Domaine
    Urbanisme
    Paramètres et réponse
  • echeances_depot

    Échéances d'un dossier après dépôt

    Échéances datées d'un dossier d'urbanisme à partir de sa date de dépôt : courrier de pièces manquantes, fin du délai d'instruction (de droit commun et majoré), date à partir de laquelle le silence vaut accord ou refus, affichage et recours des tiers, retrait par la mairie, prorogation et fin de validité, recours contre un refus, puis DAACT, déclaration et paiement de la taxe d'aménagement à l'achèvement. Chaque échéance porte sa règle et sa source. La démarche se donne telle que demarche_urbanisme l'a établie, ou se calcule dans l'appel à partir des faits du projet. Les dates se comptent de quantième à quantième ; le récépissé et les courriers de la mairie font foi.

    Coût
    1 crédit par appel réussi
    Accès
    À l'usage ou avec l'abonnement Data
    Domaine
    Urbanisme
    Paramètres et réponse
  • rendu_aerien

    Rendu réaliste d'un projet sur la vue aérienne

    Une image réaliste du projet posé à l'échelle sur la photo aérienne de l'IGN : la photo est lue en direct, le dessin exact du projet y est composé, puis un modèle d'image rend le seul projet réaliste, sans rien ajouter ni déplacer. L'image est une illustration indicative : elle ne remplace pas le document graphique d'insertion du dossier. En REST, la réponse est l'image PNG ; en MCP, ses métadonnées, et l'image en ressource. Les rendus sont bornés par heure et par organisation, comme dans le Hub.

    Coût
    100 crédits par appel réussi
    Accès
    À l'usage ou avec l'abonnement Data
    Domaine
    Urbanisme
    Paramètres et réponse
  • agences_commune

    Agences actives et parts de marché d'une commune

    Les agences actives dans une commune, mois par mois, d'après les annonces relevées par Pillr : enseigne, SIREN, mandats pris, mandats exclusifs, durée médiane en ligne, part des annonces baissées et part de marché de chaque agence, avec la part du leader et l'indice de concentration (HHI) de la commune. Par défaut le dernier mois calculé ; « mois » pour un mois donné, « depuis » pour tous les mois à partir d'un mois (24 mois au plus). Rien n'est masqué : un mois à peu de mandats est servi avec le drapeau peu_d_observations. Aucune agence relevée : 404 ressource_absente, rien n'est débité.

    Coût
    3 crédits par appel réussi
    Accès
    À l'usage ou avec l'abonnement Data
    Domaine
    Entreprises, agences et sociétés civiles
    Paramètres et réponse
  • agences

    Agences et réseaux immobiliers

    La fiche d'une agence immobilière par son SIREN, ou les agences d'un lieu (commune, code postal, département), d'une enseigne ou d'un réseau. Pour chacune : dénomination, enseigne, sigle, catégorie juridique, APE, établissements Sirene (SIRET, adresse, effectif, création, siège), agences des portails rattachées au SIREN avec leur enseigne ou réseau, domaines web, coordonnées professionnelles avec leur origine, mandats du dernier mois par commune, annonces en ligne, et les 20 derniers avis BODACC. Seules les adresses électroniques publiées par l'agence sont servies, jamais une adresse construite par motif. Aucune agence : 404 ressource_absente, rien n'est débité.

    Coût
    2 crédits par élément rendu
    Accès
    À l'usage ou avec l'abonnement Data
    Domaine
    Entreprises, agences et sociétés civiles
    Paramètres et réponse
  • agents_immobiliers

    Agents et mandataires

    Les agents et mandataires immobiliers vus sur les portails et dans les annuaires des réseaux, servis comme professionnels : nom d'exercice, réseau, SIREN, communes, nombre de biens, types et prix, et coordonnées professionnelles avec leur origine. Filtres : commune (code INSEE, rapprochée par le code postal et le nom de la commune principale), code postal, département, SIREN de l'agence ou réseau. Seules les adresses électroniques publiées par le professionnel sont servies, jamais une adresse construite par motif ; un professionnel qui s'est opposé à nos envois n'a plus aucune coordonnée servie. Aucun agent : 404 ressource_absente, rien n'est débité.

    Coût
    1 crédit par élément rendu
    Accès
    À l'usage ou avec l'abonnement Data
    Domaine
    Entreprises, agences et sociétés civiles
    Paramètres et réponse
  • societes_civiles

    Sociétés civiles domiciliées à une adresse

    Les sociétés civiles (immobilières, de moyens...) domiciliées à une adresse de la Base Adresse Nationale, par sa clé : dénomination, SIREN, forme, avis BODACC (création, modification, radiation, procédure, cession) avec leur date, et présence d'une société avant le dernier DPE. Les avis sont ceux que la gold de Pillr rattache à l'adresse ; le SIREN est rapproché par la dénomination et le code postal. Les gérants et associés ne sont jamais nommés. Adresse inconnue : 404 adresse_introuvable, rien n'est débité ; une adresse sans société civile rend n = 0.

    Coût
    3 crédits par appel réussi
    Accès
    À l'usage ou avec l'abonnement Data
    Domaine
    Adresse et DPE
    Paramètres et réponse
  • entreprise

    Entreprise : avis BODACC et autorisations

    Une entreprise par son SIREN : tous ses avis BODACC depuis 2009 (création, modifications, radiation, ventes et cessions, procédures collectives, dépôts des comptes), avec leur contenu structuré (établissements, jugements, actes), ses établissements Sirene de l'immobilier, ses autorisations d'urbanisme (Sitadel) et, si c'est une agence, ses enseignes et ses mandats par commune. Les personnes physiques d'un avis (gérants, associés) ne gardent que leur qualité ; un avis qui porte sur une personne physique ne sert ni son identité ni ses textes. Filtres : familles d'avis et date de début. SIREN inconnu de toutes les sources : 404 ressource_absente, rien n'est débité.

    Coût
    3 crédits par appel réussi
    Accès
    À l'usage ou avec l'abonnement Data
    Domaine
    Entreprises, agences et sociétés civiles
    Paramètres et réponse
  • analyse_immeuble

    Dossier d'un immeuble de rapport

    Le dossier d'un immeuble de rapport, en cinq blocs, celui de l'outil analyse_immeuble du Hub : 1. les lots établis par les DPE de l'adresse (candidats dans un rayon de 250 m, confiance par concordance de surface et nombre de logements annoncé, désaccord) ; 2. l'état locatif lot par lot au loyer de la Carte des loyers selon la taille de chaque lot, et une découpe en lots de 40 ou 30 m² ; 3. le prix face à la prime de division DVF de la commune (repli départemental), servie quel que soit le nombre de ventes ; 4. les seuils fiscaux propres à l'immeuble ; 5. les risques datés, dont le calendrier énergétique par étiquette. Le vendeur n'est jamais nommé. Pour une annonce d'immeuble du catalogue Pillr, par son identifiant.

    Coût
    10 crédits par appel réussi
    Accès
    À l'usage ou avec l'abonnement Data
    Domaine
    Annonces
    Paramètres et réponse
  • analyse_immeuble_calculer

    Dossier d'un immeuble pas encore analysé

    Le dossier d'un immeuble de rapport, en cinq blocs, celui de l'outil analyse_immeuble du Hub : 1. les lots établis par les DPE de l'adresse (candidats dans un rayon de 250 m, confiance par concordance de surface et nombre de logements annoncé, désaccord) ; 2. l'état locatif lot par lot au loyer de la Carte des loyers selon la taille de chaque lot, et une découpe en lots de 40 ou 30 m² ; 3. le prix face à la prime de division DVF de la commune (repli départemental), servie quel que soit le nombre de ventes ; 4. les seuils fiscaux propres à l'immeuble ; 5. les risques datés, dont le calendrier énergétique par étiquette. Le vendeur n'est jamais nommé. Pour un immeuble collecté par Pillr que la file d'analyse n'a pas encore atteint, par le lien de son annonce (source_url).

    Coût
    10 crédits par appel réussi
    Accès
    À l'usage ou avec l'abonnement Data
    Domaine
    Annonces
    Paramètres et réponse
  • lots_adresse

    Lots d'un immeuble établis par ses DPE

    Les lots d'un immeuble à une adresse (clé BAN), établis par les DPE de ses logements (ADEME) : un lot par DPE d'appartement de moins de 10 ans, surface, étiquette, étage, numéros de DPE ; un DPE remplacé rejoint le lot de son remplaçant. Deux DPE du même étage à la même surface sans lien de remplacement sont signalés comme doublon possible, jamais fusionnés. Le compte est confronté au registre des copropriétés et au DPE de l'immeuble ; chaque écart est dit dans desaccords.

    Coût
    3 crédits par appel réussi
    Accès
    À l'usage ou avec l'abonnement Data
    Domaine
    Adresse et DPE
    Paramètres et réponse
  • prime_division

    Prime de division d'une commune

    Prime de division mesurée sur DVF dans une commune : prix au m² médian des mutations d'un seul logement face aux mutations de 4 logements ou plus (ventes en bloc), sur les 3 dernières années, avec le nombre de mutations de chaque côté, la période couverte et la qualité de la mesure. Les médianes sont servies quel que soit le nombre de ventes, avec le drapeau peu_d_observations sous les seuils du dossier immeuble ; sous ces seuils, la mesure du département est servie à côté. Paris, Lyon et Marseille se mesurent sur leurs arrondissements. Le rapport est un plafond, pas un profit.

    Coût
    2 crédits par appel réussi
    Accès
    À l'usage ou avec l'abonnement Data
    Domaine
    Marché des communes
    Paramètres et réponse
  • travaux_zone

    Indice Travaux et état du parc en vente

    Pour un code postal ou une commune, un mois d'entrée au catalogue et un type de bien : biens lus (une fiche par bien), état visuel médian lu sur les photos, part des biens à rénover, coût médian des travaux et au m², avec l'incertitude mesurée du chiffrage. Le coût vient du barème déterministe d'artisans appliqué aux postes vus sur les photos, jamais d'un montant écrit par le modèle ; les annonces aux photos de catalogue sont écartées et comptées. Par défaut le dernier mois calculé et tous les types. Rien n'est masqué : une maille à peu de biens est servie avec le drapeau peu_d_observations. Maille inconnue : 404 ressource_absente, rien n'est débité.

    Coût
    2 crédits par appel réussi
    Accès
    À l'usage ou avec l'abonnement Data
    Domaine
    Analyse des photos
    Paramètres et réponse
  • travaux_zone_lot

    Indice Travaux et état du parc en vente, en lot

    Indice Travaux et état du parc en vente pour 100 éléments au plus en un appel : chaque élément est servi ou refusé seul, avec son code d'erreur, et seuls les éléments servis sont débités. Pour un code postal ou une commune, un mois d'entrée au catalogue et un type de bien : biens lus (une fiche par bien), état visuel médian lu sur les photos, part des biens à rénover, coût médian des travaux et au m², avec l'incertitude mesurée du chiffrage. Le coût vient du barème déterministe d'artisans appliqué aux postes vus sur les photos, jamais d'un montant écrit par le modèle ; les annonces aux photos de catalogue sont écartées et comptées. Par défaut le dernier mois calculé et tous les types. Rien n'est masqué : une maille à peu de biens est servie avec le drapeau peu_d_observations. Maille inconnue : 404 ressource_absente, rien n'est débité.

    Coût
    2 crédits par élément rendu
    Accès
    À l'usage ou avec l'abonnement Data
    Domaine
    Analyse des photos
    Paramètres et réponse
  • barometre

    Baromètre

    L'édition figée du baromètre de Pillr pour la France, un département ou une commune : chaque mesure du registre (prix de référence, ventes, loyer, rendement, annonces, baisses de prix, biens à rénover, budget travaux, écart au prix de référence, part des DPE F et G, résidences secondaires, vacance, revenu), avec son effectif, son intervalle quand il existe, et son seuil de publication. Rien n'est masqué : une valeur sous le seuil de publication du site est servie avec publiee = faux et son motif. edition vaut AAAA-MM ou courante. Édition ou territoire inconnus : 404, rien n'est débité.

    Coût
    1 crédit par appel réussi
    Accès
    À l'usage ou avec l'abonnement Data
    Domaine
    Marché des communes
    Paramètres et réponse
  • barometre_lot

    Baromètre, en lot

    Baromètre pour 100 éléments au plus en un appel : chaque élément est servi ou refusé seul, avec son code d'erreur, et seuls les éléments servis sont débités. L'édition figée du baromètre de Pillr pour la France, un département ou une commune : chaque mesure du registre (prix de référence, ventes, loyer, rendement, annonces, baisses de prix, biens à rénover, budget travaux, écart au prix de référence, part des DPE F et G, résidences secondaires, vacance, revenu), avec son effectif, son intervalle quand il existe, et son seuil de publication. Rien n'est masqué : une valeur sous le seuil de publication du site est servie avec publiee = faux et son motif. edition vaut AAAA-MM ou courante. Édition ou territoire inconnus : 404, rien n'est débité.

    Coût
    1 crédit par élément rendu
    Accès
    À l'usage ou avec l'abonnement Data
    Domaine
    Marché des communes
    Paramètres et réponse
  • dossier_barometre

    Dossier du baromètre sur demande

    Un dossier du baromètre composé à partir d'une demande libre : le modèle propose un plan (classements, comparaisons, croisements, répartitions) sur le registre des mesures, sans voir aucun chiffre ; les sections sont calculées de façon déterministe sur l'édition ; la lecture rédigée par le modèle passe par un vérificateur qui retire toute phrase dont un chiffre n'est pas dans les faits calculés. Rend le plan, chaque section (faits, lecture vérifiée, lecture déterministe, graphique, tableau) et un lien signé vers le dossier sur pillr.fr. Les classements suivent les seuils de classement de l'édition. Demande hors du périmètre du baromètre : 400 parametres_invalides, rien n'est débité ; modèle indisponible : 503, crédits rendus.

    Coût
    20 crédits par appel réussi
    Accès
    À l'usage ou avec l'abonnement Data
    Domaine
    Marché des communes
    Paramètres et réponse
  • modeles

    Fiches de mesure des modèles

    La fiche de mesure de chaque modèle de Pillr, avec la date et l'échantillon de chaque mesure : erreur de l'estimation sur des ventes DVF (avec et sans adresse) et couverture de sa fourchette ; reproductibilité du chiffrage des travaux et de l'état visuel ; calibration du pré-marché par bande et par type de bien (taux de vente DVF à 12 mois), coefficients, coefficients ajustés et AUC, décroissance par âge du DPE, précision des cohortes ; méthode et limites du barème de prix au m² et du loyer de marché. Sans modèle, toutes les fiches. Une mesure absente se dit dans les limites, jamais par un chiffre de remplacement.

    Coût
    0 crédit par appel réussi
    Accès
    À l'usage ou avec l'abonnement Data
    Domaine
    Référentiels
    Paramètres et réponse
  • constantes_reference

    Constantes réglementaires et fiscales de référence

    Les seuils et taux que les moteurs de Pillr appliquent, par thème : urbanisme (seuils de la déclaration préalable, architecte, piscines), fiscalité (TVA des travaux, Malraux, Pinel, déficit et micro-foncier, régimes micro, prélèvements sociaux, impôt sur les sociétés, amortissement du bailleur privé), pré-marché (fenêtre de mandat, pack de pré-vente) et location (calendrier d'interdiction de louer les passoires énergétiques). Chacune porte sa valeur, son unité, son objet, sa source officielle ou sa mesure, et la date de la version lue. Le registre dit qu'un seuil est le bon seuil, pas qu'il s'applique à un cas donné.

    Coût
    0 crédit par appel réussi
    Accès
    À l'usage ou avec l'abonnement Data
    Domaine
    Marché des communes
    Paramètres et réponse
  • flux_annonces

    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é
    Accès
    Avec l'abonnement Data
    Domaine
    Flux d'évènements
    Paramètres et réponse
  • flux_adresses

    Flux de nouveautés à l'adresse

    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
    Domaine
    Flux d'évènements
    Paramètres et réponse
  • webhooks_creer

    Créer un abonnement webhook

    Abonne une URL https aux évènements du flux des annonces (genres et filtres au choix), à la fin des opérations asynchrones de l'organisation, et aux résultats des veilles et des alertes que l'organisation a créées par l'API (livrés 15 minutes au moins après leur remontée, au format de resultats_veilles). Chaque livraison est un POST JSON signé par l'en-tête Pillr-Signature (t=horodatage, v1=HMAC-SHA256 du texte « horodatage.corps » avec le secret de l'abonnement), reprise à 1 min, 5 min, 30 min, 2 h et 12 h en cas d'échec ; l'abonnement est coupé après 50 échecs consécutifs. Le secret n'est affiché qu'à la création. Chaque évènement d'annonce et chaque résultat livré est débité au barème evenement (1 crédit).

    Coût
    0 crédit par appel réussi
    Accès
    Avec l'abonnement Data
    Domaine
    Webhooks
    Paramètres et réponse
  • webhooks

    Abonnements webhook de l'organisation

    Les abonnements webhook de l'organisation, sans leur secret, avec leur état (actif ou coupé, échecs consécutifs) et leurs dernières livraisons.

    Coût
    0 crédit par appel réussi
    Accès
    Avec l'abonnement Data
    Domaine
    Webhooks
    Paramètres et réponse
  • webhooks_supprimer

    Supprimer un abonnement webhook

    Supprime un abonnement webhook de l'organisation et ses livraisons en attente.

    Coût
    0 crédit par appel réussi
    Accès
    Avec l'abonnement Data
    Domaine
    Webhooks
    Paramètres et réponse
  • webhooks_tester

    Tester un abonnement webhook

    Envoie tout de suite à l'URL de l'abonnement une livraison d'essai signée (genre test), sans reprise, et rend le code HTTP reçu. Un essai réussi réactive un abonnement coupé.

    Coût
    0 crédit par appel réussi
    Accès
    Avec l'abonnement Data
    Domaine
    Webhooks
    Paramètres et réponse
  • veilles_creer

    Créer un agent de veille

    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
    Domaine
    Flux d'évènements
    Paramètres et réponse
  • veilles

    Agents de veille du compte

    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
    Domaine
    Flux d'évènements
    Paramètres et réponse
  • veilles_modifier

    Modifier un agent de veille

    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
    Domaine
    Flux d'évènements
    Paramètres et réponse
  • alertes_zone_creer

    Créer un suivi de zone

    Crée un suivi de zone rattaché au compte de la clé : une commune, un code INSEE, un code postal, un disque autour d'un point, une liste de communes ou une intercommunalité (une alerte par commune). Trois volets, actifs par défaut : le pré-marché (adresses dont la priorité dépasse le seuil), les annonces de particuliers qui stagnent, baissent ou republient, et les signaux marché (baisses de la veille, passages en multi-mandat). Passage chaque nuit, quotidien ou hebdomadaire ; le premier a lieu le lendemain matin. Rien n'est créé si le secteur dépasse les places libres sous le plafond des suivis actifs du compte.

    Coût
    0 crédit par appel réussi
    Accès
    À l'usage ou avec l'abonnement Data
    Domaine
    Pré-marché
    Paramètres et réponse
  • alertes_pre_marche_creer

    Créer une veille pré-marché

    Crée une veille pré-marché rattachée au compte de la clé, sur un secteur (commune, code INSEE, code postal ou disque autour d'un point) : chaque nuit, les nouvelles adresses dont la priorité dépasse le seuil. Le compte garde un plafond de veilles pré-marché actives.

    Coût
    0 crédit par appel réussi
    Accès
    À l'usage ou avec l'abonnement Data
    Domaine
    Pré-marché
    Paramètres et réponse
  • alertes

    Alertes du compte

    Les suivis de zone et les veilles pré-marché du compte de la clé, actives d'abord : secteur, volets suivis, seuils, fréquence et dernier passage.

    Coût
    0 crédit par appel réussi
    Accès
    À l'usage ou avec l'abonnement Data
    Domaine
    Pré-marché
    Paramètres et réponse
  • alertes_supprimer

    Supprimer une alerte

    Supprime un suivi de zone ou une veille pré-marché du compte de la clé, avec ses résultats.

    Coût
    0 crédit par appel réussi
    Accès
    À l'usage ou avec l'abonnement Data
    Domaine
    Pré-marché
    Paramètres et réponse
  • resultats_veilles

    Résultats des veilles et des alertes

    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
    Domaine
    Flux d'évènements
    Paramètres et réponse
  • question_hub

    Question à l'agent du Hub

    Une question libre posée à l'agent du Hub, qui raisonne avec Gemini 4 Argon (Google). L'agent enchaîne les opérations de lecture de ce catalogue servies à la clé (portée et palier vérifiés comme pour un appel direct), puis rédige sa réponse ; il rend aussi chaque appel avec son résultat structuré et ses crédits. Chaque opération appelée est facturée à son barème, en plus du prix de la question, dans la limite de plafond_credits : au-delà, l'agent conclut avec ce qu'il a. Avec une clé personnelle, le profil investisseur, la mémoire du compte et le projet désigné entrent dans son contexte.

    Coût
    120 crédits par appel réussi
    Accès
    À l'usage ou avec l'abonnement Data
    Domaine
    Hub et documents
    Paramètres et réponse
  • generer_document

    Document mis en forme (PDF ou Word)

    Met en forme un document à partir des sections fournies (titres, paragraphes, puces, tableaux, sources) et le rend en PDF ou en Word : rapport, lettre, compte rendu, check-list, note ou comparatif. Aucun modèle de langage : le contenu vient de l'appelant. Le texte entre doubles astérisques est mis en gras dans le Word. La réponse JSON (et le contenu structuré du MCP) décrit le fichier, dont le texte brut sans coordonnées ; le fichier, lui, garde le contenu fourni.

    Coût
    2 crédits par appel réussi
    Accès
    À l'usage ou avec l'abonnement Data
    Domaine
    Documents
    Paramètres et réponse
  • lire_document

    Lecture de documents par le modèle

    Fait lire par le modèle (Gemini) des documents du client, PDF ou images (diagnostics, procès-verbaux d'assemblée générale, offres, baux, plans), pour répondre à une question : la réponse, les faits relevés avec leur page et une citation, les références datées (échéances, votes). Les fichiers sont reconnus par leurs octets, bornés en taille, transmis à l'API Fichiers de Gemini le temps de la lecture puis effacés (à défaut, Google les efface sous 48 h) ; Pillr n'en garde rien. Le contenu des documents est traité comme une donnée, jamais comme une instruction. Les téléphones, emails et noms précédés d'une civilité sont remplacés par une mention dans la réponse.

    Coût
    30 crédits par appel réussi
    Accès
    À l'usage ou avec l'abonnement Data
    Domaine
    Documents
    Paramètres et réponse
  • audit_portefeuille

    Audit d'une liste de biens face au marché

    Audite une liste d'annonces suivies, ou les favoris du compte de la clé : prix au m² du bien contre celui du secteur (même type de bien), baisse depuis l'ajout, échéance de la loi Climat, loyer estimé contre loyer de marché, score et rendement, avec des alertes d'arbitrage. Mêmes calculs que l'outil d'audit du Hub. Un crédit par bien audité.

    Coût
    1 crédit par élément rendu
    Accès
    À l'usage ou avec l'abonnement Data
    Domaine
    Annonces
    Paramètres et réponse
  • memoire

    Mémoire du compte

    Les faits durables retenus sur l'utilisateur de la clé (TMI, apport, stratégie, secteurs, métier), que le Hub et question_hub reprennent dans leur contexte, les plus récents d'abord, avec la TMI et l'apport rangés dans le profil.

    Coût
    0 crédit par appel réussi
    Accès
    À l'usage ou avec l'abonnement Data
    Domaine
    Compte et personnalisation
    Paramètres et réponse
  • memoire_ajouter

    Ajouter des faits à la mémoire

    Ajoute des faits durables à la mémoire du compte, avec les règles du Hub : dédoublonnage, plafond (le plus ancien sort), refus des données sensibles, d'un contact ou de la donnée d'un tiers nommé, avec leur motif. Une TMI ou un apport reconnus renseignent aussi le profil investisseur.

    Coût
    0 crédit par appel réussi
    Accès
    À l'usage ou avec l'abonnement Data
    Domaine
    Compte et personnalisation
    Paramètres et réponse
  • conversations_hub

    Conversations du Hub

    Les conversations du Hub de l'utilisateur de la clé, les plus récemment modifiées d'abord, avec leur projet et leur annonce suivie.

    Coût
    0 crédit par appel réussi
    Accès
    À l'usage ou avec l'abonnement Data
    Domaine
    Hub et documents
    Paramètres et réponse
  • conversations_hub_lire

    Une conversation du Hub

    Une conversation du Hub et ses messages dans l'ordre (les 200 derniers au plus), avec les outils appelés et leurs résultats.

    Coût
    0 crédit par appel réussi
    Accès
    À l'usage ou avec l'abonnement Data
    Domaine
    Hub et documents
    Paramètres et réponse
  • conversations_hub_question

    Poursuivre une conversation du Hub

    Pose une question qui poursuit une conversation du Hub : l'agent reprend le fil (derniers messages), l'annonce suivie et le projet rattaché, et l'échange est enregistré dans la conversation, lisible sur le site. L'agent enchaîne les opérations de lecture de ce catalogue servies à la clé (portée et palier vérifiés comme pour un appel direct), puis rédige sa réponse ; il rend aussi chaque appel avec son résultat structuré et ses crédits. Chaque opération appelée est facturée à son barème, en plus du prix de la question, dans la limite de plafond_credits : au-delà, l'agent conclut avec ce qu'il a.

    Coût
    120 crédits par appel réussi
    Accès
    À l'usage ou avec l'abonnement Data
    Domaine
    Hub et documents
    Paramètres et réponse
  • conversations_hub_modifier

    Renommer, épingler ou rattacher une conversation

    Renomme une conversation du Hub, l'épingle ou la désépingle, la rattache à un projet du compte ou l'en détache.

    Coût
    0 crédit par appel réussi
    Accès
    À l'usage ou avec l'abonnement Data
    Domaine
    Hub et documents
    Paramètres et réponse
  • jeux

    Catalogue des jeux de données

    Le catalogue des jeux que lisent lire_jeu et agreger_jeu, tel que chaque base le déclare (liste blanche des colonnes, relue sur la vue du jeu) : pour chaque jeu, sa description, sa base, sa nature (calculé par Pillr ou public brut), sa maille, sa source et sa licence d'origine, son volume estimé, sa clé de tri, son coût par ligne, la date de ses données quand un journal de chargement la donne, et ses colonnes avec leur type, leur définition, leurs opérateurs de filtre et si elles sont indexées, groupables ou mesurables. GET /jeux/{jeu}/schema rend un seul jeu.

    Coût
    0 crédit par appel réussi
    Accès
    À l'usage ou avec l'abonnement Data
    Domaine
    Référentiels
    Paramètres et réponse
  • lire_jeu

    Lecture structurée d'un jeu de données

    Les lignes d'un jeu de données, sans SQL : filtre[colonne][operateur]=valeur sur les colonnes filtrables du jeu (eq, in, lt, lte, gt, gte, entre, prefixe, nul ; combinés par « et »), colonnes choisies par champs, pagination par curseur. Un jeu volumineux exige au moins un filtre sur une colonne indexée (schéma du jeu : GET /jeux/{jeu}/schema). Les lignes sont triées par la clé de tri du jeu, en ordre croissant ; aucun autre tri n'est offert. Toute ligne passe le retrait des particuliers : les professionnels sont nommés, un particulier jamais. Un jeu marqué creneau_lourd n'est pas lu de 20h30 à minuit (heure de Paris) ; une lecture trop large pour le délai de la base répond 503 : resserrez les filtres.

    Coût
    1 crédit par tranche de 10 lignes rendues ; 1 crédit par élément rendu pour un jeu calculé par Pillr
    Accès
    À l'usage ou avec l'abonnement Data
    Domaine
    Jeux de données
    Paramètres et réponse
  • agreger_jeu

    Agrégats sur un jeu de données

    Des agrégats sur un jeu, avec les filtres de lire_jeu : le nombre de lignes de chaque groupe (n, toujours rendu) et des mesures sur les colonnes mesurables (nombre, somme, moyenne, médiane, quantile, minimum, maximum ; médiane et quantiles continus), groupées par 3 colonnes groupables au plus. Les groupes les plus nombreux d'abord, 1000 au plus. Aucun seuil ne masque un groupe : un petit groupe est servi avec son n et le drapeau peu_d_observations. Servi depuis la mémoire seulement de 20h30 à minuit (heure de Paris).

    Coût
    5 crédits par appel réussi
    Accès
    À l'usage ou avec l'abonnement Data
    Domaine
    Jeux de données
    Paramètres et réponse
  • sources

    État des sources

    L'état des données de Pillr, source par source, lu dans les journaux de chargement : sources publiques rafraîchies par le site (dernier succès, prochaine mise à jour, échecs consécutifs), miroirs des jeux publics au lac (dernier chargement réussi, tranches chargées, en échec et en cours, lignes, période couverte quand les tranches sont datées), balayages des portails sur 7 jours (dernier balayage fini, annonces vues et insérées), collectes des signaux communaux (lignes captées, total de la source et écart) et étages de la chaîne quotidienne ; plus les compteurs de la table des adresses. Chaque source dit ses anomalies constatées (échec, retard au-delà de 36 heures, tranche en échec, écart à la source au-delà de 5 %) ; aucun message d'erreur interne n'est servi.

    Coût
    0 crédit par appel réussi
    Accès
    À l'usage ou avec l'abonnement Data
    Domaine
    Référentiels
    Paramètres et réponse
  • exports

    Fichiers complets des jeux

    Les éditions des fichiers complets que le contrat de l'organisation ouvre (jeux de son périmètre, droit d'export actif), plus les éditions communes : pour chacune, le jeu, la date d'édition, le format, la taille, le nombre de lignes, l'empreinte SHA-256, la présence du dictionnaire et de la fiche qualité, et le chemin de téléchargement. Seules les éditions dont la volumétrie a été contrôlée avant l'envoi sont listées. Réservé aux contrats ; REST seulement.

    Coût
    0 crédit par appel réussi
    Accès
    Sur contrat
    Domaine
    Exports
    Paramètres et réponse
  • exports_telecharger

    Téléchargement d'un fichier complet

    Redirige (302) vers le fichier d'une édition, son dictionnaire ou sa fiche qualité, par une adresse présignée valable 15 minutes. Chaque téléchargement est noté. Réservé aux contrats ; REST seulement.

    Coût
    0 crédit par appel réussi
    Accès
    Sur contrat
    Domaine
    Exports
    Paramètres et réponse
  • projets

    Projets du compte

    Les projets de l'utilisateur de la clé (achat, mandat de vente, location et gestion) : titre, étape, annonce suivie, adresse, faits, échéances, date de clôture et nombre de conversations du Hub rattachées. Les projets ouverts d'abord, puis les plus récemment modifiés.

    Coût
    0 crédit par appel réussi
    Accès
    À l'usage ou avec l'abonnement Data
    Domaine
    Hub et documents
    Paramètres et réponse
  • projets_creer

    Créer un projet

    Crée un projet dans le compte de l'utilisateur de la clé : type, titre, adresse en texte, annonce suivie. Une clé BAN donnée est rangée dans les faits du projet. Le Hub réinjecte le projet dans chaque conversation qui lui est rattachée.

    Coût
    0 crédit par appel réussi
    Accès
    À l'usage ou avec l'abonnement Data
    Domaine
    Hub et documents
    Paramètres et réponse
  • projets_lire

    Un projet et son contexte

    Un projet du compte avec son contexte : les derniers évènements datés de son fil, les textes longs rangés (modèles de courrier, textes de boîtage) et les conversations du Hub qui lui sont rattachées.

    Coût
    0 crédit par appel réussi
    Accès
    À l'usage ou avec l'abonnement Data
    Domaine
    Hub et documents
    Paramètres et réponse
  • projets_modifier

    Modifier ou clore un projet

    Modifie un projet du compte : titre, étape, adresse, faits (fusionnés, hors des clés réservées textes et urbanisme), échéances personnelles, clôture ou réouverture, et suivi d'un dépôt d'urbanisme (démarche revalidée et échéances calculées par le moteur du site, jamais reçues).

    Coût
    0 crédit par appel réussi
    Accès
    À l'usage ou avec l'abonnement Data
    Domaine
    Hub et documents
    Paramètres et réponse
  • projets_textes_ajouter

    Ranger un texte dans un projet

    Range un texte long dans un projet (modèle de courrier, texte de boîtage) : même préparation que le site, coordonnées remplacées par une mention, données sensibles refusées, dédoublonnage et plafond de textes par projet. Le Hub le réinjecte dans les conversations du projet.

    Coût
    0 crédit par appel réussi
    Accès
    À l'usage ou avec l'abonnement Data
    Domaine
    Hub et documents
    Paramètres et réponse
  • projets_textes_retirer

    Retirer un texte d'un projet

    Retire d'un projet le texte désigné par son empreinte. Retirer un texte absent ne change rien.

    Coût
    0 crédit par appel réussi
    Accès
    À l'usage ou avec l'abonnement Data
    Domaine
    Hub et documents
    Paramètres et réponse
  • briefs_programmes

    Requêtes programmées du compte

    Les questions programmées du compte : rythme, état actif ou en pause, erreurs consécutives (trois mettent la requête en pause), dernier et prochain passage.

    Coût
    0 crédit par appel réussi
    Accès
    À l'usage ou avec l'abonnement Data
    Domaine
    Hub et documents
    Paramètres et réponse
  • briefs_programmes_resultats

    Briefs rédigés

    Les briefs rédigés pour le compte par ses requêtes programmées, les plus récents d'abord : texte en Markdown, statut, jetons consommés. Le détail des outils appelés se lit par brief.

    Coût
    0 crédit par appel réussi
    Accès
    À l'usage ou avec l'abonnement Data
    Domaine
    Hub et documents
    Paramètres et réponse
  • briefs_programmes_resultat

    Un brief et ses résultats d'outils

    Un brief rédigé, avec le résultat structuré de chaque outil que l'agent du Hub a appelé pour l'écrire.

    Coût
    0 crédit par appel réussi
    Accès
    À l'usage ou avec l'abonnement Data
    Domaine
    Hub et documents
    Paramètres et réponse
  • profil_investisseur

    Profil investisseur du compte

    La thèse d'investissement de l'utilisateur de la clé, que le Hub, les briefs, les notifications et les recommandations réutilisent : stratégie, budgets et apport, zones, critères, objectifs, TMI, profil professionnel et préférences de notification.

    Coût
    0 crédit par appel réussi
    Accès
    À l'usage ou avec l'abonnement Data
    Domaine
    Compte et personnalisation
    Paramètres et réponse
  • profil_investisseur_modifier

    Modifier le profil investisseur

    Crée ou met à jour le profil investisseur de l'utilisateur de la clé, champ par champ : seuls les champs fournis changent, mêmes bornes que le formulaire du site. Rend le profil à jour.

    Coût
    0 crédit par appel réussi
    Accès
    À l'usage ou avec l'abonnement Data
    Domaine
    Compte et personnalisation
    Paramètres et réponse
  • favoris

    Favoris du compte

    Les biens suivis par l'utilisateur de la clé, les plus récents d'abord : le bien et son analyse à la date de l'ajout, complétés par l'annonce telle qu'elle est aujourd'hui (prix actuel, DPE, en ligne ou non).

    Coût
    0 crédit par appel réussi
    Accès
    À l'usage ou avec l'abonnement Data
    Domaine
    Compte et personnalisation
    Paramètres et réponse
  • favoris_ajouter

    Ajouter un favori

    Met une annonce du catalogue en favori, par son identifiant ou son lien : le bien et son analyse du jour sont gardés comme sur le site. Ajouter deux fois la même annonce rend le favori existant.

    Coût
    0 crédit par appel réussi
    Accès
    À l'usage ou avec l'abonnement Data
    Domaine
    Compte et personnalisation
    Paramètres et réponse
  • favoris_retirer

    Retirer un favori

    Retire un favori du compte. Retirer un favori absent ne change rien.

    Coût
    0 crédit par appel réussi
    Accès
    À l'usage ou avec l'abonnement Data
    Domaine
    Compte et personnalisation
    Paramètres et réponse
  • recommandations

    Annonces recommandées pour le compte

    Des annonces actives et analysées choisies pour l'utilisateur de la clé, avec les règles de la page du site : d'après les motifs de ses favoris (ville, type, budget et surface autour de leur moyenne), sinon d'après la stratégie de son profil investisseur, sinon les meilleurs scores du catalogue. Les motifs retenus sont rendus avec les annonces.

    Coût
    1 crédit par élément rendu
    Accès
    À l'usage ou avec l'abonnement Data
    Domaine
    Annonces
    Paramètres et réponse
  • notifications

    Notifications du compte

    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
    Domaine
    Flux d'évènements
    Paramètres et réponse
  • notifications_modifier

    Marquer une notification

    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
    Domaine
    Flux d'évènements
    Paramètres et réponse
Les prix et le barème des crédits