Passer au contenu principal
Immoteur centralise les annonces immobilières résidentielles et tertiaires issues des principaux portails français, les normalise et les enrichit avant de les mettre à disposition de vos équipes en quasi‑temps réel. L’API publique propose un webhook pour recevoir des deltas, ainsi que des endpoints pour les consultations par identifiant et la recherche de propriétés.

​
Fonctionnalités clés

  • Alertes en temps réel : Abonnez‑vous aux événements du webhook pour réagir aux créations, mises à jour et suppressions dès leur émission.
  • Vérification du compte : Appelez /auth avec votre token pour vérifier vos identifiants, consulter les métadonnées du token et confirmer les scopes associés.
  • Recherche de propriétés : Interrogez des propriétés agrégées avec des filtres (géographie, prix, type, attributs) via POST /properties/search ; les résultats sont paginés.
  • Consultations par identifiant : Récupérez une ressource avec GET /classifieds/{id} ou GET /properties/{id}. Suivez les relations avec GET /classifieds/{id}/property et GET /properties/{id}/classifieds.

​
Fraîcheur des données & limites d’accès

Immoteur enrichit les annonces avec la géolocalisation, la performance énergétique et des informations éditeur. Chaque réponse inclut le bloc meta.dataAccessLimit renvoyé par l’API, qui garantit que vous ne recevez que les données prévues par votre contrat. Combinez ces limites avec des filtres explicites (départements, SIREN/SIRET, types de bien) pour une couverture prévisible et maîtrisée.

​
Premiers pas

  1. Générez un token d’accès personnel et alignez vos accès aux données avec votre accord dans le guide de configuration.
  2. Validez le token avec curl -sS https://api.immoteur.com/public/v1/auth -H "Authorization: Bearer $IMMOTEUR_TOKEN".
  3. Démarrez avec la référence du webhook pour les deltas ; complétez avec les endpoints par identifiant et la recherche de propriétés si besoin.
Besoin de détails supplémentaires ? Ouvrez le schéma OpenAPI dans la barre latérale pour consulter les exemples de requêtes et de réponses. Écrivez-nous à contact@immoteur.com pour demander une source, un filtre ou un flux linguistique supplémentaire.