REST + JSON, JWT bearer, OpenAPI 3 complet. Zéro magie, zéro fluff. Juste ce qu'il faut pour brancher votre CRM ou app mobile.
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_xxxxxxxxxxxxxxxxxxRé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 invalide403 — scope insuffisant429 — limite de débit atteinte (réessayez dans 60s)5xx — incident côté Immozil. Voir /status.Une question d'intégration ?
L'équipe API répond en moins de 24 h ouvrées.