Définition
Une API (Application Programming Interface) immobilière est un service qui expose des données immobilières (annonces, mandats, leads) sous forme normalisée et programmable. Elle remplace les anciens exports XML "statiques" par un accès dynamique, requête par requête.
À quoi ça sert
- Alimenter un site web automatiquement
- Alimenter une application mobile
- Faire des intégrations sur mesure (CRM ↔ CRM, ERP, BI)
- Construire un comparateur ou un portail vertical
- Exposer des données publiques (DVF, marché)
L'API Ts-Immo en bref
L'API Ts-Immo expose en JSON REST tous les biens, leads et données DVF des passerelles enregistrées. Vous interrogez une seule API — quel que soit le CRM en amont.
Exemple
curl https://api.ts-immo.org/v1/gateway/public/properties/mon-agenceEndpoints principaux
| Endpoint | Description |
|---|---|
| GET /v1/gateway/properties | Liste de tous les biens (auth) |
| GET /v1/gateway/properties/:id | Détail d'un bien |
| GET /v1/gateway/public/properties/:slug | Biens publics d'une agence |
| POST /v1/gateway/leads | Créer un lead |
| GET /v1/gateway/public/dvf | Données DVF (transactions publiques) |
Cas d'usage typiques
- Site Next.js avec ISR consommant l'API toutes les 10 minutes
- Application mobile React Native qui interroge l'API à chaque ouverture
- Site WordPress qui sync via le plugin Ts-Immo Sync (qui consomme l'API en interne)
- Comparateur d'annonces qui agrège plusieurs agences