Choisir une ressource API

Choisissez l’endpoint selon les informations déjà disponibles dans votre intégration. La référence API générée reste la source pour les paramètres et les schémas de réponse.

Sélectionnez un endpoint

Vous avez ou recherchez	Utilisez
Un identifiant d’annonce	`GET /classifieds/{id}`
Un identifiant de propriété	`GET /properties/{id}`
Une URL d’annonce	L’endpoint de lookup d’annonce ou de propriété
La ressource associée	`GET /classifieds/{id}/property` ou `GET /properties/{id}/classifieds`
Un ensemble filtré de propriétés	`POST /properties/search`

Utilisez un endpoint de récupération directe lorsque vous connaissez déjà un identifiant. Utilisez lookup lorsque vous avez une URL d’annonce. Utilisez la recherche de propriétés lorsque vous avez besoin d’un ensemble de propriétés filtré et paginé. Pour maintenir une copie locale du flux d’annonces sélectionné plutôt que de consulter une ressource à la fois, utilisez Synchroniser les annonces.

Recherchez des propriétés

Le corps de requête requiert page, transactionType et propertyTypes. Ajoutez des filtres optionnels uniquement lorsqu’ils correspondent au résultat recherché.

curl --fail-with-body --show-error --silent \
  'https://api.immoteur.com/public/v1/properties/search' \
  -H "Authorization: Bearer $IMMOTEUR_TOKEN" \
  -H 'Content-Type: application/json' \
  --data '{
    "page": 1,
    "transactionType": "sale",
    "propertyTypes": ["apartment"],
    "locationDepartments": ["75"]
  }'

Si une requête est refusée ou limitée, consultez Fiabilité de l’API. Ouvrez la référence API générée pour les paramètres de lookup et les schémas de réponse exacts.

Démarrer

API

Webhooks

Référence OpenAPI

Choisir une ressource API

Sélectionnez un endpoint

Recherchez des propriétés

​Sélectionnez un endpoint

​Recherchez des propriétés

Sélectionnez un endpoint

Recherchez des propriétés