Aller au contenu

Proptechs et développeurs

Pillr Data pour les proptechs et les développeurs

L'API REST et le MCP de Pillr : une clé, des crédits, un contrat OpenAPI et un bac à sable. L'offre complète, la grille et la documentation sont sur la page de l'API. 500 crédits offerts à l'ouverture du compte, puis à l'usage.

Un premier appel

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

Marché d'une commune : 1 crédit par appel réussi. La réponse porte le bloc credits : crédits débités et crédits restants.

MCP, dans Claude Code
claude mcp add --transport http pillr https://pillr.fr/api/mcp \
  --header "Authorization: Bearer $PILLR_CLE"

Sans clé, la même adresse sert les 3 outils gratuits du connecteur public.

Les besoins, et ce qui y répond

Brancher une donnée dans un produit

Chaque opération répond en JSON, avec ses schémas publiés dans le contrat OpenAPI. Chaque réponse dit ce qu'elle a coûté, les crédits restants et la date de sa donnée ; une réponse inchangée revient sans débit.

Donner des outils à un assistant IA

La même adresse MCP sert sans clé les outils gratuits du connecteur public, et avec une clé les outils de l'API, au coût de l'appel REST jumeau. Claude Code ou un agent maison s'y branchent avec la clé en en-tête.

Tester sans débit

Une clé de test répond sans débit sur un jeu figé, pour les opérations qui ont un bac à sable ; le même code passe ensuite en production avec une clé de production.

Piloter sa consommation

Le tableau de bord réunit les clés, la consommation du mois par opération et le journal des appels. Une clé peut porter un plafond mensuel de crédits : atteint, ses appels sont refusés avec un code d'erreur stable.

Les limites

  • Une clé d'API ne donne accès ni au site ni au Hub.
  • Aucune réponse ne contient le nom, le téléphone ou l'adresse électronique d'un particulier.

Toutes les opérations servies

153 opérations dans 17 domaines, lues dans le catalogue de l'API. Contrat OpenAPI 3.1 : /api/v1/openapi.json.

Annonces

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
Outil MCP
annonce
Paramètres et réponse

Annonces

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
Outil MCP
annonce_lot
Paramètres et réponse

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
Outil MCP
rechercher_annonces
Paramètres et réponse

Annonces

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
Outil MCP
recherche_phrase
Paramètres et réponse

Annonces

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
Outil MCP
annonces_similaires
Paramètres et réponse

Annonces

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
Outil MCP
vie_annonce
Paramètres et réponse

Annonces

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
Outil MCP
bien
Paramètres et réponse

Annonces

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
Outil MCP
annonces_archives
Paramètres et réponse

Annonces

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
Outil MCP
annonces_carte
Paramètres et réponse

Annonces

É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
Outil MCP
ecart_marche
Paramètres et réponse

Annonces

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
Outil MCP
negociation
Paramètres et réponse

Annonces

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
Outil MCP
division
Paramètres et réponse

Annonces

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
Outil MCP
adresse_annonce
Paramètres et réponse

Annonces

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
Outil MCP
localiser_annonce
Paramètres et réponse

Annonces

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
Outil MCP
indices_photos
Paramètres et réponse

Annonces

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
Outil MCP
lieu_par_indice
Paramètres et réponse

Annonces

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
Outil MCP
street_view
Paramètres et réponse

Annonces

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
Outil MCP
analyse_immeuble
Paramètres et réponse

Annonces

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
Outil MCP
analyse_immeuble_calculer
Paramètres et réponse

Annonces

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
Outil MCP
audit_portefeuille
Paramètres et réponse

Annonces

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
Outil MCP
recommandations
Paramètres et réponse

Analyse des photos

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
Outil MCP
analyse_detaillee
Paramètres et réponse

Analyse des photos

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
Outil MCP
travaux_zone
Paramètres et réponse

Analyse des photos

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
Outil MCP
travaux_zone_lot
Paramètres et réponse

Compte et personnalisation

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
Outil MCP
valider_adresse
Paramètres et réponse

Compte et personnalisation

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
Outil MCP
memoire
Paramètres et réponse

Compte et personnalisation

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
Outil MCP
memoire_ajouter
Paramètres et réponse

Compte et personnalisation

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
Outil MCP
profil_investisseur
Paramètres et réponse

Compte et personnalisation

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
Outil MCP
profil_investisseur_modifier
Paramètres et réponse

Compte et personnalisation

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
Outil MCP
favoris
Paramètres et réponse

Compte et personnalisation

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
Outil MCP
favoris_ajouter
Paramètres et réponse

Compte et personnalisation

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
Outil MCP
favoris_retirer
Paramètres et réponse

Adresse et DPE

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
Outil MCP
resoudre_adresse
Paramètres et réponse

Adresse et DPE

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
Outil MCP
faits_adresse
Paramètres et réponse

Adresse et DPE

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
Outil MCP
histoire_adresse
Paramètres et réponse

Adresse et DPE

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
Outil MCP
annonces_adresse
Paramètres et réponse

