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) |
|---|---|---|---|---|
| 12379 | 12005 | TÉBESSA تبسة | EL-AOUINET | العوينات |
| 12380 | 12038 | TÉBESSA تبسة | EL-HOUIDJBET | الحويجبات |
| 12382 | 12046 | TÉBESSA تبسة | GUORRIGUER | قريقر |
| 12383 | 12016 | TÉBESSA تبسة | HAMMAMET | الحمامات |
| 12384 | 12017 | TÉBESSA تبسة | MORSOTT | مرسط |
| 12386 | 12003 | TÉBESSA تبسة | OUENZA | الونزة |
| 12387 | 12027 | TÉBESSA تبسة | OUM ALI | أم علي |
| 12388 | 12037 | TÉBESSA تبسة | SAF SAF EL OUESRA | صفصاف الوسرى |
| 12389 | 12032 | TÉBESSA تبسة | STAH GUENTIS | سطح قنطيس |
| 12390 | 00000 | TÉBESSA تبسة | TEBESSA | تبسة |
| 12391 | 12053 | TÉBESSA تبسة | TELIDJEN | ثليجان |
| 13392 | 13028 | TLEMCEN تلمسان | AIN FETAH | عين فتاح |
| 13393 | 13022 | TLEMCEN تلمسان | AIN FEZZA | عين فزة |
| 13394 | 13023 | TLEMCEN تلمسان | AIN GHORABA | عين غرابة |
| 13395 | 13049 | TLEMCEN تلمسان | AIN KEBIRA | عين الكبيرة |
| 13396 | 13054 | TLEMCEN تلمسان | AIN NEHALA | عين النحالة |
| 13397 | 13012 | TLEMCEN تلمسان | AIN TELLOUT | عين تالوت |
| 13398 | 13013 | TLEMCEN تلمسان | AIN YOUCEF | عين يوسف |
| 13399 | 13058 | TLEMCEN تلمسان | AMIEUR | عمير |
| 13400 | 13014 | TLEMCEN تلمسان | BAB EL ASSA | باب العسة |
EL-AOUINET
العوينات
12379
12005
TÉBESSA — تبسة
EL-HOUIDJBET
الحويجبات
12380
12038
TÉBESSA — تبسة
GUORRIGUER
قريقر
12382
12046
TÉBESSA — تبسة
HAMMAMET
الحمامات
12383
12016
TÉBESSA — تبسة
MORSOTT
مرسط
12384
12017
TÉBESSA — تبسة
OUENZA
الونزة
12386
12003
TÉBESSA — تبسة
OUM ALI
أم علي
12387
12027
TÉBESSA — تبسة
SAF SAF EL OUESRA
صفصاف الوسرى
12388
12037
TÉBESSA — تبسة
STAH GUENTIS
سطح قنطيس
12389
12032
TÉBESSA — تبسة
TEBESSA
تبسة
12390
00000
TÉBESSA — تبسة
TELIDJEN
ثليجان
12391
12053
TÉBESSA — تبسة
AIN FETAH
عين فتاح
13392
13028
TLEMCEN — تلمسان
AIN FEZZA
عين فزة
13393
13022
TLEMCEN — تلمسان
AIN GHORABA
عين غرابة
13394
13023
TLEMCEN — تلمسان
AIN KEBIRA
عين الكبيرة
13395
13049
TLEMCEN — تلمسان
AIN NEHALA
عين النحالة
13396
13054
TLEMCEN — تلمسان
AIN TELLOUT
عين تالوت
13397
13012
TLEMCEN — تلمسان
AIN YOUCEF
عين يوسف
13398
13013
TLEMCEN — تلمسان
AMIEUR
عمير
13399
13058
TLEMCEN — تلمسان
BAB EL ASSA
باب العسة
13400
13014
TLEMCEN — تلمسان
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'