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

# Choose an API resource

> Choose a classified, property, lookup, or search endpoint from the identifier and result you need

Choose the endpoint from the information already available to your integration. The generated API reference remains the source for parameters and response schemas.

## Select an endpoint

| You have or need             | Use                                                                    |
| ---------------------------- | ---------------------------------------------------------------------- |
| A classified identifier      | `GET /classifieds/{id}`                                                |
| A property identifier        | `GET /properties/{id}`                                                 |
| A listing URL                | The classified or property lookup endpoint                             |
| The associated resource      | `GET /classifieds/{id}/property` or `GET /properties/{id}/classifieds` |
| A filtered set of properties | `POST /properties/search`                                              |

```mermaid theme={null}
flowchart TD
  A[Available information] -->|Classified ID| B[Get classified by ID]
  A -->|Property ID| C[Get property by ID]
  A -->|Listing URL| D[Lookup endpoint]
  A -->|Associated resource| E[Relation endpoint]
  A -->|Filters| F[POST /properties/search]
```

Use a direct retrieval endpoint when you already know an identifier. Use lookup when you have a listing URL. Use property search when you need a filtered, paginated set of properties.

To maintain a local copy of the selected classified stream instead of querying one resource at a time, use [Mirror classified data](./mirror-classified-data).

## Search properties

The request body requires `page`, `transactionType`, and `propertyTypes`. Add optional filters only when they match the result you need.

```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"]
  }'
```

If a request is rejected or limited, see [API reliability](./api-reliability). Open the generated API reference for the exact lookup parameters and response schemas.