Wilayas & Communes d'Algérie
Code Géographique National - Juin 2021 — 58 wilayas, 1 541 communes — Voir la carte interactive
| Code ONS | Code Postal | Wilaya | Commune | Commune (Arabe) |
|---|---|---|---|---|
| 641021 | BOU SAADA بوسعادة | MENAA | مناعة | |
| 641022 | 28033 | BOU SAADA بوسعادة | MOHAMED BOUDIAF | محمد بوضياف |
| 641030 | 28032 | BOU SAADA بوسعادة | OULED SIDI BRAHIM | أولاد سيدي ابراهيم |
| 641031 | 28031 | BOU SAADA بوسعادة | OULED SLIMANE | أولاد سليمان |
| 641032 | 28054 | BOU SAADA بوسعادة | OULTEME | ولتام |
| 641034 | BOU SAADA بوسعادة | SIDI AMEUR | سيدي عامر | |
| 641036 | 28045 | BOU SAADA بوسعادة | SIDI M'HAMED | سيدي امحمد |
| 641037 | 28037 | BOU SAADA بوسعادة | SLIM | سليم |
| 641039 | 28065 | BOU SAADA بوسعادة | TAMSA | تامسة |
| 641041 | 28067 | BOU SAADA بوسعادة | ZARZOUR | زرزور |
| 64996 | 28004 | BOU SAADA بوسعادة | AIN EL MELH | عين الملح |
| 64997 | 28023 | BOU SAADA بوسعادة | AIN FARES | عين فارس |
| 64999 | 28025 | BOU SAADA بوسعادة | AIN RICH | عين الريش |
| 65369 | 12001 | BIR EL ATER بئر العاتر | BIR-EL-ATER | بئر العاتر |
| 65378 | 12043 | BIR EL ATER بئر العاتر | EL OGLA EL MALHA | العقلة المالحة |
| 65381 | 12044 | BIR EL ATER بئر العاتر | FERKANE | فركان |
| 65385 | 12024 | BIR EL ATER بئر العاتر | NEGRINE | نقرين |
| 66899 | 26005 | KSAR EL BOUKHARI قصر البخاري | AIN BOUCIF | عين بوسيف |
| 66900 | 26048 | KSAR EL BOUKHARI قصر البخاري | AIN OUKSIR | عين اقصير |
| 66902 | 26040 | KSAR EL BOUKHARI قصر البخاري | AZIZ | عزيز |
MENAA
مناعة
641021
BOU SAADA — بوسعادة
MOHAMED BOUDIAF
محمد بوضياف
641022
28033
BOU SAADA — بوسعادة
OULED SIDI BRAHIM
أولاد سيدي ابراهيم
641030
28032
BOU SAADA — بوسعادة
OULED SLIMANE
أولاد سليمان
641031
28031
BOU SAADA — بوسعادة
OULTEME
ولتام
641032
28054
BOU SAADA — بوسعادة
SIDI AMEUR
سيدي عامر
641034
BOU SAADA — بوسعادة
SIDI M'HAMED
سيدي امحمد
641036
28045
BOU SAADA — بوسعادة
SLIM
سليم
641037
28037
BOU SAADA — بوسعادة
TAMSA
تامسة
641039
28065
BOU SAADA — بوسعادة
ZARZOUR
زرزور
641041
28067
BOU SAADA — بوسعادة
AIN EL MELH
عين الملح
64996
28004
BOU SAADA — بوسعادة
AIN FARES
عين فارس
64997
28023
BOU SAADA — بوسعادة
AIN RICH
عين الريش
64999
28025
BOU SAADA — بوسعادة
BIR-EL-ATER
بئر العاتر
65369
12001
BIR EL ATER — بئر العاتر
EL OGLA EL MALHA
العقلة المالحة
65378
12043
BIR EL ATER — بئر العاتر
FERKANE
فركان
65381
12044
BIR EL ATER — بئر العاتر
NEGRINE
نقرين
65385
12024
BIR EL ATER — بئر العاتر
AIN BOUCIF
عين بوسيف
66899
26005
KSAR EL BOUKHARI — قصر البخاري
AIN OUKSIR
عين اقصير
66900
26048
KSAR EL BOUKHARI — قصر البخاري
AZIZ
عزيز
66902
26040
KSAR EL BOUKHARI — قصر البخاري
Documentation API
GET /api/wilayas
GET /api/wilayas/{code}
GET /api/communes
GET
/api/wilayas
Retourne la liste des 58 wilayas d'Algérie. Chaque wilaya contient son code (sur 2 chiffres), son nom en français et son nom en arabe.
Un paramètre de recherche optionnel permet de filtrer par code, nom français ou nom arabe.
Paramètres
| Nom | Type | Description |
|---|---|---|
| q optionnel | string | Recherche sur le code, le nom français ou le nom arabe de la wilaya |
Réponse 200 OK
[ { "code": "16", "name": "ALGER", "name_ar": "الجزائر" }, { "code": "31", "name": "ORAN", "name_ar": "وهران" } // ... ]
PHP
Python
cURL
// Lister toutes les wilayas $response = file_get_contents('https://data.dz-immo.com/api/wilayas'); $wilayas = json_decode($response, true); foreach ($wilayas as $w) { echo $w['code'] . ' - ' . $w['name'] . ' (' . $w['name_ar'] . ")\n"; } // Rechercher une wilaya par nom $q = urlencode('alger'); $results = json_decode( file_get_contents("https://data.dz-immo.com/api/wilayas?q={$q}"), true ); // Avec cURL (gestion d'erreurs) $ch = curl_init('https://data.dz-immo.com/api/wilayas'); curl_setopt_array($ch, [ CURLOPT_RETURNTRANSFER => true, CURLOPT_HTTPHEADER => ['Accept: application/json'], ]); $response = curl_exec($ch); $status = curl_getinfo($ch, CURLINFO_HTTP_CODE); curl_close($ch); if ($status === 200) { $wilayas = json_decode($response, true); }
import requests # Lister toutes les wilayas response = requests.get("https://data.dz-immo.com/api/wilayas") wilayas = response.json() for w in wilayas: print(f"{w['code']} - {w['name']} ({w['name_ar']})") # Rechercher une wilaya response = requests.get( "https://data.dz-immo.com/api/wilayas", params={"q": "alger"} ) results = response.json() # Construire un dictionnaire code -> nom wilaya_map = {w["code"]: w["name"] for w in wilayas} print(wilaya_map["16"]) # ALGER
# Toutes les wilayas curl https://data.dz-immo.com/api/wilayas # Rechercher par nom curl "https://data.dz-immo.com/api/wilayas?q=oran" # Rechercher en arabe curl "https://data.dz-immo.com/api/wilayas?q=وهران"
GET
/api/wilayas/{code}
Retourne le détail d'une wilaya identifiée par son code (2 chiffres), accompagnée de la liste complète de ses communes.
Si le code n'existe pas, l'API retourne une erreur 404.
Paramètres d'URL
| Nom | Type | Description |
|---|---|---|
| code | string | Code de la wilaya sur 2 chiffres (ex: 16 pour Alger, 31 pour Oran) |
Réponse 200 OK
{ "code": "16", "name": "ALGER", "name_ar": "الجزائر", "communes": [ { "code": "01", "name": "ALGER CENTRE", "name_ar": "الجزائر الوسطى" }, { "code": "05", "name": "BAB EL OUED", "name_ar": "باب الوادي" } // ... 57 communes au total ] }
Erreur 404
{ "error": "Wilaya not found" }
PHP
Python
cURL
// Récupérer Alger (code 16) avec toutes ses communes $code = '16'; $response = file_get_contents("https://data.dz-immo.com/api/wilayas/{$code}"); $wilaya = json_decode($response, true); echo $wilaya['name'] . " contient " . count($wilaya['communes']) . " communes\n"; // Afficher chaque commune foreach ($wilaya['communes'] as $c) { echo sprintf( " %s-%s %-25s %s\n", $wilaya['code'], $c['code'], $c['name'], $c['name_ar'] ); } // Construire un select HTML $html = '<select name="commune">'; foreach ($wilaya['communes'] as $c) { $html .= "<option value=\"{$c['code']}\">" . "{$c['name']} ({$c['name_ar']})</option>"; } $html .= '</select>';
import requests # Récupérer une wilaya et ses communes code = "16" response = requests.get(f"https://data.dz-immo.com/api/wilayas/{code}") response.raise_for_status() # lève une exception si 404 wilaya = response.json() print(f"{wilaya['name']} : {len(wilaya['communes'])} communes") # Créer un DataFrame pandas import pandas as pd df = pd.DataFrame(wilaya["communes"]) print(df.to_string(index=False)) # Exporter en CSV df.to_csv(f"communes_wilaya_{code}.csv", index=False)
# Détail de la wilaya d'Alger curl https://data.dz-immo.com/api/wilayas/16 # Détail de la wilaya d'Oran curl https://data.dz-immo.com/api/wilayas/31 # Formatter la sortie avec jq curl -s https://data.dz-immo.com/api/wilayas/16 | jq '.communes[] | .name'
GET
/api/communes
Retourne la liste des communes avec des filtres combinables : recherche textuelle et/ou filtrage par code de wilaya.
Sans filtre, retourne les 1 541 communes. Chaque commune inclut les informations de sa wilaya parente.
Paramètres
| Nom | Type | Description |
|---|---|---|
| q optionnel | string | Recherche sur le code, le nom français ou le nom arabe de la commune |
| wilaya optionnel | string | Code de la wilaya pour filtrer les communes (2 chiffres, ex: 16) |
Réponse 200 OK
[ { "wilaya_code": "16", "wilaya_name": "ALGER", "wilaya_name_ar": "الجزائر", "code": "05", "name": "BAB EL OUED", "name_ar": "باب الوادي" } // ... ]
PHP
Python
cURL
// Communes d'une wilaya $wilayaCode = '16'; $response = file_get_contents( "https://data.dz-immo.com/api/communes?wilaya={$wilayaCode}" ); $communes = json_decode($response, true); // Rechercher une commune par nom dans une wilaya $q = urlencode('bab'); $response = file_get_contents( "https://data.dz-immo.com/api/communes?wilaya=16&q={$q}" ); $results = json_decode($response, true); // Rechercher dans toutes les wilayas $response = file_get_contents( "https://data.dz-immo.com/api/communes?q=ain" ); $communes = json_decode($response, true); echo count($communes) . " communes contiennent 'ain'\n"; // Regrouper les communes par wilaya $grouped = []; foreach ($communes as $c) { $grouped[$c['wilaya_name']][] = $c['name']; }
import requests # Communes d'une wilaya response = requests.get( "https://data.dz-immo.com/api/communes", params={"wilaya": "16"} ) communes = response.json() # Rechercher + filtrer par wilaya response = requests.get( "https://data.dz-immo.com/api/communes", params={"q": "bab", "wilaya": "16"} ) # Charger toutes les communes dans un DataFrame import pandas as pd all_communes = requests.get("https://data.dz-immo.com/api/communes").json() df = pd.DataFrame(all_communes) # Nombre de communes par wilaya print(df.groupby("wilaya_name").size().sort_values(ascending=False)) # Exporter tout en CSV df.to_csv("communes_algerie.csv", index=False)
# Toutes les communes curl https://data.dz-immo.com/api/communes # Communes de la wilaya 16 (Alger) curl "https://data.dz-immo.com/api/communes?wilaya=16" # Rechercher "bab" dans Alger curl "https://data.dz-immo.com/api/communes?wilaya=16&q=bab" # Rechercher dans toutes les wilayas + compter curl -s "https://data.dz-immo.com/api/communes?q=ain" | jq 'length'