API · v1

API Lotissements MCLU

Accès aux données consolidées des 4 000+ lotissements MCLU sur demande. L'API n'est plus librement accessible — contactez Capital Foncier pour un accès professionnel.

Accès professionnel sur demande

L'API publique est en pause. Tout usage (commercial, recherche, intégration tierce) requiert désormais un accès professionnel négocié. Volumes, tarifs et conditions ajustés selon le cas d'usage.

Contacter Capital Foncier Formulaire de contact

Réponse 503 (Service Unavailable) renvoyée sur les endpoints tant que cette page indique « accès sur demande ».

4 000+ lotissements

Couvrant 1965 à aujourd'hui, mis à jour chaque semaine

Cacheable

CDN s-maxage 5 min, stale-while-revalidate 10 min

60 req/min/IP

Rate-limit sliding-window via Upstash Redis

Endpoints

GET/api/public/v1/lotissements

Liste paginée avec filtres.

Query parameters

commune	string	Filtre exact (insensitive)
statut	enum	APPROUVE \| ANNULE \| EN_SURSIS \| EN_INSTANCE \| INCONNU
q	string	Recherche full-text sur nom + commune
page	number	1-500 (défaut 1)
pageSize	number	1-100 (défaut 50)

Exemple

curl "https://www.capital-foncier.com/api/public/v1/lotissements?commune=Cocody&statut=APPROUVE&pageSize=10"

GET/api/public/v1/lotissements/[slug]

Détail d'un lotissement avec historique des changements de statut.

Query parameters

slug

string

Identifiant URL-safe (ex: 'riviera-palmeraie-2019-cocody')

Exemple

curl "https://www.capital-foncier.com/api/public/v1/lotissements/riviera-palmeraie-2019-cocody"

GET/api/public/v1/lotissements.csv

Export CSV complet (jusqu'à 10 000 lignes), filtres identiques à la liste JSON. UTF-8 BOM pour Excel.

Query parameters

commune	string	Filtre exact (insensitive)
statut	enum	APPROUVE \| ANNULE \| EN_SURSIS \| EN_INSTANCE \| INCONNU
q	string	Recherche full-text sur nom + commune

Exemple

curl -O "https://www.capital-foncier.com/api/public/v1/lotissements.csv?commune=COCODY&statut=APPROUVE"

Format de réponse

Toutes les réponses sont au format JSON et incluent une section attribution citant la source primaire (MCLU).

{
  "api": { "version": "v1", "endpoint": "lotissements" },
  "attribution": {
    "primarySource": "Ministère de la Construction... (MCLU)",
    "primaryUrl": "https://construction.gouv.ci/mclulotissement",
    "publisher": "Capital Foncier",
    "license": "Données publiques. Attribution requise pour réutilisation.",
    "lastSync": "2026-04-25T03:00:00.000Z"
  },
  "pagination": { "page": 1, "pageSize": 50, "total": 4044, "totalPages": 81 },
  "filters": { "commune": null, "statut": null, "q": null },
  "data": [
    {
      "id": "ckxxxxx",
      "slug": "riviera-palmeraie-2019-cocody",
      "nom": "RIVIERA PALMERAIE",
      "commune": "COCODY",
      "departement": "ABIDJAN",
      "annee": 2019,
      "statut": "APPROUVE",
      "arreteReference": "117/MCU/DUA du 15/03/2019",
      "arreteDate": "2019-03-15T00:00:00.000Z",
      "url": "https://www.capital-foncier.com/outils/lotissements/riviera-palmeraie-2019-cocody"
    }
  ]
}

Attribution obligatoire

Si vous réutilisez ces données, vous devez créditer à la fois la source primaire (MCLU) et l'éditeur (Capital Foncier). Exemple :

Source: MCLU (construction.gouv.ci/mclulotissement)
Éditeur: Capital Foncier (capital-foncier.com)

Rate limit

Endpoint liste : 60 req/min/IP (sliding window)
Endpoint détail : 120 req/min/IP
Export CSV : 10 req/min/IP (charge plus lourde)
En cas de dépassement : HTTP 429 + header Retry-After: 60
Headers retournés à chaque requête : X-RateLimit-Remaining, X-RateLimit-Reset

Besoin d'un volume plus important ?

Pour les usages institutionnels (collectivités, BE, agences immobilières) ou les volumes au-delà du rate-limit standard, contactez-nous pour discuter d'un accès dédié.

Contacter l'équipe

Chargement...

{ "api": { "version": "v1", "endpoint": "lotissements" }, "attribution": { "primarySource": "Ministère de la Construction... (MCLU)", "primaryUrl": "https://construction.gouv.ci/mclulotissement", "publisher": "Capital Foncier", "license": "Données publiques. Attribution requise pour réutilisation.", "lastSync": "2026-04-25T03:00:00.000Z" }, "pagination": { "page": 1, "pageSize": 50, "total": 4044, "totalPages": 81 }, "filters": { "commune": null, "statut": null, "q": null }, "data": [ { "id": "ckxxxxx", "slug": "riviera-palmeraie-2019-cocody", "nom": "RIVIERA PALMERAIE", "commune": "COCODY", "departement": "ABIDJAN", "annee": 2019, "statut": "APPROUVE", "arreteReference": "117/MCU/DUA du 15/03/2019", "arreteDate": "2019-03-15T00:00:00.000Z", "url": "https://www.capital-foncier.com/outils/lotissements/riviera-palmeraie-2019-cocody" } ] }