Pillr Data
Le serveur MCP
Le serveur MCP de Pillr relie un assistant, comme Claude, ChatGPT ou Le Chat, ou un agent aux données de Pillr. Une seule adresse : sans clé, les outils gratuits ; avec une clé d'API, les outils de l'API en plus, au coût de l'appel REST jumeau.
L'adresse
https://pillr.fr/api/mcpEn lecture seule. Une clé, quand vous en passez une, va dans l'en-tête Authorization, sous la forme Bearer suivi de la clé : pk_live_ pour la production, pk_test_ pour le bac à sable, sans débit. Elle se lit dans une variable d'environnement (PILLR_CLE dans les exemples) et ne s'écrit jamais en clair dans une commande.
Connecter votre client
Avec une clé, il faut un client qui sache envoyer un en-tête fixe. La connexion par compte Pillr, qui ouvrirait les outils de l'API aux autres, n'existe pas encore. Les intitulés des menus sont ceux des éditeurs à ce jour ; ils peuvent changer.
- Claude CodeOutils gratuitsOutils de l'API avec une clé
- Claude DesktopOutils gratuitsOutils de l'API avec une clé
- claude.aiOutils gratuitsOutils de l'API : pas encore
- ChatGPTOutils gratuitsOutils de l'API : pas encore
- CursorOutils gratuitsOutils de l'API avec une clé
- Le ChatOutils gratuitsOutils de l'API avec une clé
- n8nOutils gratuitsOutils de l'API avec une clé
Claude Code
- Créez une clé dans le tableau de bord et gardez-la dans la variable
PILLR_CLE. - Ajoutez le serveur avec la commande ci-dessous ; sans clé, gardez seulement sa première ligne, sans la barre oblique finale.
- Dans Claude Code, la commande
/mcpliste le serveur et ses outils.
claude mcp add --transport http pillr https://pillr.fr/api/mcp \
--header "Authorization: Bearer $PILLR_CLE"Le shell remplace la variable avant d'exécuter la commande : Claude Code enregistre donc la clé, en clair, dans sa configuration sur votre machine. Gardez la portée par défaut ; la portée d'un projet (--scope project) l'écrirait dans le fichier .mcp.json du projet, souvent versionné.
Claude Desktop
- Sans clé : Réglages, puis Connecteurs, puis Ajouter un connecteur personnalisé, avec l'adresse du serveur, selon votre formule Claude.
- Avec une clé : ouvrez le fichier de configuration (Réglages, Développeur, Modifier la configuration) et ajoutez le serveur ci-dessous. Le pont
mcp-remotepasse l'en-tête ; il demande Node.js sur la machine. - Redémarrez Claude Desktop : les outils de Pillr apparaissent dans la liste des outils.
{
"mcpServers": {
"pillr": {
"command": "npx",
"args": [
"-y",
"mcp-remote",
"https://pillr.fr/api/mcp",
"--header",
"Authorization:${PILLR_AUTH}"
],
"env": {
"PILLR_AUTH": "Bearer pk_live_..."
}
}
}
}La clé est écrite dans ce fichier : gardez-le sur votre machine, hors de tout dépôt partagé.
claude.ai
- Réglages, puis Connecteurs, puis Ajouter un connecteur personnalisé, selon votre formule Claude.
- Donnez l'adresse du serveur, sans authentification : les outils gratuits sont aussitôt disponibles (le connecteur gratuit, pas à pas).
Un connecteur de claude.ai n'envoie pas d'en-tête fixe. La connexion par compte Pillr, qui y ouvrirait les outils de l'API sans en-tête, n'existe pas encore : avec ce client, seuls les outils gratuits répondent aujourd'hui.
ChatGPT
- L'application Pillr est publiée dans ChatGPT : ouvrez sa fiche et connectez-la, sans compte Pillr.
- Ou, en mode développeur, ajoutez un connecteur avec l'adresse du serveur, sans authentification.
Un connecteur de ChatGPT n'envoie pas d'en-tête fixe. La connexion par compte Pillr, qui y ouvrirait les outils de l'API sans en-tête, n'existe pas encore : avec ce client, seuls les outils gratuits répondent aujourd'hui.
Cursor
- Ajoutez le serveur à
~/.cursor/mcp.json(tous vos projets) ou à.cursor/mcp.json(un projet). Cursor lit la clé dans la variablePILLR_CLEde l'environnement où il est lancé. - Sans clé, retirez le bloc headers.
- Le serveur et ses outils apparaissent dans les réglages MCP de Cursor ; rechargez-le après une modification.
{
"mcpServers": {
"pillr": {
"url": "https://pillr.fr/api/mcp",
"headers": {
"Authorization": "Bearer ${env:PILLR_CLE}"
}
}
}
}Ne mettez jamais la clé en clair dans un .cursor/mcp.json versionné avec un projet.
Le Chat
- Dans Le Chat de Mistral AI, ouvrez les connecteurs, puis ajoutez un connecteur MCP personnalisé avec l'adresse du serveur (droits d'administrateur de l'espace requis).
- Sans clé : aucune authentification. Avec une clé : authentification par jeton d'API, en-tête
Authorization, typeBearer, et la clé en valeur.
n8n
- Dans un agent IA, ajoutez l'outil MCP Client avec l'adresse du serveur en point d'accès, transport HTTP Streamable.
- Avec une clé : authentification Bearer, avec la clé pour jeton (ou un en-tête
Authorizationde valeurBearer pk_...). - L'agent voit les outils de Pillr ; chaque appel payant est débité comme l'appel REST jumeau.
Sans clé
3 outils gratuits, sans compte : 60 appels d'outil par heure et par adresse IP. Ils rendent des données communales et des règles générales, jamais une annonce.
Prix au m² d'une commune
Le prix de référence au m² d'une commune, appartement et maison, avec sa provenance et son millésime.
prix_m2_commune
Synthèse de marché d'une commune
Un aperçu du marché d'une commune : prix, loyer médian et loyer par type de logement, rendement brut, évolutions sur 1 et 3 ans, tension locative, et le marché en vente du dernier mois.
marche_commune
Formalité d'urbanisme d'un projet
La formalité d'urbanisme d'un projet de travaux, son Cerfa, l'architecte, les pièces et le délai, chaque conclusion avec sa règle et sa source.
demarche_urbanisme_projet
Avec une clé d'API
Chaque outil payant est le jumeau d'une opération de l'API REST : même entrée, même JSON, même coût en crédits. Un appel réussi débite les crédits de l'organisation de la clé ; une clé pk_test_ ne sert que le jeu figé du bac à sable, sans débit. Avec une clé, les outils gratuits suivent le débit par minute de votre organisation, et ne débitent aucun crédit.
annonce
Annonce par lien ou identifiant
Fiche complète d'une annonce de vente analysée, retrouvée par son lien Leboncoin, BienIci ou SeLoger, ou par son identifiant : faits du bien et détails du portail (honoraires, taxe foncière, copropriété, équipements), vendeur professionnel nommé avec son enseigne, son SIREN et son mandat, photos et description, analyse complète (score et sous-scores, verdict, forces et faiblesses, leviers et cibles de négociation, loyer, rendements recalculés, budget, travaux par poste lus sur les photos, stratégie locative, régime fiscal), valeurs brutes du modèle à côté des valeurs recalculées, coût de sortie de passoire, échéance de location, historique des prix et diffusion en nombres. Données brutes du portail avec inclure=brut, pour un professionnel. Rien n'est débité si l'annonce est absente ou pas encore analysée.
- Coût
- 3 crédits par appel réussi
- Accès
- À l'usage ou avec l'abonnement Data
- Domaine
- Annonces
annonce_lot
Annonce par lien ou identifiant, en lot
Annonce par lien ou identifiant pour 100 éléments au plus en un appel : chaque élément est servi ou refusé seul, avec son code d'erreur, et seuls les éléments servis sont débités. Fiche complète d'une annonce de vente analysée, retrouvée par son lien Leboncoin, BienIci ou SeLoger, ou par son identifiant : faits du bien et détails du portail (honoraires, taxe foncière, copropriété, équipements), vendeur professionnel nommé avec son enseigne, son SIREN et son mandat, photos et description, analyse complète (score et sous-scores, verdict, forces et faiblesses, leviers et cibles de négociation, loyer, rendements recalculés, budget, travaux par poste lus sur les photos, stratégie locative, régime fiscal), valeurs brutes du modèle à côté des valeurs recalculées, coût de sortie de passoire, échéance de location, historique des prix et diffusion en nombres. Données brutes du portail avec inclure=brut, pour un professionnel. Rien n'est débité si l'annonce est absente ou pas encore analysée.
- Coût
- 3 crédits par élément rendu
- Accès
- À l'usage ou avec l'abonnement Data
- Domaine
- Annonces
rechercher_annonces
Recherche d'annonces analysées
Annonces de vente actives et analysées, par communes, codes postaux, départements ou autour d'un point, filtrées par type (appartement, maison, immeuble), prix, pièces, chambres, surface, prix au m², rendement brut ou net, score, DPE, passoires, état visuel, travaux, type de vendeur, SIREN ou enseigne de l'agence, mots-clés, date de parution, résidences gérées et règle « sous le marché ». Tri par rendement, score, état, date, prix, prix au m², distance ou opportunité (le radar du Hub : décote sur la commune, rendement, score, ancienneté). Chaque annonce porte son vendeur (professionnel nommé), sa diffusion multi-agences et ses drapeaux. Un crédit par annonce rendue.
- Coût
- 1 crédit par élément rendu
- Accès
- À l'usage ou avec l'abonnement Data
- Domaine
- Annonces
recherche_phrase
Recherche d'annonces en langage naturel
Une phrase libre (« T3 avec balcon sous 250 000 euros à Nantes ») traduite en filtres de rechercher_annonces, d'abord par le parseur de règles du site, sinon par un modèle de langage, puis exécutée comme rechercher_annonces : 12 annonces au plus, comprises dans le prix. La réponse dit les filtres retenus, ce qui a été ignoré et l'interprétation de la phrase. Les crédits sont rendus si la traduction échoue.
- Coût
- 15 crédits par appel réussi
- Accès
- À l'usage ou avec l'abonnement Data
- Domaine
- Annonces
annonces_similaires
Biens semblables à une annonce
Annonces actives et analysées proches d'une annonce de référence. Mode memes_criteres (défaut, outil du Hub) : même type, même commune, surface et prix à plus ou moins 20 %, classées par score. Mode proximite (fiche du site) : même code postal, surface et prix à plus ou moins 30 %, élargi à la commune (surface seule) quand il y a moins de quatre candidats, classées par une note qui mêle score, type, code postal, distance et écarts de prix et de surface. Une seule page. Un crédit par annonce rendue ; rien si la référence est absente.
- Coût
- 1 crédit par élément rendu
- Accès
- À l'usage ou avec l'abonnement Data
- Domaine
- Annonces
vie_annonce
Vie d'une annonce : prix, diffusion, fatigue vendeur
La vie d'une annonce en un appel : chaque variation de prix datée (doublons et corrections de prix mal lus signalés et écartés des calculs), baisse nette et cumulée, nombre de baisses et de hausses, plus forte baisse, prix en yo-yo, jours sur le marché et depuis la dernière baisse ; diffusion du même bien chez tous ses annonceurs, agences nommées avec leur SIREN quand il se rapproche, prix par agence, écart et agence la moins chère, première parution réelle ; parcours du bien étape par étape (annonceur, portails, début et fin, prix d'entrée et de sortie, mandat exclusif, republications) et date du passage en multi-mandat ; fatigue vendeur et republications. Un particulier n'est jamais nommé. Rien n'est débité si l'annonce est absente.
- Coût
- 2 crédits par appel réussi
- Accès
- À l'usage ou avec l'abonnement Data
- Domaine
- Annonces
bien
Bien dédoublonné et toutes ses annonces
Le bien unique derrière ses annonces, tous portails et toutes périodes confondus, par son identifiant ou par celui d'une de ses annonces : toutes les annonces rattachées, actives et retirées, avec leur vendeur (professionnel nommé) ; verdict et méthode du rattachement, servis tels quels, indécis compris ; clés d'identité et empreintes des photos ; agrégat (statut, agences, portails, republications, prix minimal, maximal et dernier) ; journal de certification des doublons. Rien n'est débité si le bien est inconnu.
- Coût
- 3 crédits par appel réussi
- Accès
- À l'usage ou avec l'abonnement Data
- Domaine
- Annonces
annonces_archives
Pige complète : annonces actives et retirées du lac
Toutes les annonces collectées par Pillr, actives et retirées, analysées ou non, avec les champs du portail et la vie de l'annonce (jours en ligne, baisses, republications, retrait) : par commune, code postal, département, point et rayon, ou SIREN d'agence, filtrées par type, prix, surface, dates de parution et de retrait, statut, portail, type de vendeur et baisse de prix. Le fonds pige et le fonds scraper_lbc servent les archives figées de l'ancienne pige et de l'ancien balayage Leboncoin, sans code INSEE, date de retrait ni statut actuel (un filtre qu'un fonds ne connaît pas est refusé sans débit).Un vendeur professionnel est servi en entier ; un particulier jamais par son nom ni ses coordonnées. Lecture lourde : servie depuis la mémoire seulement entre 20h30 et minuit. Un crédit par annonce rendue.
- Coût
- 1 crédit par élément rendu
- Accès
- À l'usage ou avec l'abonnement Data
- Domaine
- Annonces
annonces_carte
Annonces dans une emprise de carte
Les points des annonces actives et analysées dans une emprise de carte (sud, ouest, nord, est ; 3 degrés de côté au plus), filtrables par communes, départements, mots-clés, type, type de vendeur, DPE, travaux et règle « sous le marché » (rendement brut d'au moins 7 % et score d'au moins 70, comme la carte du site). Chaque point porte sa position et sa précision, son prix, sa surface, son score, son rendement et son identifiant. Les mieux notés d'abord, 1 000 points par page au plus.
- Coût
- 1 crédit par tranche de 10 lignes rendues
- Accès
- À l'usage ou avec l'abonnement Data
- Domaine
- Annonces
analyse_detaillee
Lecture photo par photo et rapport complet
Ce que le moteur d'analyse de Pillr a produit sur une annonce analysée, en deux volets. Volet photos : chaque photo lue (pièce, état sur 100, défauts, observations, travaux déduits, exploitable ou motif du rejet), travaux groupés par poste et chiffrés par le barème déterministe avec leurs photos sources, postes écartés et leur motif, défauts par gravité, pièces vues et manquantes, plancher énergétique, score de qualité de l'annonce. Volet rapport, celui de la page d'analyse : plan financier avec crédit, notation sur six axes, anomalies du moteur de règles, analyse rédigée (forces, points d'attention, verdict, confiance) et photo du marché communal. Avec des photos de catalogue, l'état visuel n'est pas servi et la lecture le dit. Rien n'est débité si l'annonce est absente ou pas encore analysée.
- Coût
- 5 crédits par appel réussi
- Accès
- À l'usage ou avec l'abonnement Data
- Domaine
- Analyse des photos
ecart_marche
Écart au marché, anomalies et ventes du rayon
Écart du prix au m² d'une annonce analysée au prix de référence Pillr de sa commune (le chiffre de la fiche, calculé par le même module canonique), avec le signal du modèle prédictif, les anomalies annonce contre marché du moteur de règles, les données de l'analyse (travaux, rendements, loyer, score, profil), les cibles et leviers de négociation, et toutes les ventes DVF du rayon une par une, reconstituées à la mutation entière, avec leurs agrégats par type et par année. Aucun seuil ne masque : chaque agrégat porte son nombre de ventes, chaque vente atypique son drapeau. Rien n'est débité si l'annonce est absente.
- Coût
- 3 crédits par appel réussi
- Accès
- À l'usage ou avec l'abonnement Data
- Domaine
- Annonces
negociation
Recommandation de négociation et lettre d'offre
Recommandation de négociation et lettre de proposition d'achat pour une annonce analysée : prix proposé (le vôtre, ou le prix demandé moins les travaux estimés et une marge de négociation, borné, comme sur la fiche), cibles et leviers relevés par l'analyse, vie de l'annonce (jours en ligne, baisses de prix), écart au prix de référence de la commune, puis arguments et lettre rédigés par l'IA à partir de ce seul contexte, au ton et au destinataire choisis. Un appel à un modèle Gemini par appel. Rien n'est débité si l'annonce est absente ou si l'IA ne rend rien d'exploitable.
- Coût
- 20 crédits par appel réussi
- Accès
- À l'usage ou avec l'abonnement Data
- Domaine
- Annonces
division
Potentiel de division d'un bien
Potentiel de division d'une annonce analysée, par la règle du Hub : la parcelle cadastrale du point de l'annonce (contenance, section, numéro, lue en direct à l'API Carto de l'IGN) croisée avec la surface habitable, le terrain déclaré, le prix au m² face au prix de référence de la commune et la demande locative. Rend un verdict (faible, modéré ou élevé) et ses signaux. Le point d'une annonce est souvent approché : la parcelle est celle du point servi, avec sa précision. Rien n'est débité si l'annonce est absente.
- Coût
- 3 crédits par appel réussi
- Accès
- À l'usage ou avec l'abonnement Data
- Domaine
- Annonces
adresse_annonce
Adresse retrouvée d'une annonce
Adresse retrouvée d'une annonce floutée, de trois façons, chacune avec sa qualité : l'adresse résolue par le croisement de sources indépendantes dans le disque de flou (ventes DVF, DPE, copropriétés, parcelles), avec sa confiance, sa méthode, la distance entre les sources et la clé BAN quand la Base Adresse Nationale la retrouve au numéro ; les adresses que désigne l'empreinte du DPE affiché (numéro de DPE, clé BAN, écart de surface), ambiguë quand elle en désigne plusieurs ; l'adresse validée par un utilisateur de Pillr. La résolution n'est pas relancée à l'appel : elle date du dernier passage du résolveur (resolue_le). Rien n'est débité si aucune des trois n'existe.
- Coût
- 5 crédits par appel réussi
- Accès
- À l'usage ou avec l'abonnement Data
- Domaine
- Annonces
localiser_annonce
Localisation pas à pas (étapes déterministes)
Étapes déterministes de la localisation d'une annonce floutée, une par appel (etape), celles de l'outil du Hub : disque (centre et rayon du flou du portail, adresse BAN du centre, précision honnête des coordonnées, immeuble annoncé, adresse validée) ; dpe (DPE du miroir ADEME dans le disque, à la même étiquette, à la surface près et du même type, repli sur l'API de l'ADEME) ; dvf (ventes DVF de 2018 à 2025 du même type à 3 % de surface près, adresse retrouvée par la BAN) ; copro (copropriétés du registre national au nombre de lots annoncé) ; parcelle (maisons : parcelles du cadastre IGN à la contenance du terrain annoncé) ; batiments (bâtiments BD TOPO du disque, compatibles d'abord avec l'étage annoncé) ; geocoder (saisie q géocodée par la Base Adresse Nationale, au code postal de l'annonce ou à code_postal, et contrôlée contre le flou). Les candidats sont croisés avec les disques des rediffusions du même bien sur d'autres portails. tolerance règle l'étape : surface en m² pour dpe (1 à 15), lots pour copro (1 à 8), contenance en % pour parcelle (1 à 30). Street View, Google Maps et l'image aérienne ne sont donnés qu'en lien. Rien n'est débité quand l'annonce ne permet pas l'étape (sans étiquette DPE, sans surface, sans position, hors copropriété, sans terrain).
- Coût
- 5 crédits par appel réussi
- Accès
- À l'usage ou avec l'abonnement Data
- Domaine
- Annonces
indices_photos
Indices de localisation lus sur les photos
Lecture par vision (Gemini) des 4 premières photos et de la description d'une annonce : noms de rue, enseignes, numéros de voirie, monuments, lieux cités, vue depuis les fenêtres, quartier et indice le plus fort. Seuls des indices lus sont rendus, jamais devinés : un indice se géocode ensuite par localiser_annonce (etape geocoder) ou lieu_par_indice. Les photos sont lues sur les serveurs des portails ; la description d'un particulier est passée au modèle sans ses coordonnées.
- Coût
- 20 crédits par appel réussi
- Accès
- À l'usage ou avec l'abonnement Data
- Domaine
- Annonces
lieu_par_indice
Lieu réel d'un indice par Google Maps
Résout un indice de localisation (enseigne, repère, ligne de tram) en lieu réel par Gemini avec l'outil Google Maps, biaisé sur le centre du flou de l'annonce (sinon sur lat et lon, sinon sur sa position affichée) pour écarter les homonymes lointains : la réponse du modèle et 5 lieux Google Maps au plus. Le lieu trouvé se contrôle ensuite par localiser_annonce (etape geocoder), qui dit s'il tombe dans le disque. Résultat soumis aux conditions de Google Maps Platform : jamais gardé en mémoire par Pillr, la source est citée.
- Coût
- 40 crédits par appel réussi
- Accès
- À l'usage ou avec l'abonnement Data
- Domaine
- Annonces
street_view
Comparaison de façade avec Street View
Compare par vision (Gemini) la façade des 4 premières photos de l'annonce aux images Google Street View de 1 à 3 adresses candidates, en une seule passe : verdict (oui, non, incertain), confiance, raison et classement des candidats. Un candidat sans couverture Street View n'est pas comparé ni payé. Les images Street View ne sont jamais servies ni gardées : seul un lien l'est. Rien n'est débité sans photo d'annonce, sans couverture ou si le service est coupé.
- Coût
- 40 crédits par appel réussi
- Accès
- À l'usage ou avec l'abonnement Data
- Domaine
- Annonces
valider_adresse
Enregistrer l'adresse validée d'une annonce
Enregistre l'adresse que l'utilisateur de la clé a confirmée pour une annonce, dans le cache partagé des localisations de Pillr : une adresse par annonce, la dernière validation remplace la précédente. Elle est ensuite rendue par adresse_annonce et par localiser_annonce (etape disque), et le Hub la lit aussi. Exige une clé rattachée à un compte Pillr.
- Coût
- 0 crédit par appel réussi
- Accès
- À l'usage ou avec l'abonnement Data
- Domaine
- Compte et personnalisation
resoudre_adresse
Résoudre une adresse ou un point
Géocodage par la Base Adresse Nationale d'une adresse en texte (avec son code postal pour départager) ou d'un point (géocodage inverse, du plus proche au plus lointain). Chaque candidat porte sa clé BAN, son numéro, sa voie, sa commune et son ancienne commune, sa position, son score ou sa distance, et pour un numéro le type de position, les parcelles cadastrales et la certification lus dans la copie de la BAN de Pillr. La clé BAN d'un numéro sert aux autres opérations du domaine.
- Coût
- 0 crédit par appel réussi
- Accès
- À l'usage ou avec l'abonnement Data
- Domaine
- Adresse et DPE
faits_adresse
Faits complets d'une adresse
La ligne complète d'une adresse BAN dans la table d'adresses de Pillr, en groupes : identité (parcelles, îlot, position), bâtiment, DPE détaillé (chauffage, isolation, ventilation, méthode, numéro, historique daté), audit, ventes DVF au numéro avec leur historique, îlot (ventes sur 5 ans, médiane au m² et son nombre de ventes, annonces actives, copropriétés), copropriété, autorisations d'urbanisme avec leur historique, sociétés civiles nommées avec leur SIREN, mise en vente (annonce rattachée, confiance et méthode), contexte de la commune et variables du pré-marché. Le paramètre champs choisit des groupes ou des colonnes. Un seul DPE par adresse : le plus récent.
- Coût
- 5 crédits par appel réussi
- Accès
- À l'usage ou avec l'abonnement Data
- Domaine
- Adresse et DPE
histoire_adresse
Histoire datée d'une adresse
La frise datée et sourcée d'une adresse, par sa clé BAN, l'adresse en texte ou un point : construction déclarée, DPE depuis 2013 et audits énergétiques, autorisations d'urbanisme depuis 2013 (demandeur personne morale nommé), ventes DVF depuis 2018 au numéro, à la parcelle ou par position, copropriété (syndic professionnel nommé), sociétés civiles domiciliées nommées avec leur SIREN, annonces passées et baisses de prix avec l'agence nommée, catastrophes naturelles de la commune depuis 1982 (Géorisques). Chaque évènement dit son rattachement (adresse, parcelle, immeuble, position ou commune) et chaque source son état. Le même moteur que l'outil Historimmo du Hub ; le nombre d'évènements est plafonné, la construction et la première vente toujours gardées.
- Coût
- 10 crédits par appel réussi
- Accès
- À l'usage ou avec l'abonnement Data
- Domaine
- Adresse et DPE
annonces_adresse
Annonces vues à une adresse
Toutes les annonces de vente rattachées à une adresse BAN, actives et passées : l'annonce concordante (dé-floutée par croisement), l'annonce reconnue par l'empreinte de l'adresse, les annonces reconnues par l'empreinte d'un DPE de l'adresse et celles dont l'adresse résolue tombe à moins de 25 m. Pour chacune : portail, prix, surface, type de vendeur, agence nommée avec son SIREN pour un professionnel, dates de parution et de retrait, baisses de prix, méthode et confiance du rattachement. La réponse dit aussi si l'adresse est en vente et depuis quand. Rien n'est débité quand aucune annonce n'est rattachée à l'adresse.
- Coût
- 3 crédits par appel réussi
- Accès
- À l'usage ou avec l'abonnement Data
- Domaine
- Adresse et DPE
parcelle
Parcelle cadastrale et ce qui s'y rattache
Une parcelle cadastrale, par son identifiant à 14 caractères ou par la clé BAN d'une adresse : contenance, section, numéro et géométrie (API Carto de l'IGN, en direct), adresses BAN rattachées, ventes DVF de la parcelle, autorisations d'urbanisme Sitadel qui la citent (demandeur personne morale nommé), copropriétés qui la citent et zone du document d'urbanisme à son point intérieur. Par une clé BAN, la parcelle servie est la première de l'adresse, ou celle qui contient le numéro, et la réponse liste les autres.
- Coût
- 3 crédits par appel réussi
- Accès
- À l'usage ou avec l'abonnement Data
- Domaine
- Adresse et DPE
batiments
Bâtiments autour d'un point ou sur une parcelle
Les bâtiments de la BD TOPO de l'IGN (service WFS de la Géoplateforme, en direct) autour d'un point, dans un rayon de 200 m au plus (50 m par défaut), ou sur une parcelle cadastrale : niveaux (estimés sur la hauteur quand la BD TOPO ne les donne pas, et la réponse le dit), hauteur, usage, nature, nombre de logements, emprise au sol et adresse BAN la plus proche. Avec un étage, chaque bâtiment dit s'il compte assez de niveaux.
- Coût
- 2 crédits par appel réussi
- Accès
- À l'usage ou avec l'abonnement Data
- Domaine
- Adresse et DPE
coproprietes
Copropriétés du Registre national
Les copropriétés immatriculées au Registre national des copropriétés, par numéro d'immatriculation, par la clé BAN d'une adresse (immatriculation portée par le DPE, sinon parcelle commune, sinon position à 30 m au plus), ou par filtres (commune, code postal, ou point et rayon, puis nombre de lots, type de syndic, copropriété aidée) : adresse et nom d'usage, lots (total, habitation, stationnement), période de construction, syndic professionnel nommé (raison sociale, SIRET, APE), mandat en cours et fin du dernier mandat, parcelles, dispositifs publics et aide. Le représentant d'un syndic bénévole n'est jamais servi. L'agrégat de la commune accompagne la liste.
- Coût
- 1 crédit par élément rendu
- Accès
- À l'usage ou avec l'abonnement Data
- Domaine
- Adresse et DPE
ventes_adresse
DVF à l'adresse : toutes les mutations
Toutes les mutations DVF enregistrées à une adresse de la Base Adresse Nationale (par sa clé), ou à une parcelle cadastrale, regroupées par mutation. Les ventes de 2021 et suivantes sont lues au numéro (code de voie et numéro DVF), sinon aux parcelles de l'adresse ; celles de 2018 à 2020, dont le fichier n'a ni adresse ni parcelle, sont rapprochées par position autour du numéro. Pour chaque mutation : date, nature, valeur foncière, adresse DVF, locaux (type, surface bâtie, pièces, lots et surfaces Carrez), terrains, parcelles, volumes, position. Le prix au m² est recalculé à la mutation sur la surface de ses logements, avec sa qualité : vente en bloc, dépendance, local professionnel, prix atypique et son motif, rattachement incertain. Aucune vente : 404 ressource_absente, rien n'est débité. L'Alsace-Moselle (livre foncier) n'est pas dans DVF.
- Coût
- 5 crédits par appel réussi
- Accès
- À l'usage ou avec l'abonnement Data
- Domaine
- Adresse et DPE
ventes
Ventes DVF autour d'un point, dans une commune ou par mutation
Les mutations DVF une par une, avec toutes leurs lignes, leur adresse DVF, leurs lots, leurs parcelles et leur position : autour d'un point (rayon de 2000 m au plus), dans une commune (l'arrondissement à Paris, Lyon et Marseille), ou par identifiant de mutation. Filtres : type de local, nature de la mutation, période, surface des logements, valeur foncière. Tri par date (le plus récent d'abord) ou par distance. Le prix au m² est recalculé à la mutation sur la surface de ses logements, avec sa qualité (vente en bloc, prix atypique et son motif). Les filtres de surface et de valeur s'appliquent après lecture : une page peut compter moins de mutations que la limite, curseur_suivant dit s'il en reste. Ventes de 2021 et suivantes ; les lignes d'une mutation situées dans une autre commune ne sont pas relues.
- Coût
- 1 crédit par élément rendu
- Accès
- À l'usage ou avec l'abonnement Data
- Domaine
- Adresse et DPE
ventes_rue
Ventes d'une rue ou d'une commune
Les ventes DVF d'une rue (par son nom géocodé dans la Base Adresse Nationale, ou par son code de voie) ou d'une commune (l'arrondissement à Paris, Lyon et Marseille), lues à la vente entière : une vente d'un seul logement, hors local professionnel et vente en bloc, comme le barème Pillr. Par type de bien, sur la période entière puis année par année : nombre de ventes, médiane, quartiles dès 2 ventes, minimum, maximum, surface médiane, dernière vente, sans seuil de publication. Les ventes au prix atypique sont écartées des agrégats et comptées. À la voie, chaque vente est listée avec son numéro et sa qualité. Le prix de référence de la commune est le barème Pillr, le même que les pages communes. Mêmes calculs que l'outil ventes_rue du Hub.
- Coût
- 5 crédits par appel réussi
- Accès
- À l'usage ou avec l'abonnement Data
- Domaine
- Adresse et DPE
ventes_commune
Volumes et prix des ventes d'une commune
Les volumes et les prix des ventes DVF d'une commune, par son code INSEE ou par un code postal (la commune la plus peuplée du code postal) : ventes par trimestre (total, appartements, maisons) et médiane au m² ; série annuelle du prix au m² (appartement, maison, ensemble) avec transactions, minimum, maximum et drapeaux de basse confiance ; vélocité au code postal, année par année, évolution du volume et sa lecture, comme l'outil de vélocité du Hub. La vélocité compte des lignes DVF d'appartements et de maisons (une par lot), pas des mutations. Chaque valeur porte son nombre d'observations.
- Coût
- 2 crédits par appel réussi
- Accès
- À l'usage ou avec l'abonnement Data
- Domaine
- Marché des communes
dpe_adresse
Tous les DPE d'une adresse, logement par logement
Tous les DPE d'une adresse de la Base Adresse Nationale, logement par logement : numéro, dates, étiquettes énergie et GES, consommation et émissions, surface, type, étage et complément d'adresse, méthode, fin de validité, DPE remplacé, échéance d'interdiction de louer. Sources : DPE de logements existants et neufs et DPE tertiaires portant la clé BAN, DPE d'avant juillet 2021 rapprochés par position (30 m au plus). S'y ajoutent l'historique des étiquettes de l'adresse, ses audits énergétiques (classe visée, coût maximal) et la répartition des DPE de sa commune. Aucun DPE, aucun audit ni aucun historique : 404 ressource_absente, rien n'est débité.
- Coût
- 3 crédits par appel réussi
- Accès
- À l'usage ou avec l'abonnement Data
- Domaine
- Adresse et DPE
dpe
Un DPE par son numéro, ou les DPE d'un disque ou d'une commune
Un DPE par son numéro (logement existant ou neuf, tertiaire, ou d'avant juillet 2021) avec toutes ses colonnes ADEME : étiquettes, consommations et émissions par usage et par énergie, coûts, déperditions, isolation, chauffage, eau chaude, ventilation, copropriété, identifiant RNB. Ou les DPE de logements existants autour d'un point (2000 m au plus, le plus proche d'abord) ou dans une commune (le plus récent d'abord), filtrés par étiquette, GES, surface, type de bâtiment et date : le DPE inversé. Les annonces dont l'empreinte concorde avec le DPE sont jointes. Le paramètre champs réduit chaque DPE aux champs demandés.
- Coût
- 1 crédit par élément rendu
- Accès
- À l'usage ou avec l'abonnement Data
- Domaine
- Adresse et DPE
audits_energetiques
Audits énergétiques et leurs scénarios
Les audits énergétiques réglementaires de l'ADEME, par numéro d'audit ou à une adresse de la Base Adresse Nationale, avec tous leurs scénarios et leurs étapes de travaux : classe atteinte, consommation, coût de l'étape et coût cumulé, gains de facture et de consommation, travaux décrits par l'auditeur. Ce sont des estimations d'auditeur, pas des devis. Aucun audit : 404 ressource_absente, rien n'est débité.
- Coût
- 3 crédits par élément rendu
- Accès
- À l'usage ou avec l'abonnement Data
- Domaine
- Adresse et DPE
sortie_passoire
Échéance de location et coût de sortie de passoire
L'échéance d'interdiction de louer d'un logement selon son étiquette (calendrier de la loi Climat et résilience en métropole : G 2025, F 2028, E 2034) et les mois restants. Pour une étiquette E, F ou G, le coût pour atteindre D, C ou B, mesuré sur les audits énergétiques ADEME de logements comparables (type, zone climatique, période de construction) : médiane et quartiles, euros par m², coût à la surface du bien, part des audits qui dépassent la cible, finesse de la cellule retenue. Une estimation d'auditeur, pas un devis. Métropole seulement : le calendrier des outre-mer n'est pas servi.
- Coût
- 1 crédit par appel réussi
- Accès
- À l'usage ou avec l'abonnement Data
- Domaine
- Adresse et DPE
pre_marche_adresse
Pré-marché d'une adresse
Pour une adresse (clé BAN), la probabilité calibrée qu'une vente DVF y soit enregistrée dans les 12 mois, calculée à la lecture comme dans le Hub : indice des coefficients mesurés, bande de calibration et son taux de vente réel, lift, fenêtre de mandat et priorité, fiabilité (mesure sur les maisons positionnées, indicatif ailleurs), raisons chiffrées, coefficients retenus, faits datés au jour du DPE, frise des évènements de l'adresse (DPE, audit, ventes, sociétés civiles, permis, copropriété, annonce) et sociétés civiles domiciliées, nommées avec leur SIREN quand le BODACC le rattache. Hors du périmètre calibré (Alsace-Moselle notamment), la raison est servie à la place du calcul.
- Coût
- 10 crédits par appel réussi
- Accès
- À l'usage ou avec l'abonnement Data
- Domaine
- Pré-marché
pre_marche_zone
Adresses à prospecter d'un secteur
Les adresses d'un secteur (une commune, une liste de communes, une intercommunalité, un code postal ou un cercle) dont le DPE a moins de 24 mois, classées par priorité de prospection : la probabilité calibrée de vente DVF à 12 mois multipliée par la fenêtre de mandat. La réponse comprend le comptage du secteur, la précision mesurée, puis pour chaque adresse ses raisons, sa frise, l'annonce et l'agence quand elle est déjà en vente, ses sociétés civiles nommées, sa dernière vente, sa copropriété et son nombre de logements, et le total des logements pour un boîtage. Les adresses déjà en vente ou vendues depuis le DPE sont exclues, sauf demande.
- Coût
- 10 crédits par élément rendu
- Accès
- À l'usage ou avec l'abonnement Data
- Domaine
- Pré-marché
secteur
Mon secteur en 30 secondes
Pour un code postal, les deux signaux de la page « Mon secteur » de pillr.fr : les adresses en pré-marché pur (DPE individuel de moins de 90 jours, ni en vente ni vendues depuis, dont les passoires F et G), et les particuliers qui vendent seuls depuis plus de 50 jours et sont encore en ligne, dont ceux qui ont baissé leur prix ; avec detail=true, la liste de leurs annonces, sans le nom ni les coordonnées du vendeur. Sans annonce de particulier dans le code postal, le compte passe au département et le dit.
- Coût
- 2 crédits par appel réussi
- Accès
- À l'usage ou avec l'abonnement Data
- Domaine
- Marché des communes
estimer_bien_affine
Estimation affinée par IA
La même estimation qu'estimer_bien (même moteur, même sortie), affinée par un modèle de langage à partir de l'état, des qualités, de la description, de l'exposition, des annexes, des équipements et de photos lues sur des liens https publics (JPEG, PNG ou WebP). Rend en plus la liste unique des ajustements, chacun avec sa nature, son pourcentage, son motif et sa source (barème ou IA, chaque ligne IA vérifiée par le serveur), l'état de l'affinage et la lecture des photos. Les photos sont lues le temps de l'appel, jamais écrites ni renvoyées. Une panne de l'IA rend l'estimation déterministe, et le dit.
- Coût
- 30 crédits par appel réussi
- Accès
- À l'usage ou avec l'abonnement Data
- Domaine
- Estimation
terrain_reference
Terrain de référence d'une maison
La surface de terrain médiane d'une maison vendue dans le département, pour le type de commune (groupe déduit du zonage ABC et de la population), telle que le moteur d'estimation la retient : c'est le terrain que le prix du secteur porte déjà. Le niveau dit si la cellule département et groupe est mesurée ou si la médiane nationale du groupe sert de repli. Par commune (code INSEE), ou par département avec le groupe.
- Coût
- 1 crédit par appel réussi
- Accès
- À l'usage ou avec l'abonnement Data
- Domaine
- Estimation
marche_zone
Marché d'une commune
Marché immobilier d'une commune ou d'un arrondissement, par code INSEE : prix de référence au m² des appartements et des maisons avec leur provenance (mesuré sur les ventes DVF ou estimé) et le nombre de ventes, loyer d'annonce au m² et loyers par type de logement (Carte des loyers), rendement brut théorique, évolution des prix sur 1 et 3 ans, zone ABC, et le marché en vente du dernier mois calculé (annonces en ligne, nouvelles annonces, prix affiché médian, part des baisses, délai médian en ligne). Mêmes chiffres que les pages communes de pillr.fr. Paris, Lyon et Marseille sont servies en agrégat de leurs arrondissements.
- Coût
- 1 crédit par appel réussi
- Accès
- À l'usage ou avec l'abonnement Data
- Domaine
- Marché des communes
synthese_zone
Synthèse complète d'une commune
Une commune en un appel, avec les chiffres de l'outil de zone du Hub : marché (prix et provenance, rendements, demande, vacance, loyer, évolutions, passoires, transactions), démographie, moyennes des annonces analysées par Pillr dans la commune, score Pillr et ses huit sous-scores, marchabilité et équipements à 500 m, loyer prédit avec son intervalle à 95 %, loyers par typologie et loyer d'un logement donné (typologie, surface), mesures de zone (équipements, gare et aéroport, délinquance, risques), signal de prix, QPV et zone ABC, ratios d'accessibilité, courte durée, points forts et signaux d'alerte de l'analyse rédigée, marché en vente du dernier mois. Paris, Lyon et Marseille se lisent par arrondissement.
- Coût
- 3 crédits par appel réussi
- Accès
- À l'usage ou avec l'abonnement Data
- Domaine
- Marché des communes
scores_commune
Score Pillr et scores d'une commune
Scores d'une commune tels que le pipeline de Pillr les publie : score Pillr sur 100 et ses huit sous-scores (rentabilité, demande, liquidité, croissance, stabilité, qualité, services, sécurité), scores d'attractivité, de location longue et courte durée, de tourisme et de démographie, z-scores et percentiles des prix, du rendement et des loyers, volatilité, prix attendu par le modèle départemental et écart au prix observé, ratios d'accessibilité. Un sous-score de rentabilité posé par défaut faute de rendement mesuré est signalé. Paris, Lyon et Marseille se lisent par arrondissement.
- Coût
- 2 crédits par appel réussi
- Accès
- À l'usage ou avec l'abonnement Data
- Domaine
- Marché des communes
profil_commune
Profil socio-démographique et politique
Profil d'une commune, chaque bloc lu dans sa source publique et servi avec sa qualité : population et codes postaux (recensement), âge moyen, chômage et part de HLM, revenus par unité de consommation, déciles 1 et 9, pauvreté et indice de Gini (Filosofi), quartiers prioritaires (nombre et codes), indice de position sociale des lycées, premier tour de la présidentielle 2022 (orientation, candidat en tête, parts par bloc, abstention). Un bloc absent de sa source est servi vide, avec n = 0.
- Coût
- 2 crédits par appel réussi
- Accès
- À l'usage ou avec l'abonnement Data
- Domaine
- Marché des communes
parc_commune
Parc de logements d'une commune
Parc de logements d'une commune, chaque bloc depuis sa source : résidences principales, secondaires et vacantes, propriétaires et locataires (recensement) ; vacance du parc privé par année, dont plus de deux ans (LOVAC) ; diagnostics de performance énergétique par étiquette, part de passoires et série mensuelle des DPE et des audits (ADEME) ; copropriétés, lots, sans mandat, aidées, en plan de sauvegarde, gérées par un syndic bénévole, en nombre (RNC) ; autorisations et logements créés par mois, permis sur 12 et 24 mois (Sitadel). Les séries partent du mois demandé.
- Coût
- 2 crédits par appel réussi
- Accès
- À l'usage ou avec l'abonnement Data
- Domaine
- Marché des communes
prix_commune
Prix au m² d'une commune : barème, série, évolutions
Prix de référence au m² d'une commune par type de bien, avec toute sa qualité : provenance (mesuré ou estimé), ventes et ventes récentes, communes voisines et ventes du bassin, poids local, dominance, demi-bande d'incertitude, prix local brut. Rien n'est masqué : un prix sur peu de ventes est servi avec son nombre et son drapeau. S'y ajoutent la série annuelle (prix, transactions, minimum, maximum, basse confiance), les évolutions sur 1, 3 et 5 ans avec leur confiance et celle du département, l'indice annuel du département et la ligne indexée (barème multiplié par l'indice). Paris, Lyon et Marseille se lisent par arrondissement.
- Coût
- 2 crédits par appel réussi
- Accès
- À l'usage ou avec l'abonnement Data
- Domaine
- Marché des communes
prix_iris
Prix au m² par quartier IRIS
Prix au m² des appartements et des maisons par quartier IRIS, avec le nombre de ventes, la provenance (mesuré au quartier ou estimé depuis le prix de la commune), le poids local, la demi-bande d'incertitude, le nom du quartier et, sur demande, son contour GeoJSON. Un quartier par son code IRIS, ou tous les quartiers d'une commune. Tous les quartiers sont servis, ceux à peu de ventes avec leur drapeau.
- Coût
- 1 crédit par élément rendu
- Accès
- À l'usage ou avec l'abonnement Data
- Domaine
- Marché des communes
prix_territoire
Prix d'un département ou d'une région
Prix médians au m² des appartements et des maisons d'un département ou d'une région, ceux de la carte des prix de Pillr, avec la surface médiane, la population et le nombre de communes, l'emprise, l'indice annuel par type et les coefficients semestriels du barème. Une région se donne par son code INSEE ou son nom court.
- Coût
- 1 crédit par appel réussi
- Accès
- À l'usage ou avec l'abonnement Data
- Domaine
- Marché des communes
vie_annonces_zone
Vie des annonces d'une zone
Vie des annonces d'une commune ou d'un code postal, mois par mois : entrées (particuliers, professionnels, exclusifs, maisons, appartements), part nationale, sorties rapides et longues, stock, durée médiane en ligne, prix affiché médian au m², baisses et baisse moyenne, chaque mois marqué comparable ou non selon la stabilisation de la collecte. Pour une zone de plusieurs communes, les comptes s'additionnent et les médianes restent vides. S'y ajoutent la durée en ligne par code postal et type de bien (médiane et quartiles, avec l'effectif) et, sur demande, les évènements des derniers jours : baisses de prix et annonces diffusées par plusieurs agences, par identifiant d'annonce.
- Coût
- 5 crédits par appel réussi
- Accès
- À l'usage ou avec l'abonnement Data
- Domaine
- Marché des communes
signaux_commune
Tableau mensuel des signaux d'une commune
Tableau mensuel consolidé d'une commune, tel que le lac de Pillr le calcule : DPE (existants, passoires, maisons, appartements, neufs, tertiaires) et audits, sociétés civiles (créations, modifications, radiations), permis et logements autorisés, flux d'annonces (entrées, sorties, stock, durée, prix affiché, baisses), agences actives, part du leader et concentration, vacance du parc privé, copropriétés, ventes DVF du trimestre. Les avis BODACC des codes postaux de la commune sont comptés par famille. La date de calcul est servie, et un tableau ancien le dit.
- Coût
- 3 crédits par appel réussi
- Accès
- À l'usage ou avec l'abonnement Data
- Domaine
- Marché des communes
radar_prospection
Radar de prospection d'une commune ou d'un département
Radar de prospection mensuel d'une commune, ou de toutes les communes d'un département classées par score : score sur 100, rang dans le département, cinq blocs (vendeurs sans agence, mandats qui patinent, absence d'agence dominante, parc immobile, signaux amont) et leur détail (pression des DPE, vente directe, mandats essoufflés, stock, agences présentes, part du leader et concentration, exclusifs, prix au m² médian, durée médiane, baisses). Le dernier mois calculé, ou le mois demandé. Des agrégats communaux, sans adresse ni nom. Liste paginée.
- Coût
- 3 crédits par élément rendu
- Accès
- À l'usage ou avec l'abonnement Data
- Domaine
- Pré-marché
plan_prospection
Plan de prospection rédigé
Plan de prospection d'une commune, rédigé par un modèle de langage à partir des faits du radar du mois (score, blocs, flux d'annonces, vente directe, agences, vacance, copropriétés, ventes), rendus avec le plan : trois à cinq phrases, aucun chiffre absent des faits (une réponse qui en invente est rejetée), aucune adresse ni aucun nom, jamais de démarchage téléphonique d'un particulier. Sans plan fiable, rien n'est débité.
- Coût
- 20 crédits par appel réussi
- Accès
- À l'usage ou avec l'abonnement Data
- Domaine
- Pré-marché
classement_communes
Classement de communes (screener)
Communes classées par rendement brut théorique (loyer multiplié par douze, divisé par le prix au m², pour les appartements ou les maisons), par score Pillr ou par distance, avec la logique de l'outil de screening du Hub. Filtres : budget et surface type, prix au m² maximal, rendement minimal, population, sécurité, vacance, évolution à 3 ans, exclusion des QPV, type de bien, distance réelle autour d'une commune (entre centres habités), et les stratégies cashflow, patrimonial, pinel et deal de la page des opportunités. Chaque commune porte la provenance et le nombre de ventes de son prix. Liste paginée.
- Coût
- 1 crédit par élément rendu
- Accès
- À l'usage ou avec l'abonnement Data
- Domaine
- Marché des communes
analyse_ia_zone
Analyse rédigée d'une commune
Analyse rédigée de la commune, déjà générée et stockée par Pillr : note de synthèse sur 100 et sous-notes, points forts, signaux d'alerte avec leur atténuation, recommandations. Servie comme sur les pages communes : les affirmations que le modèle ne pouvait pas sourcer (transport, délinquance, risques, équipements) sont remplacées par les mesures du jour, rendues à côté, et les textes sont réécrits pour la lecture. Aucun modèle n'est appelé. Paris, Lyon et Marseille se lisent par arrondissement.
- Coût
- 2 crédits par appel réussi
- Accès
- À l'usage ou avec l'abonnement Data
- Domaine
- Marché des communes
gentrification
Signaux de valorisation d'une commune
Signaux de valorisation d'une commune, comme l'outil du Hub : évolutions des prix sur 1, 3 et 5 ans, salaire médian, demande, commerces signaux (coworking, bien-être, bio, créatif) comptés en direct dans la base Sirene et rapportés à 100 000 habitants, et un verdict par une règle dont les seuils sont rendus. Signal indicatif à la maille de la commune. Si l'API publique ne répond pas, rien n'est servi ni débité. Paris, Lyon et Marseille se lisent par arrondissement.
- Coût
- 3 crédits par appel réussi
- Accès
- À l'usage ou avec l'abonnement Data
- Domaine
- Marché des communes
geographie
Contours, centre et voisins d'un territoire
Contour GeoJSON d'une commune, d'un arrondissement, d'un quartier IRIS, d'un département ou d'une région, simplifiable à une tolérance en mètres, avec son emprise. Pour une commune : son centre habité (celui des distances du Hub), ses communes voisines et son intercommunalité. Pour un quartier IRIS : sa commune et son intercommunalité.
- Coût
- 1 crédit par appel réussi
- Accès
- À l'usage ou avec l'abonnement Data
- Domaine
- Marché des communes
tuiles_prix
Tuiles vectorielles de la carte des prix
Une tuile vectorielle (Mapbox Vector Tile) de la carte des prix de Pillr, prête à poser dans MapLibre : régions jusqu'au zoom 6, départements jusqu'au 8, communes ensuite, avec les prix au m² des appartements et des maisons. En REST, la tuile part en octets ; en MCP, ses métadonnées et la tuile en ressource. Une tuile hors de la pyramide générée est refusée sans débit.
- Coût
- 1 crédit par appel réussi
- Accès
- À l'usage ou avec l'abonnement Data
- Domaine
- Marché des communes
referentiels
Référentiels de communes et de codes postaux
Correspondances entre nom de commune, code INSEE, code postal, libellé d'acheminement et intercommunalité, lues dans le Code officiel géographique, la base officielle des codes postaux et le référentiel des intercommunalités : recherche d'une commune par son nom (q), communes d'un code postal (cp) ou d'une intercommunalité (siren). Chaque commune porte ses codes postaux, son intercommunalité, ses communes déléguées ou associées et ses mouvements au COG.
- Coût
- 0 crédit par appel réussi
- Accès
- À l'usage ou avec l'abonnement Data
- Domaine
- Marché des communes
verdict_commune
Verdict d'investissement d'une commune
Verdict factuel sur une commune, calculé sans IA par la règle des pages communes : niveau (acheter, surveiller ou cher), libellé, ton et raisons chiffrées, à partir de l'écart au prix attendu du département, du rendement brut et de la tendance des prix, pondérés selon l'optique (achat ou rendement). Les entrées utilisées sont rendues. Quand les données manquent, le verdict le dit. Paris, Lyon et Marseille sont jugées sur l'agrégat de leurs arrondissements.
- Coût
- 1 crédit par appel réussi
- Accès
- À l'usage ou avec l'abonnement Data
- Domaine
- Marché des communes
comparer_communes
Comparaison de communes
De deux à quatre communes côte à côte, avec les chiffres des pages communes : prix au m² des appartements et des maisons avec leur provenance et leur nombre de ventes, loyer, rendements, évolutions sur 1 et 3 ans, zone ABC, population, score Pillr, part de passoires et verdict d'investissement sans IA. Pour chaque indicateur, la commune la mieux placée est désignée. Paris, Lyon et Marseille sont comparées sur l'agrégat de leurs arrondissements.
- Coût
- 1 crédit par élément rendu
- Accès
- À l'usage ou avec l'abonnement Data
- Domaine
- Marché des communes
palmares_communes
Palmarès de communes par indicateur
Communes classées sur un indicateur publié par Pillr, avec les filtres et les tris des pages de classement du site : rendement locatif, cashflow positif, zones A et A bis, prix bas, prix élevés, peu de passoires, score Pillr, communes sous le prix attendu de leur département, meilleur rendement, ou les deux à la fois. En France, dans un département ou dans une région. Chaque ligne porte son rang, sa valeur, sa population et ses ventes ; les seuils de fiabilité appliqués sont rendus en clair. Liste paginée.
- Coût
- 1 crédit par élément rendu
- Accès
- À l'usage ou avec l'abonnement Data
- Domaine
- Marché des communes
avis_zone
Avis des investisseurs sur une commune
Avis déposés par les utilisateurs de Pillr sur une commune, triés par utilité puis par date (ou par date) : note globale et quatre notes (rentabilité, qualité de vie, demande locative, valorisation), titre, texte, profil déclaré de l'auteur et mention de vérification, avec les moyennes de la commune. L'identité de l'auteur n'est jamais servie, ni les coordonnées citées dans un texte. Liste paginée.
- Coût
- 1 crédit par appel réussi
- Accès
- À l'usage ou avec l'abonnement Data
- Domaine
- Marché des communes
avis_zone_publier
Publier un avis sur une commune
Publie l'avis de l'utilisateur de la clé sur une commune, avec les règles du site : note globale de 1 à 5, quatre notes facultatives, titre, texte et profil. Un seul avis par compte et par commune ; un second est refusé. L'avis est servi ensuite sans l'identité de son auteur.
- Coût
- 0 crédit par appel réussi
- Accès
- À l'usage ou avec l'abonnement Data
- Domaine
- Marché des communes
avis_zone_voter
Voter pour l'utilité d'un avis
Pose le vote d'utilité de l'utilisateur de la clé sur un avis : utile (par défaut) ou non. Le même appel deux fois laisse le même état ; le compteur d'utilité est recalculé depuis les votes.
- Coût
- 0 crédit par appel réussi
- Accès
- À l'usage ou avec l'abonnement Data
- Domaine
- Marché des communes
loyer_marche
Loyer de marché d'un logement
Loyer d'annonce, charges comprises, d'un logement d'une commune selon sa typologie (T1 à T5, maison) et sa surface, lu dans les quatre segments de la Carte des loyers (ANIL, DHUP) : loyer au m², loyer mensuel, fourchette à 95 %, segment retenu et repli éventuel sur l'ensemble des appartements, rendement brut de marché, et le modèle derrière chaque segment (type de prédiction, annonces observées, R² ajusté). Sans typologie ni surface, rend la synthèse de la commune (une ligne par typologie à surface d'exemple). Mêmes fonctions que les pages loyer de pillr.fr ; Paris, Lyon et Marseille sont agrégés depuis leurs arrondissements.
- Coût
- 1 crédit par appel réussi
- Accès
- À l'usage ou avec l'abonnement Data
- Domaine
- Marché des communes
encadrement_loyers
Encadrement des loyers
Encadrement des loyers d'un logement à Paris, décrit par son code postal, son nombre de pièces, son époque de construction, la location meublée ou non et sa surface, ou par une annonce du catalogue : loyers de référence, minoré et majoré au m² du barème le plus récent (quartier nommé, ou moyenne des quartiers de l'arrondissement), loyer maximal légal hors complément de loyer, et dépassement d'un loyer envisagé. Hors de Paris, applicable vaut faux et encadrement_en_vigueur dit si la commune figure parmi les communes encadrées ; leur barème n'est pas servi.
- Coût
- 1 crédit par appel réussi
- Accès
- À l'usage ou avec l'abonnement Data
- Domaine
- Marché des communes
zonage_logement
Zonage ABC, plafonds et contraintes locales
Zone ABC d'une commune (corrigée des révisions officielles que la base n'intègre pas encore), statut à la date de l'appel des dispositifs d'investissement locatif (Pinel, Relance logement, Denormandie, Loc'Avantages, déficit foncier) avec leur source officielle, plafond de loyer de la location intermédiaire au m² et, pour une surface donnée, au mois avec le coefficient de surface, comparé à un loyer, et contraintes locales à vérifier en mairie : encadrement des loyers, location de courte durée, tension du marché. Mêmes faits sourcés que les pages de pillr.fr ; aucun conseil fiscal.
- Coût
- 1 crédit par appel réussi
- Accès
- À l'usage ou avec l'abonnement Data
- Domaine
- Marché des communes
simuler_rendement
Rendement, cash-flow et crédit
Simulation d'un investissement locatif avec le moteur du simulateur de la fiche annonce de pillr.fr : pour la location nue, la location meublée longue durée et la courte durée, loyer, rendements brut et net, mensualité du crédit, cash-flow mensuel avant et après l'impôt de la première année (régime le moins imposé), décomposé poste par poste, et projection année par année. Recommandation sur le cash-flow avant impôt et sur le TRI après impôt et revente, taux d'effort au sens du HCSF quand les revenus sont donnés. Le loyer est celui donné, sinon le loyer de marché de la commune ; la courte durée suit le profil de marché AirDNA et le statut réglementaire de la commune. Les frais d'acquisition suivent le barème du département. Calcul déterministe, aucun conseil fiscal.
- Coût
- 2 crédits par appel réussi
- Accès
- À l'usage ou avec l'abonnement Data
- Domaine
- Estimation
taux_credit
Taux de crédit du moment
Taux de crédit immobilier du moment par durée (bon taux, très bon taux, taux excellent), lus dans le tableau du baromètre public de meilleurtaux.com, avec la date de sa simulation. Lecture d'une page tierce sans API ni contrat : si le tableau change de forme ou ne répond pas, l'opération répond « donnée indisponible », jamais un taux de repli. Réponse gardée 6 heures.
- Coût
- 1 crédit par appel réussi
- Accès
- À l'usage ou avec l'abonnement Data
- Domaine
- Estimation
simuler_fiscalite
Simulation fiscale sur l'horizon de détention
Simulation fiscale déterministe d'un investissement locatif, décrit ou désigné par une annonce, avec le moteur du simulateur de pillr.fr et de l'agent du Hub : location nue, meublée longue durée et courte durée, chacune évaluée sous chacun de ses régimes (micro-foncier, réel avec déficit, bailleur privé, micro-BIC, micro-BIC classé, réel LMNP, SCI à l'IS). Pour chaque régime : impôt et cash-flow année par année, revente nette et impôt de plus-value, TRI, VAN, enrichissement, et le motif d'un régime inaccessible. Recommandation motivée au meilleur TRI après impôt, prix maximum pour un TRI visé et pour un cash-flow nul, test de résistance, contraintes locales. Règles fiscales codées dans le moteur et citées dans ses avertissements ; aucun conseil fiscal.
- Coût
- 2 crédits par appel réussi
- Accès
- À l'usage ou avec l'abonnement Data
- Domaine
- Estimation
plus_value
Plus-value immobilière à la revente
Plus-value immobilière d'un particulier à la revente, avec le moteur fiscal de pillr.fr : durée de détention, prix d'acquisition majoré des frais (réels, ou forfait de 7,5 %) et des travaux (réels, ou forfait de 15 % après 5 ans), amortissements réintégrés en LMNP ou en bailleur privé, abattements pour durée de détention à l'impôt sur le revenu et aux prélèvements sociaux, impôt, prélèvements, surtaxe des plus-values élevées, impôt total et net vendeur. Exonération de la résidence principale. Aucun conseil fiscal.
- Coût
- 1 crédit par appel réussi
- Accès
- À l'usage ou avec l'abonnement Data
- Domaine
- Estimation
taxe_amenagement
Taxe d'aménagement d'un projet
Taxe d'aménagement d'un projet de construction, d'agrandissement, de piscine ou de places de stationnement extérieures, avec le moteur des démarches d'urbanisme de pillr.fr : parts communale, départementale et régionale (Île-de-France) aux taux votés par les collectivités (délibérations notifiées à la DGFiP), ou au barème légal en fourchette quand la commune n'en publie pas, abattement de la résidence principale, piscine et places au forfait, taxe d'archéologie préventive, déclaration et paiement, chaque valeur avec sa source. Un fait manquant revient en question. Estimation indicative : seul l'avis de la DGFiP fixe le montant dû.
- Coût
- 1 crédit par appel réussi
- Accès
- À l'usage ou avec l'abonnement Data
- Domaine
- Urbanisme
courte_duree_commune
Marché de la courte durée d'une commune
Marché de la location courte durée d'une commune : profil AirDNA (annonces actives, revenu, occupation, prix de nuit, revenu par nuit disponible, évolutions sur un an, score de marché et sous-scores), à la maille de la commune, de la ville pour un arrondissement, du département ajusté à la part de résidences secondaires ou de la France, avec sa confiance ; rentabilité de la courte durée, scores Pillr de courte durée, de longue durée et de tourisme, part de résidences secondaires, et statut réglementaire de la courte durée. Mêmes profils que le simulateur de pillr.fr. Données aspirées des pages publiques d'AirDNA.
- Coût
- 2 crédits par appel réussi
- Accès
- À l'usage ou avec l'abonnement Data
- Domaine
- Marché des communes
estimer_courte_duree
Revenu de courte durée d'un logement
Revenu de location courte durée d'un logement décrit par sa commune, sa surface et ses chambres, avec le modèle du simulateur de pillr.fr : capacité d'accueil, prix de nuit et occupation ajustés à la capacité depuis le profil de marché AirDNA de la commune, nuits ouvertes et réservées, montée en charge de la première année ; coûts d'exploitation (plateforme, conciergerie, renouvellement, ménage, linge, énergie, internet, assurance, classement), revenu net, statut réglementaire de la commune et du DPE, hypothèses et avertissements. Sans profil de marché, le revenu est un multiple du loyer nu, et le dit.
- Coût
- 2 crédits par appel réussi
- Accès
- À l'usage ou avec l'abonnement Data
- Domaine
- Estimation
risques_commune
Risques naturels et technologiques
Risques d'une commune : inondation, remontée de nappe, séisme, mouvement de terrain, argiles, radon, feu de forêt, site industriel, nucléaire, pollution des sols, rupture de barrage et risque minier, avec leur niveau et un score composite là où Géorisques est relevé en base, et les risques recensés par l'API publique Géorisques en direct ailleurs ; potentiel radon de l'IRSN pour toutes les communes ; arrêtés de catastrophe naturelle depuis 1982. Chaque bloc dit sa source. Ne remplace pas l'état des risques d'une adresse, obligatoire avant un achat.
- Coût
- 2 crédits par appel réussi
- Accès
- À l'usage ou avec l'abonnement Data
- Domaine
- Marché des communes
mesures_zone
Équipements, accès, délinquance et cadre de vie
Mesures d'une commune, chacune avec sa phrase et sa source, celles de l'analyse de zone de pillr.fr : équipements de la Base permanente des équipements (quinze comptes sur la commune entière et les essentiels absents), gare de voyageurs et aéroport les plus proches avec la distance, délinquance enregistrée par catégorie (faits et taux pour 1 000 habitants, comparés à la moyenne des communes publiées), potentiel radon et risques relevés, points d'intérêt à 500 m et score de marche à pied là où ils sont calculés.
- Coût
- 2 crédits par appel réussi
- Accès
- À l'usage ou avec l'abonnement Data
- Domaine
- Marché des communes
urbanisme_adresse
Urbanisme à l'adresse
Urbanisme à une adresse, par sa clé BAN, par l'adresse en texte ou par un point (lat et lon), d'après les documents publiés sur le Géoportail de l'Urbanisme : zone du PLU, du PLUi ou de la carte communale avec le lien du règlement, prescriptions et informations qui couvrent le point ou passent tout près, servitudes d'utilité publique avec le lien de l'acte, constats factuels, et un statut explicite quand aucune zone n'est rendue (commune au RNU, document non publié pour la commune, point hors des zones publiées). Le règlement n'est pas lu, son lien est donné. Seul un certificat d'urbanisme engage la commune.
- Coût
- 2 crédits par appel réussi
- Accès
- À l'usage ou avec l'abonnement Data
- Domaine
- Urbanisme
lire_plu
Règlement du PLU lu et cité
Les règles écrites du règlement de la zone du PLU ou du PLUi d'une adresse (clé BAN, adresse en texte ou point), par thème : voies, limites séparatives, distances entre constructions, emprise au sol, hauteur, piscines, annexes, stationnement, espaces verts, aspect et clôtures. Chaque règle porte sa valeur ou sa formule, son article, sa page et la citation exacte retrouvée dans le texte du PDF ; une règle dont la citation n'est pas retrouvée est écartée, jamais affirmée. La réponse donne aussi les définitions du lexique, les renvois et les thèmes non trouvés. Une zone déjà lue vient du cache des lectures de Pillr ; sinon le règlement est lu par un modèle, ce qui prend de l'ordre d'une minute : la réponse est une tâche (202) dont le résultat se lit ensuite. Une lecture nouvelle est bornée par le débit du serveur. Sans règlement à lire (commune au RNU, carte communale, aucun PDF publié), rien n'est débité. Seul un certificat d'urbanisme engage la commune.
- Coût
- 60 crédits par appel réussi
- Accès
- À l'usage ou avec l'abonnement Data
- Domaine
- Règlement du PLU
resultat_lire_plu
Résultat : règlement du PLU lu et cité
État et résultat d'une tâche lancée par POST /urbanisme/reglements (outil lire_plu) : statut, sortie complète quand elle est terminée, erreur quand elle a échoué (ses crédits sont alors rendus). Le paramètre attendre patiente jusqu'à 60 s.
- Coût
- 0 crédit par appel réussi
- Accès
- À l'usage ou avec l'abonnement Data
- Domaine
- Règlement du PLU
documents_urbanisme
Documents d'urbanisme d'une commune
Les documents d'urbanisme d'une commune publiés sur le Géoportail de l'Urbanisme : PLU, PLUi ou carte communale avec leur identifiant, type, état, dates et lien ; le RNU ; la liste des zones avec le lien de leur règlement et l'état de sa lecture par Pillr ; les secteurs de carte communale ; les servitudes d'utilité publique dont l'emprise touche celle de la commune, avec leurs actes. Pour un arrondissement de Paris, Lyon ou Marseille, les documents de la commune sont lus aussi.
- Coût
- 2 crédits par appel réussi
- Accès
- À l'usage ou avec l'abonnement Data
- Domaine
- Urbanisme
objets_urbanisme
Objets d'urbanisme dans une emprise
Les objets du Géoportail de l'Urbanisme dont l'emprise touche une boîte d'environ 2 km de côté au plus, avec leur géométrie GeoJSON et leurs propriétés brutes : zones, secteurs de carte communale, prescriptions et informations (surfaces, lignes, points), assiettes de servitudes. Liste paginée par curseur, dans l'ordre des couches puis des identifiants. Un objet est retenu quand sa boîte englobante touche l'emprise : sa géométrie peut rester en dehors.
- Coût
- 1 crédit par élément rendu
- Accès
- À l'usage ou avec l'abonnement Data
- Domaine
- Urbanisme
permis_adresse
Autorisations d'urbanisme d'une adresse ou d'une parcelle
Toutes les autorisations d'urbanisme Sitadel d'une adresse (clé BAN) ou d'une parcelle cadastrale : permis de construire, déclarations préalables, permis d'aménager et de démolir, locaux non résidentiels. Pour chacune : type, état, dates d'autorisation, d'ouverture de chantier et d'achèvement, nature du projet, logements créés par taille, sociaux et en prêt à taux zéro, surfaces, superficie du terrain, demandeur personne morale nommé avec son SIREN (une personne physique n'est jamais nommée), parcelles, et tous les champs publiés. Le rattachement se fait par une parcelle du terrain, sinon par le numéro et la voie, et chaque autorisation dit lequel. Les dates postérieures à aujourd'hui sont des dates prévisionnelles de la source, signalées.
- Coût
- 3 crédits par appel réussi
- Accès
- À l'usage ou avec l'abonnement Data
- Domaine
- Adresse et DPE
permis
Recherche d'autorisations d'urbanisme
Les autorisations d'urbanisme Sitadel d'une commune, d'un demandeur personne morale (SIREN) ou d'un numéro, filtrées par période, type (PC, DP, PA, PD), nature du projet et nombre de logements créés, des plus récentes aux plus anciennes. Chaque autorisation porte les mêmes champs que permis_adresse, l'adresse du terrain, la clé BAN rapprochée (par une parcelle du terrain, sinon par le numéro et la voie) et tous les champs publiés. Pour Paris, Lyon et Marseille, Sitadel range les autorisations sous la commune entière : un code d'arrondissement est lu avec celui de sa commune.
- Coût
- 1 crédit par élément rendu
- Accès
- À l'usage ou avec l'abonnement Data
- Domaine
- Urbanisme
demarche_urbanisme
Démarche d'urbanisme d'un projet
Démarche d'urbanisme d'un projet de travaux décrit, sans adresse : formalité (aucune, déclaration préalable, permis de construire, d'aménager ou de démolir), formulaire Cerfa, architecte obligatoire ou non, pièces du dossier avec l'opération qui les prépare, délai d'instruction et valeur du silence de la mairie, taxe d'aménagement estimée (aux taux votés par la commune quand son code INSEE est donné, sinon en fourchette du barème légal) et redevance d'archéologie préventive, chaque conclusion avec sa règle et sa source, et la date de la base de règles. Un fait manquant revient en question, jamais en supposition. La zone du PLU et les servitudes ne sont pas lues : les protections du terrain se déclarent en paramètres (urbanisme_adresse les donne pour une adresse). Information générale, ni conseil juridique ni décision de la mairie.
- Coût
- 1 crédit par appel réussi
- Accès
- À l'usage ou avec l'abonnement Data
- Domaine
- Urbanisme
croquis_projet
Plan de situation, plan de masse et implantation
Le plan de situation et le plan de masse coté d'un projet (extension, annexe, abri, garage, carport, piscine, terrasse, véranda) sur la parcelle cadastrale et les bâtiments de la BD TOPO de l'IGN, lus en direct, pour une adresse, un identifiant de parcelle ou un point. Les projets se placent contre un côté du bâtiment principal, à une distance d'une limite, par un contour donné, ou automatiquement : trois emplacements notés sur l'ensoleillement au 21 juin et au 21 mars, les distances, le relief et les limites. La réponse donne les emprises et les mesures, les alertes (débord, chevauchement), la formalité établie depuis les projets dessinés, la zone du PLU et les servitudes lues en un point de la parcelle, les règles du règlement déjà lu (reculs, emprise, hauteur) et les vues du plan de situation. Le plan de masse n'est pas dessiné quand un architecte est obligatoire ou que des faits manquent : la réponse le dit, avec les questions. Croquis indicatif, à vérifier avant dépôt.
- Coût
- 20 crédits par appel réussi
- Accès
- À l'usage ou avec l'abonnement Data
- Domaine
- Urbanisme
coupes_facades
Coupes, façades et toitures
Le plan en coupe et le plan des façades et des toitures des projets d'un croquis, à l'échelle : terrain naturel lu en direct sur le RGE ALTI de l'IGN (altitudes NGF), hauteur maximale au-dessus du terrain, distances aux limites, surfaces de déblai et de remblai, toitures (plate, un ou deux pans), ouvertures et matériaux, silhouettes des bâtiments existants accolés. Les projets se décrivent comme pour croquis_projet, avec leurs niveaux, leur toiture et leurs ouvertures. Un fait manquant revient en question et le projet n'est pas dessiné ; si l'altimétrie de l'IGN ne répond pas, rien n'est dessiné ni débité.
- Coût
- 20 crédits par appel réussi
- Accès
- À l'usage ou avec l'abonnement Data
- Domaine
- Urbanisme
preparer_dossier
Dossier de dépôt
Le dossier de dépôt en mairie d'un projet, établi dans l'appel : le croquis de la parcelle (comme croquis_projet), les coupes et façades quand les projets en portent les faits (comme coupes_facades), puis la formalité et le Cerfa retenus, les pièces dans l'ordre du bordereau avec leur code, leur rôle et leur état (prête, à produire par une opération, à fournir par le demandeur), ce qui manque, les alertes du croquis et les données du Cerfa à passer à l'opération cerfa. La réponse est une tâche (202) dont le résultat se lit ensuite. L'archive ZIP du dossier (pièces graphiques à l'échelle, Cerfa, bordereau) se fabrique dans le Hub : par l'API, chaque pièce se produit par son opération.
- Coût
- 200 crédits par appel réussi
- Accès
- À l'usage ou avec l'abonnement Data
- Domaine
- Urbanisme
resultat_preparer_dossier
Résultat : dossier de dépôt
État et résultat d'une tâche lancée par POST /urbanisme/dossiers (outil preparer_dossier) : statut, sortie complète quand elle est terminée, erreur quand elle a échoué (ses crédits sont alors rendus). Le paramètre attendre patiente jusqu'à 60 s.
- Coût
- 0 crédit par appel réussi
- Accès
- À l'usage ou avec l'abonnement Data
- Domaine
- Urbanisme
cerfa
Cerfa d'urbanisme pré-rempli
Le PDF officiel d'un Cerfa d'urbanisme (lu sur formulaires.service-public.gouv.fr, dans la version vérifiée par Pillr), rempli des seules cases connues du dossier : adresse et superficie du terrain, références cadastrales, nature des travaux, annexes, emprise au sol créée, description du projet. L'identité, les coordonnées, l'engagement et la signature du demandeur ne sont jamais remplis : la réponse les liste avec les cases restées vides. En REST, la réponse est le PDF ; en MCP, la liste des cases remplies et vides, et le PDF en ressource. Si le formulaire officiel a changé depuis sa vérification, rien n'est rempli ni débité et les valeurs sont rendues pour une saisie à la main.
- Coût
- 5 crédits par appel réussi
- Accès
- À l'usage ou avec l'abonnement Data
- Domaine
- Urbanisme
echeances_depot
Échéances d'un dossier après dépôt
Échéances datées d'un dossier d'urbanisme à partir de sa date de dépôt : courrier de pièces manquantes, fin du délai d'instruction (de droit commun et majoré), date à partir de laquelle le silence vaut accord ou refus, affichage et recours des tiers, retrait par la mairie, prorogation et fin de validité, recours contre un refus, puis DAACT, déclaration et paiement de la taxe d'aménagement à l'achèvement. Chaque échéance porte sa règle et sa source. La démarche se donne telle que demarche_urbanisme l'a établie, ou se calcule dans l'appel à partir des faits du projet. Les dates se comptent de quantième à quantième ; le récépissé et les courriers de la mairie font foi.
- Coût
- 1 crédit par appel réussi
- Accès
- À l'usage ou avec l'abonnement Data
- Domaine
- Urbanisme
rendu_aerien
Rendu réaliste d'un projet sur la vue aérienne
Une image réaliste du projet posé à l'échelle sur la photo aérienne de l'IGN : la photo est lue en direct, le dessin exact du projet y est composé, puis un modèle d'image rend le seul projet réaliste, sans rien ajouter ni déplacer. L'image est une illustration indicative : elle ne remplace pas le document graphique d'insertion du dossier. En REST, la réponse est l'image PNG ; en MCP, ses métadonnées, et l'image en ressource. Les rendus sont bornés par heure et par organisation, comme dans le Hub.
- Coût
- 100 crédits par appel réussi
- Accès
- À l'usage ou avec l'abonnement Data
- Domaine
- Urbanisme
agences_commune
Agences actives et parts de marché d'une commune
Les agences actives dans une commune, mois par mois, d'après les annonces relevées par Pillr : enseigne, SIREN, mandats pris, mandats exclusifs, durée médiane en ligne, part des annonces baissées et part de marché de chaque agence, avec la part du leader et l'indice de concentration (HHI) de la commune. Par défaut le dernier mois calculé ; « mois » pour un mois donné, « depuis » pour tous les mois à partir d'un mois (24 mois au plus). Rien n'est masqué : un mois à peu de mandats est servi avec le drapeau peu_d_observations. Aucune agence relevée : 404 ressource_absente, rien n'est débité.
- Coût
- 3 crédits par appel réussi
- Accès
- À l'usage ou avec l'abonnement Data
- Domaine
- Entreprises, agences et sociétés civiles
agences
Agences et réseaux immobiliers
La fiche d'une agence immobilière par son SIREN, ou les agences d'un lieu (commune, code postal, département), d'une enseigne ou d'un réseau. Pour chacune : dénomination, enseigne, sigle, catégorie juridique, APE, établissements Sirene (SIRET, adresse, effectif, création, siège), agences des portails rattachées au SIREN avec leur enseigne ou réseau, domaines web, coordonnées professionnelles avec leur origine, mandats du dernier mois par commune, annonces en ligne, et les 20 derniers avis BODACC. Seules les adresses électroniques publiées par l'agence sont servies, jamais une adresse construite par motif. Aucune agence : 404 ressource_absente, rien n'est débité.
- Coût
- 2 crédits par élément rendu
- Accès
- À l'usage ou avec l'abonnement Data
- Domaine
- Entreprises, agences et sociétés civiles
agents_immobiliers
Agents et mandataires
Les agents et mandataires immobiliers vus sur les portails et dans les annuaires des réseaux, servis comme professionnels : nom d'exercice, réseau, SIREN, communes, nombre de biens, types et prix, et coordonnées professionnelles avec leur origine. Filtres : commune (code INSEE, rapprochée par le code postal et le nom de la commune principale), code postal, département, SIREN de l'agence ou réseau. Seules les adresses électroniques publiées par le professionnel sont servies, jamais une adresse construite par motif ; un professionnel qui s'est opposé à nos envois n'a plus aucune coordonnée servie. Aucun agent : 404 ressource_absente, rien n'est débité.
- Coût
- 1 crédit par élément rendu
- Accès
- À l'usage ou avec l'abonnement Data
- Domaine
- Entreprises, agences et sociétés civiles
societes_civiles
Sociétés civiles domiciliées à une adresse
Les sociétés civiles (immobilières, de moyens...) domiciliées à une adresse de la Base Adresse Nationale, par sa clé : dénomination, SIREN, forme, avis BODACC (création, modification, radiation, procédure, cession) avec leur date, et présence d'une société avant le dernier DPE. Les avis sont ceux que la gold de Pillr rattache à l'adresse ; le SIREN est rapproché par la dénomination et le code postal. Les gérants et associés ne sont jamais nommés. Adresse inconnue : 404 adresse_introuvable, rien n'est débité ; une adresse sans société civile rend n = 0.
- Coût
- 3 crédits par appel réussi
- Accès
- À l'usage ou avec l'abonnement Data
- Domaine
- Adresse et DPE
entreprise
Entreprise : avis BODACC et autorisations
Une entreprise par son SIREN : tous ses avis BODACC depuis 2009 (création, modifications, radiation, ventes et cessions, procédures collectives, dépôts des comptes), avec leur contenu structuré (établissements, jugements, actes), ses établissements Sirene de l'immobilier, ses autorisations d'urbanisme (Sitadel) et, si c'est une agence, ses enseignes et ses mandats par commune. Les personnes physiques d'un avis (gérants, associés) ne gardent que leur qualité ; un avis qui porte sur une personne physique ne sert ni son identité ni ses textes. Filtres : familles d'avis et date de début. SIREN inconnu de toutes les sources : 404 ressource_absente, rien n'est débité.
- Coût
- 3 crédits par appel réussi
- Accès
- À l'usage ou avec l'abonnement Data
- Domaine
- Entreprises, agences et sociétés civiles
analyse_immeuble
Dossier d'un immeuble de rapport
Le dossier d'un immeuble de rapport, en cinq blocs, celui de l'outil analyse_immeuble du Hub : 1. les lots établis par les DPE de l'adresse (candidats dans un rayon de 250 m, confiance par concordance de surface et nombre de logements annoncé, désaccord) ; 2. l'état locatif lot par lot au loyer de la Carte des loyers selon la taille de chaque lot, et une découpe en lots de 40 ou 30 m² ; 3. le prix face à la prime de division DVF de la commune (repli départemental), servie quel que soit le nombre de ventes ; 4. les seuils fiscaux propres à l'immeuble ; 5. les risques datés, dont le calendrier énergétique par étiquette. Le vendeur n'est jamais nommé. Pour une annonce d'immeuble du catalogue Pillr, par son identifiant.
- Coût
- 10 crédits par appel réussi
- Accès
- À l'usage ou avec l'abonnement Data
- Domaine
- Annonces
analyse_immeuble_calculer
Dossier d'un immeuble pas encore analysé
Le dossier d'un immeuble de rapport, en cinq blocs, celui de l'outil analyse_immeuble du Hub : 1. les lots établis par les DPE de l'adresse (candidats dans un rayon de 250 m, confiance par concordance de surface et nombre de logements annoncé, désaccord) ; 2. l'état locatif lot par lot au loyer de la Carte des loyers selon la taille de chaque lot, et une découpe en lots de 40 ou 30 m² ; 3. le prix face à la prime de division DVF de la commune (repli départemental), servie quel que soit le nombre de ventes ; 4. les seuils fiscaux propres à l'immeuble ; 5. les risques datés, dont le calendrier énergétique par étiquette. Le vendeur n'est jamais nommé. Pour un immeuble collecté par Pillr que la file d'analyse n'a pas encore atteint, par le lien de son annonce (source_url).
- Coût
- 10 crédits par appel réussi
- Accès
- À l'usage ou avec l'abonnement Data
- Domaine
- Annonces
lots_adresse
Lots d'un immeuble établis par ses DPE
Les lots d'un immeuble à une adresse (clé BAN), établis par les DPE de ses logements (ADEME) : un lot par DPE d'appartement de moins de 10 ans, surface, étiquette, étage, numéros de DPE ; un DPE remplacé rejoint le lot de son remplaçant. Deux DPE du même étage à la même surface sans lien de remplacement sont signalés comme doublon possible, jamais fusionnés. Le compte est confronté au registre des copropriétés et au DPE de l'immeuble ; chaque écart est dit dans desaccords.
- Coût
- 3 crédits par appel réussi
- Accès
- À l'usage ou avec l'abonnement Data
- Domaine
- Adresse et DPE
prime_division
Prime de division d'une commune
Prime de division mesurée sur DVF dans une commune : prix au m² médian des mutations d'un seul logement face aux mutations de 4 logements ou plus (ventes en bloc), sur les 3 dernières années, avec le nombre de mutations de chaque côté, la période couverte et la qualité de la mesure. Les médianes sont servies quel que soit le nombre de ventes, avec le drapeau peu_d_observations sous les seuils du dossier immeuble ; sous ces seuils, la mesure du département est servie à côté. Paris, Lyon et Marseille se mesurent sur leurs arrondissements. Le rapport est un plafond, pas un profit.
- Coût
- 2 crédits par appel réussi
- Accès
- À l'usage ou avec l'abonnement Data
- Domaine
- Marché des communes
travaux_zone
Indice Travaux et état du parc en vente
Pour un code postal ou une commune, un mois d'entrée au catalogue et un type de bien : biens lus (une fiche par bien), état visuel médian lu sur les photos, part des biens à rénover, coût médian des travaux et au m², avec l'incertitude mesurée du chiffrage. Le coût vient du barème déterministe d'artisans appliqué aux postes vus sur les photos, jamais d'un montant écrit par le modèle ; les annonces aux photos de catalogue sont écartées et comptées. Par défaut le dernier mois calculé et tous les types. Rien n'est masqué : une maille à peu de biens est servie avec le drapeau peu_d_observations. Maille inconnue : 404 ressource_absente, rien n'est débité.
- Coût
- 2 crédits par appel réussi
- Accès
- À l'usage ou avec l'abonnement Data
- Domaine
- Analyse des photos
travaux_zone_lot
Indice Travaux et état du parc en vente, en lot
Indice Travaux et état du parc en vente pour 100 éléments au plus en un appel : chaque élément est servi ou refusé seul, avec son code d'erreur, et seuls les éléments servis sont débités. Pour un code postal ou une commune, un mois d'entrée au catalogue et un type de bien : biens lus (une fiche par bien), état visuel médian lu sur les photos, part des biens à rénover, coût médian des travaux et au m², avec l'incertitude mesurée du chiffrage. Le coût vient du barème déterministe d'artisans appliqué aux postes vus sur les photos, jamais d'un montant écrit par le modèle ; les annonces aux photos de catalogue sont écartées et comptées. Par défaut le dernier mois calculé et tous les types. Rien n'est masqué : une maille à peu de biens est servie avec le drapeau peu_d_observations. Maille inconnue : 404 ressource_absente, rien n'est débité.
- Coût
- 2 crédits par élément rendu
- Accès
- À l'usage ou avec l'abonnement Data
- Domaine
- Analyse des photos
barometre
Baromètre
L'édition figée du baromètre de Pillr pour la France, un département ou une commune : chaque mesure du registre (prix de référence, ventes, loyer, rendement, annonces, baisses de prix, biens à rénover, budget travaux, écart au prix de référence, part des DPE F et G, résidences secondaires, vacance, revenu), avec son effectif, son intervalle quand il existe, et son seuil de publication. Rien n'est masqué : une valeur sous le seuil de publication du site est servie avec publiee = faux et son motif. edition vaut AAAA-MM ou courante. Édition ou territoire inconnus : 404, rien n'est débité.
- Coût
- 1 crédit par appel réussi
- Accès
- À l'usage ou avec l'abonnement Data
- Domaine
- Marché des communes
barometre_lot
Baromètre, en lot
Baromètre pour 100 éléments au plus en un appel : chaque élément est servi ou refusé seul, avec son code d'erreur, et seuls les éléments servis sont débités. L'édition figée du baromètre de Pillr pour la France, un département ou une commune : chaque mesure du registre (prix de référence, ventes, loyer, rendement, annonces, baisses de prix, biens à rénover, budget travaux, écart au prix de référence, part des DPE F et G, résidences secondaires, vacance, revenu), avec son effectif, son intervalle quand il existe, et son seuil de publication. Rien n'est masqué : une valeur sous le seuil de publication du site est servie avec publiee = faux et son motif. edition vaut AAAA-MM ou courante. Édition ou territoire inconnus : 404, rien n'est débité.
- Coût
- 1 crédit par élément rendu
- Accès
- À l'usage ou avec l'abonnement Data
- Domaine
- Marché des communes
dossier_barometre
Dossier du baromètre sur demande
Un dossier du baromètre composé à partir d'une demande libre : le modèle propose un plan (classements, comparaisons, croisements, répartitions) sur le registre des mesures, sans voir aucun chiffre ; les sections sont calculées de façon déterministe sur l'édition ; la lecture rédigée par le modèle passe par un vérificateur qui retire toute phrase dont un chiffre n'est pas dans les faits calculés. Rend le plan, chaque section (faits, lecture vérifiée, lecture déterministe, graphique, tableau) et un lien signé vers le dossier sur pillr.fr. Les classements suivent les seuils de classement de l'édition. Demande hors du périmètre du baromètre : 400 parametres_invalides, rien n'est débité ; modèle indisponible : 503, crédits rendus.
- Coût
- 20 crédits par appel réussi
- Accès
- À l'usage ou avec l'abonnement Data
- Domaine
- Marché des communes
modeles
Fiches de mesure des modèles
La fiche de mesure de chaque modèle de Pillr, avec la date et l'échantillon de chaque mesure : erreur de l'estimation sur des ventes DVF (avec et sans adresse) et couverture de sa fourchette ; reproductibilité du chiffrage des travaux et de l'état visuel ; calibration du pré-marché par bande et par type de bien (taux de vente DVF à 12 mois), coefficients, coefficients ajustés et AUC, décroissance par âge du DPE, précision des cohortes ; méthode et limites du barème de prix au m² et du loyer de marché. Sans modèle, toutes les fiches. Une mesure absente se dit dans les limites, jamais par un chiffre de remplacement.
- Coût
- 0 crédit par appel réussi
- Accès
- À l'usage ou avec l'abonnement Data
- Domaine
- Référentiels
constantes_reference
Constantes réglementaires et fiscales de référence
Les seuils et taux que les moteurs de Pillr appliquent, par thème : urbanisme (seuils de la déclaration préalable, architecte, piscines), fiscalité (TVA des travaux, Malraux, Pinel, déficit et micro-foncier, régimes micro, prélèvements sociaux, impôt sur les sociétés, amortissement du bailleur privé), pré-marché (fenêtre de mandat, pack de pré-vente) et location (calendrier d'interdiction de louer les passoires énergétiques). Chacune porte sa valeur, son unité, son objet, sa source officielle ou sa mesure, et la date de la version lue. Le registre dit qu'un seuil est le bon seuil, pas qu'il s'applique à un cas donné.
- Coût
- 0 crédit par appel réussi
- Accès
- À l'usage ou avec l'abonnement Data
- Domaine
- Marché des communes
flux_annonces
Flux d'évènements des annonces
Les évènements datés du catalogue des annonces de vente, dans l'ordre où ils ont été écrits : nouvelle annonce, analyse publiée ou refaite, baisse et hausse de prix, retrait, réactivation, passage à plusieurs agences. Chaque évènement porte l'état avant et après, et l'annonce au format liste. Filtres : depuis (date), genres, communes, codes postaux, départements. Le curseur_suivant est rendu même sur la dernière page : repassez-le plus tard, avec les mêmes filtres, pour ne lire que la suite ; a_jour dit qu'il n'y a plus rien à lire pour l'instant. Les baisses de prix sont dédoublonnées au jour et au nouveau prix.
- Coût
- 1 crédit par évènement livré
- Accès
- Avec l'abonnement Data
- Domaine
- Flux d'évènements
flux_adresses
Flux de nouveautés à l'adresse
Les nouveautés datées à l'adresse, lues dans le journal tenu chaque nuit après la reconstruction de la donnée à l'adresse : nouveau DPE, nouvel audit énergétique, nouvelle autorisation d'urbanisme, nouvel avis d'une société civile au siège, nouvelle vente DVF. Chaque évènement porte la clé BAN, la date à la source, le détail et la source publique. Filtres : depuis (date d'entrée au journal), genres, communes, codes postaux. Le curseur_suivant est rendu même sur la dernière page : repassez-le plus tard, avec les mêmes filtres, pour ne lire que la suite.
- Coût
- 1 crédit par évènement livré
- Accès
- Avec l'abonnement Data
- Domaine
- Flux d'évènements
webhooks_creer
Créer un abonnement webhook
Abonne une URL https aux évènements du flux des annonces (genres et filtres au choix), à la fin des opérations asynchrones de l'organisation, et aux résultats des veilles et des alertes que l'organisation a créées par l'API (livrés 15 minutes au moins après leur remontée, au format de resultats_veilles). Chaque livraison est un POST JSON signé par l'en-tête Pillr-Signature (t=horodatage, v1=HMAC-SHA256 du texte « horodatage.corps » avec le secret de l'abonnement), reprise à 1 min, 5 min, 30 min, 2 h et 12 h en cas d'échec ; l'abonnement est coupé après 50 échecs consécutifs. Le secret n'est affiché qu'à la création. Chaque évènement d'annonce et chaque résultat livré est débité au barème evenement (1 crédit).
- Coût
- 0 crédit par appel réussi
- Accès
- Avec l'abonnement Data
- Domaine
- Webhooks
webhooks
Abonnements webhook de l'organisation
Les abonnements webhook de l'organisation, sans leur secret, avec leur état (actif ou coupé, échecs consécutifs) et leurs dernières livraisons.
- Coût
- 0 crédit par appel réussi
- Accès
- Avec l'abonnement Data
- Domaine
- Webhooks
webhooks_supprimer
Supprimer un abonnement webhook
Supprime un abonnement webhook de l'organisation et ses livraisons en attente.
- Coût
- 0 crédit par appel réussi
- Accès
- Avec l'abonnement Data
- Domaine
- Webhooks
webhooks_tester
Tester un abonnement webhook
Envoie tout de suite à l'URL de l'abonnement une livraison d'essai signée (genre test), sans reprise, et rend le code HTTP reçu. Un essai réussi réactive un abonnement coupé.
- Coût
- 0 crédit par appel réussi
- Accès
- Avec l'abonnement Data
- Domaine
- Webhooks
veilles_creer
Créer un agent de veille
Crée un agent de veille sur les annonces, rattaché au compte de la clé : à partir d'une mission en langage naturel, traduite en pré-filtre par un modèle de langage, ou de critères exacts (recherche), sans modèle. L'agent remonte chaque jour les nouvelles annonces qui collent, jugées contre la mission par le juge IA ; ses résultats se lisent par resultats_veilles. Le compte garde un plafond d'agents actifs. Un agent créé par l'API est rattaché à l'organisation de la clé et débité, tant qu'il est actif, de 1 crédit par jour (barème veille_jour).
- Coût
- 20 crédits par appel réussi ; 0 crédit par appel réussi avec des critères exacts (recherche)
- Accès
- À l'usage ou avec l'abonnement Data
- Domaine
- Flux d'évènements
veilles
Agents de veille du compte
Les agents de veille du compte de la clé, actifs d'abord : mission, critères enregistrés, date du dernier jugement IA et biens remontés sur 7 jours.
- Coût
- 0 crédit par appel réussi
- Accès
- À l'usage ou avec l'abonnement Data
- Domaine
- Flux d'évènements
veilles_modifier
Modifier un agent de veille
Met un agent de veille en pause ou le réactive, le renomme, change sa mission ou sa fréquence. Une réactivation respecte le plafond d'agents actifs du compte. Le même appel répété laisse le même état.
- Coût
- 0 crédit par appel réussi
- Accès
- À l'usage ou avec l'abonnement Data
- Domaine
- Flux d'évènements
alertes_zone_creer
Créer un suivi de zone
Crée un suivi de zone rattaché au compte de la clé : une commune, un code INSEE, un code postal, un disque autour d'un point, une liste de communes ou une intercommunalité (une alerte par commune). Trois volets, actifs par défaut : le pré-marché (adresses dont la priorité dépasse le seuil), les annonces de particuliers qui stagnent, baissent ou republient, et les signaux marché (baisses de la veille, passages en multi-mandat). Passage chaque nuit, quotidien ou hebdomadaire ; le premier a lieu le lendemain matin. Rien n'est créé si le secteur dépasse les places libres sous le plafond des suivis actifs du compte.
- Coût
- 0 crédit par appel réussi
- Accès
- À l'usage ou avec l'abonnement Data
- Domaine
- Pré-marché
alertes_pre_marche_creer
Créer une veille pré-marché
Crée une veille pré-marché rattachée au compte de la clé, sur un secteur (commune, code INSEE, code postal ou disque autour d'un point) : chaque nuit, les nouvelles adresses dont la priorité dépasse le seuil. Le compte garde un plafond de veilles pré-marché actives.
- Coût
- 0 crédit par appel réussi
- Accès
- À l'usage ou avec l'abonnement Data
- Domaine
- Pré-marché
alertes
Alertes du compte
Les suivis de zone et les veilles pré-marché du compte de la clé, actives d'abord : secteur, volets suivis, seuils, fréquence et dernier passage.
- Coût
- 0 crédit par appel réussi
- Accès
- À l'usage ou avec l'abonnement Data
- Domaine
- Pré-marché
alertes_supprimer
Supprimer une alerte
Supprime un suivi de zone ou une veille pré-marché du compte de la clé, avec ses résultats.
- Coût
- 0 crédit par appel réussi
- Accès
- À l'usage ou avec l'abonnement Data
- Domaine
- Pré-marché
resultats_veilles
Résultats des veilles et des alertes
Ce que les veilles et les alertes du compte de la clé ont remonté, du plus ancien au plus récent : pour un agent de veille, les annonces retenues avec le signal et la raison du juge IA ; pour un suivi de zone, les signaux par volet avec leur clé, leur score et leur instantané ; pour une veille pré-marché, les adresses avec leur priorité et leur probabilité. Chaque résultat dit s'il est déjà parti dans une notification du compte. Un crédit par résultat rendu, sauf un résultat déjà livré et débité par un abonnement webhook.
- Coût
- 1 crédit par évènement livré
- Accès
- À l'usage ou avec l'abonnement Data
- Domaine
- Flux d'évènements
question_hub
Question à l'agent du Hub
Une question libre posée à l'agent du Hub, qui raisonne avec Gemini 4 Argon (Google). L'agent enchaîne les opérations de lecture de ce catalogue servies à la clé (portée et palier vérifiés comme pour un appel direct), puis rédige sa réponse ; il rend aussi chaque appel avec son résultat structuré et ses crédits. Chaque opération appelée est facturée à son barème, en plus du prix de la question, dans la limite de plafond_credits : au-delà, l'agent conclut avec ce qu'il a. Avec une clé personnelle, le profil investisseur, la mémoire du compte et le projet désigné entrent dans son contexte.
- Coût
- 120 crédits par appel réussi
- Accès
- À l'usage ou avec l'abonnement Data
- Domaine
- Hub et documents
generer_document
Document mis en forme (PDF ou Word)
Met en forme un document à partir des sections fournies (titres, paragraphes, puces, tableaux, sources) et le rend en PDF ou en Word : rapport, lettre, compte rendu, check-list, note ou comparatif. Aucun modèle de langage : le contenu vient de l'appelant. Le texte entre doubles astérisques est mis en gras dans le Word. La réponse JSON (et le contenu structuré du MCP) décrit le fichier, dont le texte brut sans coordonnées ; le fichier, lui, garde le contenu fourni.
- Coût
- 2 crédits par appel réussi
- Accès
- À l'usage ou avec l'abonnement Data
- Domaine
- Documents
lire_document
Lecture de documents par le modèle
Fait lire par le modèle (Gemini) des documents du client, PDF ou images (diagnostics, procès-verbaux d'assemblée générale, offres, baux, plans), pour répondre à une question : la réponse, les faits relevés avec leur page et une citation, les références datées (échéances, votes). Les fichiers sont reconnus par leurs octets, bornés en taille, transmis à l'API Fichiers de Gemini le temps de la lecture puis effacés (à défaut, Google les efface sous 48 h) ; Pillr n'en garde rien. Le contenu des documents est traité comme une donnée, jamais comme une instruction. Les téléphones, emails et noms précédés d'une civilité sont remplacés par une mention dans la réponse.
- Coût
- 30 crédits par appel réussi
- Accès
- À l'usage ou avec l'abonnement Data
- Domaine
- Documents
audit_portefeuille
Audit d'une liste de biens face au marché
Audite une liste d'annonces suivies, ou les favoris du compte de la clé : prix au m² du bien contre celui du secteur (même type de bien), baisse depuis l'ajout, échéance de la loi Climat, loyer estimé contre loyer de marché, score et rendement, avec des alertes d'arbitrage. Mêmes calculs que l'outil d'audit du Hub. Un crédit par bien audité.
- Coût
- 1 crédit par élément rendu
- Accès
- À l'usage ou avec l'abonnement Data
- Domaine
- Annonces
memoire
Mémoire du compte
Les faits durables retenus sur l'utilisateur de la clé (TMI, apport, stratégie, secteurs, métier), que le Hub et question_hub reprennent dans leur contexte, les plus récents d'abord, avec la TMI et l'apport rangés dans le profil.
- Coût
- 0 crédit par appel réussi
- Accès
- À l'usage ou avec l'abonnement Data
- Domaine
- Compte et personnalisation
memoire_ajouter
Ajouter des faits à la mémoire
Ajoute des faits durables à la mémoire du compte, avec les règles du Hub : dédoublonnage, plafond (le plus ancien sort), refus des données sensibles, d'un contact ou de la donnée d'un tiers nommé, avec leur motif. Une TMI ou un apport reconnus renseignent aussi le profil investisseur.
- Coût
- 0 crédit par appel réussi
- Accès
- À l'usage ou avec l'abonnement Data
- Domaine
- Compte et personnalisation
conversations_hub
Conversations du Hub
Les conversations du Hub de l'utilisateur de la clé, les plus récemment modifiées d'abord, avec leur projet et leur annonce suivie.
- Coût
- 0 crédit par appel réussi
- Accès
- À l'usage ou avec l'abonnement Data
- Domaine
- Hub et documents
conversations_hub_lire
Une conversation du Hub
Une conversation du Hub et ses messages dans l'ordre (les 200 derniers au plus), avec les outils appelés et leurs résultats.
- Coût
- 0 crédit par appel réussi
- Accès
- À l'usage ou avec l'abonnement Data
- Domaine
- Hub et documents
conversations_hub_question
Poursuivre une conversation du Hub
Pose une question qui poursuit une conversation du Hub : l'agent reprend le fil (derniers messages), l'annonce suivie et le projet rattaché, et l'échange est enregistré dans la conversation, lisible sur le site. L'agent enchaîne les opérations de lecture de ce catalogue servies à la clé (portée et palier vérifiés comme pour un appel direct), puis rédige sa réponse ; il rend aussi chaque appel avec son résultat structuré et ses crédits. Chaque opération appelée est facturée à son barème, en plus du prix de la question, dans la limite de plafond_credits : au-delà, l'agent conclut avec ce qu'il a.
- Coût
- 120 crédits par appel réussi
- Accès
- À l'usage ou avec l'abonnement Data
- Domaine
- Hub et documents
conversations_hub_modifier
Renommer, épingler ou rattacher une conversation
Renomme une conversation du Hub, l'épingle ou la désépingle, la rattache à un projet du compte ou l'en détache.
- Coût
- 0 crédit par appel réussi
- Accès
- À l'usage ou avec l'abonnement Data
- Domaine
- Hub et documents
jeux
Catalogue des jeux de données
Le catalogue des jeux que lisent lire_jeu et agreger_jeu, tel que chaque base le déclare (liste blanche des colonnes, relue sur la vue du jeu) : pour chaque jeu, sa description, sa base, sa nature (calculé par Pillr ou public brut), sa maille, sa source et sa licence d'origine, son volume estimé, sa clé de tri, son coût par ligne, la date de ses données quand un journal de chargement la donne, et ses colonnes avec leur type, leur définition, leurs opérateurs de filtre et si elles sont indexées, groupables ou mesurables. GET /jeux/{jeu}/schema rend un seul jeu.
- Coût
- 0 crédit par appel réussi
- Accès
- À l'usage ou avec l'abonnement Data
- Domaine
- Référentiels
lire_jeu
Lecture structurée d'un jeu de données
Les lignes d'un jeu de données, sans SQL : filtre[colonne][operateur]=valeur sur les colonnes filtrables du jeu (eq, in, lt, lte, gt, gte, entre, prefixe, nul ; combinés par « et »), colonnes choisies par champs, pagination par curseur. Un jeu volumineux exige au moins un filtre sur une colonne indexée (schéma du jeu : GET /jeux/{jeu}/schema). Les lignes sont triées par la clé de tri du jeu, en ordre croissant ; aucun autre tri n'est offert. Toute ligne passe le retrait des particuliers : les professionnels sont nommés, un particulier jamais. Un jeu marqué creneau_lourd n'est pas lu de 20h30 à minuit (heure de Paris) ; une lecture trop large pour le délai de la base répond 503 : resserrez les filtres.
- Coût
- 1 crédit par tranche de 10 lignes rendues ; 1 crédit par élément rendu pour un jeu calculé par Pillr
- Accès
- À l'usage ou avec l'abonnement Data
- Domaine
- Jeux de données
agreger_jeu
Agrégats sur un jeu de données
Des agrégats sur un jeu, avec les filtres de lire_jeu : le nombre de lignes de chaque groupe (n, toujours rendu) et des mesures sur les colonnes mesurables (nombre, somme, moyenne, médiane, quantile, minimum, maximum ; médiane et quantiles continus), groupées par 3 colonnes groupables au plus. Les groupes les plus nombreux d'abord, 1000 au plus. Aucun seuil ne masque un groupe : un petit groupe est servi avec son n et le drapeau peu_d_observations. Servi depuis la mémoire seulement de 20h30 à minuit (heure de Paris).
- Coût
- 5 crédits par appel réussi
- Accès
- À l'usage ou avec l'abonnement Data
- Domaine
- Jeux de données
sources
État des sources
L'état des données de Pillr, source par source, lu dans les journaux de chargement : sources publiques rafraîchies par le site (dernier succès, prochaine mise à jour, échecs consécutifs), miroirs des jeux publics au lac (dernier chargement réussi, tranches chargées, en échec et en cours, lignes, période couverte quand les tranches sont datées), balayages des portails sur 7 jours (dernier balayage fini, annonces vues et insérées), collectes des signaux communaux (lignes captées, total de la source et écart) et étages de la chaîne quotidienne ; plus les compteurs de la table des adresses. Chaque source dit ses anomalies constatées (échec, retard au-delà de 36 heures, tranche en échec, écart à la source au-delà de 5 %) ; aucun message d'erreur interne n'est servi.
- Coût
- 0 crédit par appel réussi
- Accès
- À l'usage ou avec l'abonnement Data
- Domaine
- Référentiels
exports
Fichiers complets des jeux
Les éditions des fichiers complets que le contrat de l'organisation ouvre (jeux de son périmètre, droit d'export actif), plus les éditions communes : pour chacune, le jeu, la date d'édition, le format, la taille, le nombre de lignes, l'empreinte SHA-256, la présence du dictionnaire et de la fiche qualité, et le chemin de téléchargement. Seules les éditions dont la volumétrie a été contrôlée avant l'envoi sont listées. Réservé aux contrats ; REST seulement.
- Coût
- 0 crédit par appel réussi
- Accès
- Sur contrat
- Domaine
- Exports
exports_telecharger
Téléchargement d'un fichier complet
Redirige (302) vers le fichier d'une édition, son dictionnaire ou sa fiche qualité, par une adresse présignée valable 15 minutes. Chaque téléchargement est noté. Réservé aux contrats ; REST seulement.
- Coût
- 0 crédit par appel réussi
- Accès
- Sur contrat
- Domaine
- Exports
projets
Projets du compte
Les projets de l'utilisateur de la clé (achat, mandat de vente, location et gestion) : titre, étape, annonce suivie, adresse, faits, échéances, date de clôture et nombre de conversations du Hub rattachées. Les projets ouverts d'abord, puis les plus récemment modifiés.
- Coût
- 0 crédit par appel réussi
- Accès
- À l'usage ou avec l'abonnement Data
- Domaine
- Hub et documents
projets_creer
Créer un projet
Crée un projet dans le compte de l'utilisateur de la clé : type, titre, adresse en texte, annonce suivie. Une clé BAN donnée est rangée dans les faits du projet. Le Hub réinjecte le projet dans chaque conversation qui lui est rattachée.
- Coût
- 0 crédit par appel réussi
- Accès
- À l'usage ou avec l'abonnement Data
- Domaine
- Hub et documents
projets_lire
Un projet et son contexte
Un projet du compte avec son contexte : les derniers évènements datés de son fil, les textes longs rangés (modèles de courrier, textes de boîtage) et les conversations du Hub qui lui sont rattachées.
- Coût
- 0 crédit par appel réussi
- Accès
- À l'usage ou avec l'abonnement Data
- Domaine
- Hub et documents
projets_modifier
Modifier ou clore un projet
Modifie un projet du compte : titre, étape, adresse, faits (fusionnés, hors des clés réservées textes et urbanisme), échéances personnelles, clôture ou réouverture, et suivi d'un dépôt d'urbanisme (démarche revalidée et échéances calculées par le moteur du site, jamais reçues).
- Coût
- 0 crédit par appel réussi
- Accès
- À l'usage ou avec l'abonnement Data
- Domaine
- Hub et documents
projets_textes_ajouter
Ranger un texte dans un projet
Range un texte long dans un projet (modèle de courrier, texte de boîtage) : même préparation que le site, coordonnées remplacées par une mention, données sensibles refusées, dédoublonnage et plafond de textes par projet. Le Hub le réinjecte dans les conversations du projet.
- Coût
- 0 crédit par appel réussi
- Accès
- À l'usage ou avec l'abonnement Data
- Domaine
- Hub et documents
projets_textes_retirer
Retirer un texte d'un projet
Retire d'un projet le texte désigné par son empreinte. Retirer un texte absent ne change rien.
- Coût
- 0 crédit par appel réussi
- Accès
- À l'usage ou avec l'abonnement Data
- Domaine
- Hub et documents
briefs_programmes
Requêtes programmées du compte
Les questions programmées du compte : rythme, état actif ou en pause, erreurs consécutives (trois mettent la requête en pause), dernier et prochain passage.
- Coût
- 0 crédit par appel réussi
- Accès
- À l'usage ou avec l'abonnement Data
- Domaine
- Hub et documents
briefs_programmes_resultats
Briefs rédigés
Les briefs rédigés pour le compte par ses requêtes programmées, les plus récents d'abord : texte en Markdown, statut, jetons consommés. Le détail des outils appelés se lit par brief.
- Coût
- 0 crédit par appel réussi
- Accès
- À l'usage ou avec l'abonnement Data
- Domaine
- Hub et documents
briefs_programmes_resultat
Un brief et ses résultats d'outils
Un brief rédigé, avec le résultat structuré de chaque outil que l'agent du Hub a appelé pour l'écrire.
- Coût
- 0 crédit par appel réussi
- Accès
- À l'usage ou avec l'abonnement Data
- Domaine
- Hub et documents
profil_investisseur
Profil investisseur du compte
La thèse d'investissement de l'utilisateur de la clé, que le Hub, les briefs, les notifications et les recommandations réutilisent : stratégie, budgets et apport, zones, critères, objectifs, TMI, profil professionnel et préférences de notification.
- Coût
- 0 crédit par appel réussi
- Accès
- À l'usage ou avec l'abonnement Data
- Domaine
- Compte et personnalisation
profil_investisseur_modifier
Modifier le profil investisseur
Crée ou met à jour le profil investisseur de l'utilisateur de la clé, champ par champ : seuls les champs fournis changent, mêmes bornes que le formulaire du site. Rend le profil à jour.
- Coût
- 0 crédit par appel réussi
- Accès
- À l'usage ou avec l'abonnement Data
- Domaine
- Compte et personnalisation
favoris
Favoris du compte
Les biens suivis par l'utilisateur de la clé, les plus récents d'abord : le bien et son analyse à la date de l'ajout, complétés par l'annonce telle qu'elle est aujourd'hui (prix actuel, DPE, en ligne ou non).
- Coût
- 0 crédit par appel réussi
- Accès
- À l'usage ou avec l'abonnement Data
- Domaine
- Compte et personnalisation
favoris_ajouter
Ajouter un favori
Met une annonce du catalogue en favori, par son identifiant ou son lien : le bien et son analyse du jour sont gardés comme sur le site. Ajouter deux fois la même annonce rend le favori existant.
- Coût
- 0 crédit par appel réussi
- Accès
- À l'usage ou avec l'abonnement Data
- Domaine
- Compte et personnalisation
favoris_retirer
Retirer un favori
Retire un favori du compte. Retirer un favori absent ne change rien.
- Coût
- 0 crédit par appel réussi
- Accès
- À l'usage ou avec l'abonnement Data
- Domaine
- Compte et personnalisation
recommandations
Annonces recommandées pour le compte
Des annonces actives et analysées choisies pour l'utilisateur de la clé, avec les règles de la page du site : d'après les motifs de ses favoris (ville, type, budget et surface autour de leur moyenne), sinon d'après la stratégie de son profil investisseur, sinon les meilleurs scores du catalogue. Les motifs retenus sont rendus avec les annonces.
- Coût
- 1 crédit par élément rendu
- Accès
- À l'usage ou avec l'abonnement Data
- Domaine
- Annonces
notifications
Notifications du compte
Les signaux détectés chaque matin sur ce que suit l'utilisateur de la clé : baisse de prix d'un favori (price_drop), annonce sur-cotée en ligne depuis plus de soixante jours sans baisse (nego_opportunity), valorisation possible après des travaux raisonnables (post_works_profit), prix en baisse dans une commune suivie (zone_trend). Les plus récentes d'abord, les écartées exclues sauf demande. Le scan ne tourne que pour les comptes qui ont un profil investisseur.
- Coût
- 1 crédit par évènement livré
- Accès
- À l'usage ou avec l'abonnement Data
- Domaine
- Flux d'évènements
notifications_modifier
Marquer une notification
Marque une notification du compte comme lue ou non lue, écartée ou non. Le même appel deux fois laisse le même état.
- Coût
- 0 crédit par appel réussi
- Accès
- À l'usage ou avec l'abonnement Data
- Domaine
- Flux d'évènements