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) |
|---|---|---|---|---|
| 19729 | 00000 | SÉTIF سطيف | SETIF | سطيف |
| 19730 | 19125 | SÉTIF سطيف | TACHOUDA | تاشودة |
| 19731 | 19069 | SÉTIF سطيف | TALA-IFACENE | تالة إيفاسن |
| 19732 | 19067 | SÉTIF سطيف | TAYA | الطاية |
| 19733 | 19087 | SÉTIF سطيف | TELLA | التلة |
| 19734 | 19068 | SÉTIF سطيف | TIZI N'BECHAR | تيزي نبشار |
| 20735 | 20001 | SAÏDA سعيدة | AIN EL HADJAR | عين الحجر |
| 20736 | 20009 | SAÏDA سعيدة | AIN SEKHOUNA | عين السخونة |
| 20737 | 20029 | SAÏDA سعيدة | AIN SOLTANE | عين السلطان |
| 20738 | 20023 | SAÏDA سعيدة | DOUI THABET | دوي ثابت |
| 20739 | 20003 | SAÏDA سعيدة | EL HASSASNA | الحساسنة |
| 20740 | 20025 | SAÏDA سعيدة | HOUNET | هونت |
| 20741 | 20013 | SAÏDA سعيدة | MAAMORA | المعمورة |
| 20742 | 20014 | SAÏDA سعيدة | MOULAY LARBI | مولاي العربي |
| 20743 | 20002 | SAÏDA سعيدة | OULED BRAHIM | أولاد إبراهيم |
| 20744 | 20004 | SAÏDA سعيدة | OULED KHALED | أولاد خالد |
| 20745 | 20000 | SAÏDA سعيدة | SAIDA | سعيدة |
| 20746 | 20012 | SAÏDA سعيدة | SIDI AHMED | سيدي احمد |
| 20747 | 20019 | SAÏDA سعيدة | SIDI AMAR | سيدي عمر |
| 20748 | 20007 | SAÏDA سعيدة | SIDI BOUBEKEUR | سيدي بوبكر |
SETIF
سطيف
19729
00000
SÉTIF — سطيف
TACHOUDA
تاشودة
19730
19125
SÉTIF — سطيف
TALA-IFACENE
تالة إيفاسن
19731
19069
SÉTIF — سطيف
TAYA
الطاية
19732
19067
SÉTIF — سطيف
TELLA
التلة
19733
19087
SÉTIF — سطيف
TIZI N'BECHAR
تيزي نبشار
19734
19068
SÉTIF — سطيف
AIN EL HADJAR
عين الحجر
20735
20001
SAÏDA — سعيدة
AIN SEKHOUNA
عين السخونة
20736
20009
SAÏDA — سعيدة
AIN SOLTANE
عين السلطان
20737
20029
SAÏDA — سعيدة
DOUI THABET
دوي ثابت
20738
20023
SAÏDA — سعيدة
EL HASSASNA
الحساسنة
20739
20003
SAÏDA — سعيدة
HOUNET
هونت
20740
20025
SAÏDA — سعيدة
MAAMORA
المعمورة
20741
20013
SAÏDA — سعيدة
MOULAY LARBI
مولاي العربي
20742
20014
SAÏDA — سعيدة
OULED BRAHIM
أولاد إبراهيم
20743
20002
SAÏDA — سعيدة
OULED KHALED
أولاد خالد
20744
20004
SAÏDA — سعيدة
SAIDA
سعيدة
20745
20000
SAÏDA — سعيدة
SIDI AHMED
سيدي احمد
20746
20012
SAÏDA — سعيدة
SIDI AMAR
سيدي عمر
20747
20019
SAÏDA — سعيدة
SIDI BOUBEKEUR
سيدي بوبكر
20748
20007
SAÏDA — سعيدة
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'