API publique · v1

API Lotissements MCLU

Accès programmatique gratuit aux données publiques des lotissements approuvés en Côte d'Ivoire, consolidées depuis le Ministère de la Construction (MCLU).

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" } ] }