API v1.0

API Publique HOUNA

Accedez aux donnees du marche immobilier algerien. Deux endpoints publics, sans authentification, avec limitation de debit.

Sans Authentification

Aucune cle API requise

Rate-Limited

Limitation de debit par IP

Donnees Fiables

Scores calcules quotidiennement

URL de Base

https://api.houna.dz/api/v1

Endpoints

GET/api/v1/public/market-index

Indice National du Marche

Retourne l'indice national du marche immobilier avec le classement des meilleures wilayas et les tendances recentes.

10 requetes/minute

Parametres

Nom	Type	Requis	Description
`wilaya`	string	Non	Filtrer par wilaya
`limit`	number	Non	Nombre de wilayas dans le classement (defaut: 10)

GET/api/v1/public/wilaya-score

Score d'une Wilaya / Commune

Retourne le score detaille d'une wilaya ou commune specifique, incluant les sous-scores et les donnees du marche local.

20 requetes/minute

Parametres

Nom	Type	Requis	Description
`wilaya`	string	Oui	Nom de la wilaya
`commune`	string	Non	Nom de la commune (optionnel)

Limites de Debit

Endpoint	Limite	Fenetre
`/public/market-index`	10 requetes	par minute
`/public/wilaya-score`	20 requetes	par minute

Les limites de debit sont appliquees par adresse IP. En cas de depassement, l'API retourne un code HTTP 429 Too Many Requests. Attendez la fin de la fenetre avant de relancer vos requetes.