Intégrez le catalogue
en 5 minutes.

Connectez-vous à votre espace Pro puis Clés API. Choisissez les scopes minimaux dont vous avez besoin.

Le secret n'est affiché qu'une seule fois. Stockez-le dans votre coffre, pas dans Git.

# Le secret a la forme :
imz_AB12CD34_<random>

# Conservez-le dans une variable d'environnement
export IMMOZIL_API_TOKEN=imz_AB12CD34_xxxxxxxxxxxxxxxxxx

Récupérer 20 annonces publiées :

curl 'https://api.immozil.com/v1/partner/v1/properties?perPage=20' \
  -H "Authorization: Bearer $IMMOZIL_API_TOKEN" \
  -H 'Accept: application/json'

Réponse :

{
  "data": [
    {
      "id": "…", "reference": "IMZ-AB12CD",
      "slug": "appartement-maarif-imz-ab12cd",
      "title": { "fr": "Appartement…", "en": "…" },
      "price": 1850000, "currency": "MAD",
      "areaBuilt": 100, "rooms": 3, "bathrooms": 2,
      "publishedAt": "2026-04-12T08:42:00Z"
    }
  ]
}

• properties:readListe + détail des annonces publiées.
• properties:writeCréation/MAJ d'annonces (clé liée à une agence).
• leads:readInbox leads de votre agence.
• agencies:readProfil agence.
• analytics:readMétriques de performance.

Limite par défaut : 60 req/min par clé. Tunable lors de la création. Au-delà, le serveur renvoie 429.

Toutes les erreurs suivent application/problem+json :

{
  "type":   "about:blank",
  "title":  "Forbidden",
  "status": 403,
  "detail": "Missing scope: leads:read"
}

• 401 — clé manquante ou invalide
• 403 — scope insuffisant
• 429 — limite de débit atteinte (réessayez dans 60s)
• 5xx — incident côté Immozil. Voir /status.