Adresse et DPE

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
Outil MCP
parcelle
Paramètres et réponse

Adresse et DPE

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
Outil MCP
batiments
Paramètres et réponse

Adresse et DPE

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
Outil MCP
coproprietes
Paramètres et réponse

Adresse et DPE

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
Outil MCP
ventes_adresse
Paramètres et réponse

Adresse et DPE

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
Outil MCP
ventes
Paramètres et réponse

Adresse et DPE

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
Outil MCP
ventes_rue
Paramètres et réponse

Adresse et DPE

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
Outil MCP
dpe_adresse
Paramètres et réponse

Adresse et 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
Outil MCP
dpe
Paramètres et réponse

Adresse et DPE

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
Outil MCP
audits_energetiques
Paramètres et réponse

Adresse et DPE

É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
Outil MCP
sortie_passoire
Paramètres et réponse

Adresse et DPE

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
Outil MCP
permis_adresse
Paramètres et réponse

Adresse et DPE

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
Outil MCP
societes_civiles
Paramètres et réponse

Adresse et DPE

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
Outil MCP
lots_adresse
Paramètres et réponse

Marché des communes

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
Outil MCP
ventes_commune
Paramètres et réponse

Marché des communes

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
Outil MCP
secteur
Paramètres et réponse

Marché des communes

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
Outil MCP
marche_zone
Paramètres et réponse

Marché des communes

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
Outil MCP
synthese_zone
Paramètres et réponse

Marché des communes

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
Outil MCP
scores_commune
Paramètres et réponse

Marché des communes

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
Outil MCP
profil_commune
Paramètres et réponse

Marché des communes

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
Outil MCP
parc_commune
Paramètres et réponse

Marché des communes

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
Outil MCP
prix_commune
Paramètres et réponse

Marché des communes

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
Outil MCP
prix_iris
Paramètres et réponse

Marché des communes

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
Outil MCP
prix_territoire
Paramètres et réponse

Marché des communes

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
Outil MCP
vie_annonces_zone
Paramètres et réponse

Marché des communes

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
Outil MCP
signaux_commune
Paramètres et réponse

Marché des 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
Outil MCP
classement_communes
Paramètres et réponse

Marché des communes

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
Outil MCP
analyse_ia_zone
Paramètres et réponse

Marché des communes

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
Outil MCP
gentrification
Paramètres et réponse

Marché des communes

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
Outil MCP
geographie
Paramètres et réponse

Marché des communes

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
Outil MCP
tuiles_prix
Paramètres et réponse

Marché des communes

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
Outil MCP
referentiels
Paramètres et réponse

Marché des communes

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
Outil MCP
verdict_commune
Paramètres et réponse

Marché des 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
Outil MCP
comparer_communes
Paramètres et réponse

Marché des 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
Outil MCP
palmares_communes
Paramètres et réponse

Marché des communes

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
Outil MCP
avis_zone
Paramètres et réponse

Marché des communes

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
Outil MCP
avis_zone_publier
Paramètres et réponse

Marché des communes

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
Outil MCP
avis_zone_voter
Paramètres et réponse

Marché des communes

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
Outil MCP
loyer_marche
Paramètres et réponse

Marché des communes

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
Outil MCP
encadrement_loyers
Paramètres et réponse

Marché des communes

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
Outil MCP
zonage_logement
Paramètres et réponse

Marché des communes

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
Outil MCP
courte_duree_commune
Paramètres et réponse

Marché des communes

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
Outil MCP
risques_commune
Paramètres et réponse

Marché des communes

É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
Outil MCP
mesures_zone
Paramètres et réponse

Marché des communes

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
Outil MCP
prime_division
Paramètres et réponse

Marché des communes

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
Outil MCP
barometre
Paramètres et réponse

Marché des communes

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
Outil MCP
barometre_lot
Paramètres et réponse

Marché des communes

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
Outil MCP
dossier_barometre
Paramètres et réponse

Marché des communes

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
Outil MCP
constantes_reference
Paramètres et réponse

Pré-marché

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
Outil MCP
pre_marche_adresse
Paramètres et réponse

Pré-marché

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
Outil MCP
pre_marche_zone
Paramètres et réponse

Pré-marché

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
Outil MCP
radar_prospection
Paramètres et réponse

Pré-marché

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
Outil MCP
plan_prospection
Paramètres et réponse

Pré-marché

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
Outil MCP
alertes_zone_creer
Paramètres et réponse

Pré-marché

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
Outil MCP
alertes_pre_marche_creer
Paramètres et réponse

Pré-marché

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
Outil MCP
alertes
Paramètres et réponse

Pré-marché

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
Outil MCP
alertes_supprimer
Paramètres et réponse

Estimation

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
Outil MCP
estimer_bien_affine
Paramètres et réponse

Estimation

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
Outil MCP
terrain_reference
Paramètres et réponse

Estimation

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
Outil MCP
simuler_rendement
Paramètres et réponse

