Documentation

ImmoWP API & intégrations

Démarrage rapide

Vous avez besoin d’une clé API, d’un identifiant client (slug) et du code crm (ex. apimo, hektor). Contactez le support si vous ne les avez pas.

1. Discovery (sans auth)

curl -s https://api.immowp.com/v1 | jq

2. Liste des connecteurs

curl -s https://api.immowp.com/v1/connectors | jq

3. Statut de la passerelle

curl -s "https://api.immowp.com/v1/status?crm=apimo&client=VOTRE_CLIENT" \
  -H "Key: VOTRE_CLE_API" | jq

# Équivalent Bearer :
curl -s "https://api.immowp.com/v1/status?crm=apimo&client=VOTRE_CLIENT" \
  -H "Authorization: Bearer VOTRE_CLE_API" | jq

4. Liste paginée des biens

curl -s "https://api.immowp.com/v1/properties?crm=apimo&client=VOTRE_CLIENT&page=1&per_page=20" \
  -H "Key: VOTRE_CLE_API" | jq

5. Détail d’un bien

curl -s "https://api.immowp.com/v1/properties/REF-123?crm=apimo&client=VOTRE_CLIENT" \
  -H "Key: VOTRE_CLE_API" | jq

L’identifiant peut être affId ou affNum.

Réponse type (liste)

{
  "status": "ok",
  "data": [ { "affId": "...", "affNum": "...", "intitule": "...", "prix": "350000", ... } ],
  "meta": {
    "page": 1,
    "per_page": 20,
    "total": 87,
    "total_pages": 5,
    "crm": "apimo",
    "client": "VOTRE_CLIENT"
  },
  "request_id": "a1b2c3d4e5f6"
}

Suite