Skip to main content
Immoteur centralizes residential and commercial classifieds from leading French portals, normalizes the data, and distributes it to your products in near real time. The public API provides a webhook for incremental change delivery, plus endpoints for per‑resource retrieval and property search.

​
Core capabilities

  • Real-time alerts: Subscribe to classified events via webhook to react to new, updated, or removed listings as they happen.
  • Account introspection: Call /auth with your token to verify credentials, see token metadata, and confirm the scopes attached to your account.
  • Property search: Query aggregated properties with filters (geography, price, type, features) via POST /properties/search; results are paginated for efficient browsing.
  • Per‑ID lookups: Retrieve a single resource with GET /classifieds/{id} or GET /properties/{id}. Traverse relations with GET /classifieds/{id}/property and GET /properties/{id}/classifieds.

​
Data freshness & access limits

Behind the scenes Immoteur enriches classifieds with geocoding, energy performance, and publisher metadata. Responses always honor the meta.dataAccessLimit block returned by the API so you only receive data your contract allows. Combine these limits with explicit query filters (departments, SIREN/SIRET, property types) for predictable coverage and fewer surprises.

​
Getting started

  1. Generate a personal access token and align data accesses with your agreement in the configuration guide.
  2. Validate the token with curl -sS https://api.immoteur.com/public/v1/auth -H "Authorization: Bearer $IMMOTEUR_TOKEN".
  3. Start with the webhook for listing deltas; complement with per‑ID endpoints and property search as needed.
Need more detail? Open the OpenAPI schema in the sidebar for live request and response examples. Let us know at contact@immoteur.com if you need an additional source, filter, or language feed.