Estimation immobilière en ligne basée sur DVF + IA
Convertissez vos visiteurs en leads qualifiés grâce à un module d'estimation instantané, alimenté par les transactions DVF officielles et un moteur IA contextualisé. Intégrable en quelques minutes via le SDK Next.js officiel@ts-services-org/ts-estimationou via un shortcode WordPress.
Inclus dans les plans Pro et Network. 100 estimations / jour incluses, surcoût 0,30 € au-delà.
Étape 2/4
Caractéristiques du bien
Estimation centrale
487 000 €
7 492 €/m² · Confiance HIGH
Le formulaire de contact qui convertit le plus
Un module d'estimation convertit 5 à 15 % des visiteurs en leads qualifiés, contre < 1 % pour un formulaire de contact générique.
Moteur IA contextualisé
Score IA basé sur DVF + caractéristiques du bien + état (toiture, isolation, électricité…). Commentaire en langage naturel généré pour le visiteur.
Données DVF officielles
Ts-Immo ingère le dataset DVF (Demandes de Valeurs Foncières) et croise les mutations réelles du secteur avec le bien à estimer.
Granularité commune + IRIS
L'estimation pondère par commune et îlot IRIS. Vous obtenez une fourchette adaptée au micro-marché local, pas une moyenne nationale.
Rapport travaux & risques
Le SDK retourne un works_report (toiture, isolation, électricité…) et un risks_report Géorisques exploitables dans votre UI.
RGPD & loi Hoguet
Consentement explicite, durée de conservation paramétrable, hébergement France. Conforme aux obligations professionnelles.
SDK Next.js officiel
Hook React, composants prêts à l'emploi, et client bas niveau pour Route Handler / Server Action. Types TypeScript fournis.
Le module en conditions réelles
Voici l'intégration officielle @ts-services-org/ts-estimation embarquée directement sur ce site. Les composants EstimationForm et EstimationResult sont fournis par le paquet npm — aucun design custom ici.
Un formulaire en 4 étapes
Le module mène le visiteur du type de bien jusqu'à la capture de lead, étape par étape, en moins de 90 secondes.
01
Type & adresse
Bien, marché, code postal. Géocodage automatique.
02
Caractéristiques
Surface, pièces, étage, exposition, DPE.
03
État & travaux
Toiture, isolation, menuiserie, électricité, amiante.
04
Lead & résultat
Contact + estimation centrale + fourchette + commentaire IA.
SDK officiel @ts-services-org/ts-estimation
Un paquet npm publié sur GitHub Packages, qui expose un hook React, deux composants UI et un client bas niveau typé en TypeScript.
Hook React
useEstimation() gère le cycle loading / data / error. À combiner avec EstimationForm et EstimationResult.
Client bas niveau
TsEstimationClient à instancier dans une Server Action ou une Route Handler pour garder votre clé API côté serveur.
Types TypeScript
Tous les types métier sont exportés : EstimationRequest, EstimationResponse, WorksReport, RisksReport, etc.
1. Installation
Le paquet est publié sur GitHub Packages. Configurez un NPM_TOKEN GitHub avec la permission read:packages puis ajoutez un fichier .npmrc à la racine du projet.
npm install @ts-services-org/ts-estimation# .npmrc
//npm.pkg.github.com/:_authToken=${NPM_TOKEN}
@ts-services-org:registry=https://npm.pkg.github.com2. Hook useEstimation (intégration rapide)
Branchez directement le hook sur les composants fournis par le paquet — vous obtenez un module complet en moins de 30 lignes.
'use client'
import {
useEstimation,
EstimationForm,
EstimationResult,
} from '@ts-services-org/ts-estimation'
export default function EstimationPage() {
const { data, loading, error, estimate, reset } = useEstimation({
apiToken: process.env.NEXT_PUBLIC_TSIMMO_API_TOKEN!,
agencySlug: process.env.NEXT_PUBLIC_TSIMMO_AGENCY_SLUG!,
})
return (
<div>
{!data ? (
<EstimationForm onSubmit={estimate} loading={loading} withLeadCapture />
) : (
<EstimationResult data={data} onReset={reset} />
)}
{error && <p style={{ color: 'red' }}>{error}</p>}
</div>
)
}⚠️ Les variables NEXT_PUBLIC_* sont exposées au navigateur. En production, préférez le pattern Server Action / Route Handler ci-dessous pour garder la clé côté serveur.
3. Route Handler (recommandé pour la production)
Le client formulaire envoie sa requête à votre Route Handler, qui utilise TsEstimationClient côté serveur avec votre clé API privée.
// app/api/estimate/route.ts
import { NextRequest, NextResponse } from 'next/server'
import { TsEstimationClient } from '@ts-services-org/ts-estimation'
export async function POST(req: NextRequest) {
const body = await req.json()
const client = new TsEstimationClient({
apiToken: process.env.TSIMMO_API_TOKEN!, // serveur uniquement
agencySlug: process.env.TSIMMO_AGENCY_SLUG!,
})
const result = await client.estimate(body)
return NextResponse.json(result)
}4. Client bas niveau — usage complet
Exemple complet d'estimation avec capture de lead, diagnostic rénovation et commentaire IA. La réponse contient toutes les données métier exploitables.
import { TsEstimationClient } from '@ts-services-org/ts-estimation'
const client = new TsEstimationClient({
apiToken: process.env.TSIMMO_API_TOKEN!,
agencySlug: process.env.TSIMMO_AGENCY_SLUG!,
})
const result = await client.estimate({
property_type: 'apartment',
offer_type: 'sale',
liveable_area_sqm: 65,
postal_code: '75011',
city: 'Paris',
rooms: 3,
epc_category: 'D',
general_condition: 'good',
heating_type: 'heat_pump',
renovation_diagnostic: {
insulation: 'FAIR',
joinery: 'TO_REDO',
},
with_commentary: true,
lead: {
first_name: 'Marie',
last_name: 'Dupont',
email: 'marie@example.com',
project_timeframe_months: 6,
},
})
console.log(result.central.total) // 487 000
console.log(result.central.price_per_sqm) // 7 492
console.log(result.confidence.level) // "HIGH"
console.log(result.adjustments[0].percent) // 0.03 (= +3 %)
console.log(result.works_report?.total_cost_max) // 38 400
console.log(result.metadata.commentary) // "Situé dans le 11e…"Questions fréquentes
Sur quelles données le module se base-t-il ?+
Le moteur d'estimation combine les transactions publiques DVF (Demandes de Valeurs Foncières), les caractéristiques saisies par l'utilisateur, et le diagnostic de rénovation. Un addon `ESTIMATION_IA` ajoute un score IA contextualisé et un commentaire en langage naturel.
Comment intégrer le module dans un site Next.js ?+
Installez le SDK officiel : `npm install @ts-services-org/ts-estimation`. Le paquet expose un hook React `useEstimation`, deux composants prêts à l'emploi (`EstimationForm`, `EstimationResult`) et un client bas niveau `TsEstimationClient` à utiliser côté serveur (Server Action ou Route Handler) pour protéger votre clé API.
Le paquet est sur quel registre ?+
Sur GitHub Packages, sous l'organisation `@ts-services-org`. Il vous faut un `NPM_TOKEN` GitHub avec la permission `read:packages` dans un fichier `.npmrc` à la racine du projet.
Combien d'estimations par jour sont autorisées ?+
Le quota par défaut est de 100 estimations / jour / passerelle (paramètre `dailyQuota` de l'addon, ajustable, `-1` = illimité). Les dépassements renvoient un `HTTP 429 quota_exceeded`. Les estimations en dépassement sont facturables (0,30 € par défaut).
Le module est-il intégrable sur WordPress ?+
Oui. Le plugin Ts-Immo Sync inclut un shortcode `[ts-immo-estimation]` qui injecte le formulaire complet sur n'importe quelle page WordPress. Les leads remontent dans `/v1/gateway/leads`.
Les leads sont-ils RGPD-conformes ?+
Oui. Le formulaire inclut le consentement explicite, et les données sont stockées en France avec une durée de conservation paramétrable.
Faut-il une carte professionnelle pour utiliser le module ?+
Non pour l'usage du module. En revanche, l'agence qui exploite les leads pour proposer une transaction doit disposer d'une carte professionnelle conforme à la loi Hoguet.
Quel est le taux de transformation typique d'un module d'estimation ?+
Selon les benchmarks immobiliers, un formulaire d'estimation en ligne convertit 5 à 15 % des visiteurs intéressés en leads qualifiés (vs. < 1 % pour un formulaire de contact générique).