> ## Documentation Index
> Fetch the complete documentation index at: https://docs.immoteur.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Choisir une ressource API

> Choisissez l’endpoint annonce, propriété, lookup ou recherche adapté à votre identifiant et à votre besoin

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`                                              |

```mermaid theme={null}
flowchart TD
  A[Information disponible] -->|Identifiant d’annonce| B[Obtenir une annonce par ID]
  A -->|Identifiant de propriété| C[Obtenir une propriété par ID]
  A -->|URL d’annonce| D[Endpoint de lookup]
  A -->|Ressource associée| E[Endpoint de relation]
  A -->|Filtres| F[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](./synchroniser-annonces-immobilieres).

## 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é.

```bash theme={null}
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](./fiabilite-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.