Estimation

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
Outil MCP
taux_credit
Paramètres et réponse

Estimation

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
Outil MCP
simuler_fiscalite
Paramètres et réponse

Estimation

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
Outil MCP
plus_value
Paramètres et réponse

Estimation

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
Outil MCP
estimer_courte_duree
Paramètres et réponse

Urbanisme

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
Outil MCP
taxe_amenagement
Paramètres et réponse

Urbanisme

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
Outil MCP
urbanisme_adresse
Paramètres et réponse

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
Outil MCP
documents_urbanisme
Paramètres et réponse

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
Outil MCP
objets_urbanisme
Paramètres et réponse

Urbanisme

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
Outil MCP
permis
Paramètres et réponse

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
Outil MCP
demarche_urbanisme
Paramètres et réponse

Urbanisme

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
Outil MCP
croquis_projet
Paramètres et réponse

Urbanisme

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
Outil MCP
coupes_facades
Paramètres et réponse

Urbanisme

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
Outil MCP
preparer_dossier
Paramètres et réponse

Urbanisme

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
Outil MCP
resultat_preparer_dossier
Paramètres et réponse

Urbanisme

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
Outil MCP
cerfa
Paramètres et réponse

Urbanisme

É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
Outil MCP
echeances_depot
Paramètres et réponse

Urbanisme

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
Outil MCP
rendu_aerien
Paramètres et réponse

Règlement du 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
Outil MCP
lire_plu
Paramètres et réponse

Règlement du 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
Outil MCP
resultat_lire_plu
Paramètres et réponse

Entreprises, agences et sociétés civiles

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
Outil MCP
agences_commune
Paramètres et réponse

Entreprises, agences et sociétés civiles

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
Outil MCP
agences
Paramètres et réponse

Entreprises, agences et sociétés civiles

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
Outil MCP
agents_immobiliers
Paramètres et réponse

Entreprises, agences et sociétés civiles

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
Outil MCP
entreprise
Paramètres et réponse

Référentiels

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
Outil MCP
modeles
Paramètres et réponse

Référentiels

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
Outil MCP
jeux
Paramètres et réponse

Référentiels

É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
Outil MCP
sources
Paramètres et réponse

Flux d'évènements

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
Outil MCP
flux_annonces
Paramètres et réponse

Flux d'évènements

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
Outil MCP
flux_adresses
Paramètres et réponse

Flux d'évènements

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
Outil MCP
veilles_creer
Paramètres et réponse

Flux d'évènements

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
Outil MCP
veilles
Paramètres et réponse

Flux d'évènements

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
Outil MCP
veilles_modifier
Paramètres et réponse

Flux d'évènements

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
Outil MCP
resultats_veilles
Paramètres et réponse

Flux d'évènements

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
Outil MCP
notifications
Paramètres et réponse

Flux d'évènements

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
Outil MCP
notifications_modifier
Paramètres et réponse

Webhooks

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
Outil MCP
webhooks_creer
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
Outil MCP
webhooks
Paramètres et réponse

Webhooks

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
Outil MCP
webhooks_supprimer
Paramètres et réponse

Webhooks

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
Outil MCP
webhooks_tester
Paramètres et réponse

Hub et documents

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
Outil MCP
question_hub
Paramètres et réponse

Hub et documents

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
Outil MCP
conversations_hub
Paramètres et réponse

Hub et documents

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
Outil MCP
conversations_hub_lire
Paramètres et réponse

Hub et documents

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
Outil MCP
conversations_hub_question
Paramètres et réponse

Hub et documents

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
Outil MCP
conversations_hub_modifier
Paramètres et réponse

Hub et documents

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
Outil MCP
projets
Paramètres et réponse

Hub et documents

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
Outil MCP
projets_creer
Paramètres et réponse

Hub et documents

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
Outil MCP
projets_lire
Paramètres et réponse

Hub et documents

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
Outil MCP
projets_modifier
Paramètres et réponse

Hub et documents

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
Outil MCP
projets_textes_ajouter
Paramètres et réponse

Hub et documents

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
Outil MCP
projets_textes_retirer
Paramètres et réponse

Hub et documents

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
Outil MCP
briefs_programmes
Paramètres et réponse

Hub et documents

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
Outil MCP
briefs_programmes_resultats
Paramètres et réponse

Hub et documents

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
Outil MCP
briefs_programmes_resultat
Paramètres et réponse

Documents

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
Outil MCP
generer_document
Paramètres et réponse

Documents

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
Outil MCP
lire_document
Paramètres et réponse

Jeux de données

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
Outil MCP
lire_jeu
Paramètres et réponse

Jeux de données

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
Outil MCP
agreger_jeu
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
Outil MCP
exports
Paramètres et réponse

Exports

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
Outil MCP
exports_telecharger
Paramètres et réponse

Créer une clé

500 crédits offerts à l'ouverture du compte, sans carte ; au-delà, à l'usage ou par l'abonnement Data. L'état de l'API et l'âge de chaque jeu de données servi sont publics.