Choose an API resource

Choose the endpoint from the information already available to your integration. A classified is a source listing; a property groups listings for the underlying real-estate asset. 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	`GET /classifieds/lookup?url=...` or `GET /properties/lookup?url=...`
The associated resource	`GET /classifieds/{id}/property` or `GET /properties/{id}/classifieds`
A filtered set of properties	`POST /properties/search`

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

Look up a listing or property from its URL

Choose the lookup based on the resource your integration needs. Provide the listing URL through the url query parameter. Use GET /classifieds/lookup to retrieve the source listing, or use GET /properties/lookup to retrieve the grouped property associated with that listing.

curl --fail-with-body --show-error --silent \
  --get 'https://api.immoteur.com/public/v1/classifieds/lookup' \
  -H "Authorization: Bearer $IMMOTEUR_TOKEN" \
  --data-urlencode 'url=https://www.example.com/listings/123'

curl --fail-with-body --show-error --silent \
  --get 'https://api.immoteur.com/public/v1/properties/lookup' \
  -H "Authorization: Bearer $IMMOTEUR_TOKEN" \
  --data-urlencode 'url=https://www.example.com/listings/123'

To maintain a local copy of the selected classified stream instead of querying one resource at a time, use Mirror classified data.

Search properties

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

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

Continue through property search results

Read meta.nextPage from each POST /properties/search response. When it contains a page number, send the same search request with that value as page. Stop when meta.nextPage is null. If a request is rejected or limited, see API reliability. Open the generated API reference for the exact lookup parameters and response schemas.

Start

API

Webhooks

OpenAPI reference

Choose an API resource

Select an endpoint

Look up a listing or property from its URL

Search properties

Continue through property search results

​Select an endpoint

​Look up a listing or property from its URL

​Search properties

​Continue through property search results

Select an endpoint

Look up a listing or property from its URL

Search properties

Continue through property search results