Skip to main content
Utilisez l’API publique Immoteur pour vérifier les accès de votre intégration, récupérer des annonces ou des biens immobiliers, puis recevoir des mises à jour par webhook. Dans l’API, un classified est une annonce source ; une property regroupe une ou plusieurs annonces qui décrivent le même bien immobilier.

​
Choisissez votre point de départ

  • Envoyez votre première requête. Créez un token, appelez GET /auth et vérifiez les accès de votre intégration dans le Démarrage rapide.
  • Choisissez une ressource API. À partir d’un identifiant, d’une URL d’annonce ou de filtres, sélectionnez l’endpoint de consultation, de relation ou de recherche dans Choisir une ressource API.
  • Recevez les mises à jour. Configurez un webhook dans API → Webhooks dans le dashboard lorsque votre service a besoin de notifications d’annonces plutôt que de polling, puis consultez Configurer les webhooks.
  • Synchronisez les annonces sélectionnées. Créez une copie locale avec un baseline complet, des mises à jour en direct et une réconciliation delta dans Synchroniser les annonces.

​
Ce que propose l’API publique

  • Appelez GET /auth pour valider un token et consulter ses métadonnées.
  • Récupérez une annonce source avec GET /classifieds/{id} ou un bien immobilier regroupé avec GET /properties/{id}.
  • Retrouvez l’une ou l’autre ressource à partir d’une URL d’annonce avec GET /classifieds/lookup?url=... ou GET /properties/lookup?url=....
  • Utilisez les endpoints de relation existants lorsque vous avez besoin de la ressource associée.
  • Recherchez des biens immobiliers avec POST /properties/search.
  • Recevez des notifications d’annonces et des exports d’annonces par webhook.

​
Data access

Les réponses appliquent le meta.dataAccessLimit associé à votre token. Consultez-le dans la réponse de /auth et combinez-le avec les filtres explicites disponibles sur l’endpoint. Configurez vos tokens et vos data access dans Tokens API et accès aux données. Ouvrez la référence API générée dans la barre latérale pour les paramètres, les schémas de payload et les exemples disponibles.