Documentation

ImmoWP API & intégrations

LLM / AI agents

ImmoWP expose des artefacts standard pour que les agents (Cursor, ChatGPT, Claude, codegen) comprennent l’API sans scraping HTML.

Fichiers à charger

URLUsage
https://www.immowp.fr/llms.txtIndex compact (spec llms.txt)
https://www.immowp.fr/llms-full.txtDocumentation complète plain text
https://www.immowp.fr/openapi.jsonOpenAPI 3.1 machine-readable
https://api.immowp.com/v1Discovery JSON live

Prompt système recommandé

You are integrating ImmoWP real-estate listings API.
Base URL: https://api.immowp.com
Auth: header "Key: <api_key>" OR "Authorization: Bearer <api_key>"
Required query params on authenticated routes: crm, client
Preferred endpoints: GET /v1/properties, GET /v1/status, GET /v1/connectors
Docs: https://www.immowp.fr/docs
OpenAPI: https://www.immowp.fr/openapi.json
Never expose api keys in browser code. Use server-side fetch only.
Property fields are French camelCase (affId, affNum, intitule, prix, surfaceHabitable…).

Exemple d’appel pour un agent

# 1. Discover
GET https://api.immowp.com/v1

# 2. List connectors
GET https://api.immowp.com/v1/connectors

# 3. Fetch properties (server-side)
GET https://api.immowp.com/v1/properties?crm={crm}&client={client}&page=1&per_page=50
Headers: Key: {api_key}

Meerweb

Les sites générés par Meerweb doivent consommer la même API ImmoWP (pas une seconde API CRM). Le BFF Next.js de Meerweb appelle api.immowp.com avec la clé de la passerelle provisionnée.

robots.txt

Les crawlers peuvent découvrir llms.txt via le robots et le sitemap documentation.