Villes de l’indice
À savoir. Indice des prix à la consommation du HCP, mensuel, base 100 = moyenne 2017 : national et 18 villes, de janvier 2017 au dernier mois publié sur data.gov.ma. Indices seulement, pas de taux d’inflation calculés. Libellés des produits en français, tels que publiés.
Comprendre le contexte
Exemple de lecture : un indice de 110 signifie que le même panier de produits coûte 10 % de plus qu’en moyenne en 2017. Pour l’inflation sur un an, comparez un mois au même mois de l’année précédente : 110 contre 105 donne (110 ÷ 105 − 1) × 100 ≈ 4,8 %. Ces chiffres sont illustratifs.
Comprendre la réponse
data: Les résultats demandés, sous forme d’objet ou de liste.
meta: Sources, licence et dates du jeu de données. null signifie une valeur inconnue ou indisponible.
meta.pagination: Listes : 100 résultats par défaut, 500 maximum. Utilisez limit et offset ; meta.pagination.next_offset vaut null à la dernière page.
Exemple illustratif: Avec limit=10 et offset=0, la première page contient au plus 10 résultats. Si next_offset vaut 10, demandez la suivante avec offset=10 et les mêmes filtres. Arrêtez quand next_offset vaut null.
API v2 est le chemin de référence. Les anciens chemins /api/v1 restent des alias de compatibilité du comportement actuellement publié, pagination comprise ; aucune date de suppression n’est fixée.
Champs renvoyés 7
[] désigne chaque élément d’une liste. null signifie inconnu ou indisponible, jamais zéro. La langue du guide ne traduit pas les valeurs des sources.
dataobject[]Résultat demandé : objet unique ou liste.
data[].codestringCode MoroccoAPI de la ville ; national désigne l’indice pour l’ensemble du Maroc.
data[].namestringNom de la ville publié par le HCP.
data[].region_codestring | nullRégion où se trouve la ville ; null pour l’indice national.
data[].product_countintegerNombre de produits ayant un indice pour cette ville.
data[].first_monthstringPremier mois publié, au format YYYY-MM.
data[].last_monthstringDernier mois publié, au format YYYY-MM.
Structure des données
{
"type": "object",
"additionalProperties": false,
"required": [
"data",
"meta"
],
"properties": {
"data": {
"type": "array",
"items": {
"type": "object",
"additionalProperties": false,
"required": [
"code",
"name",
"region_code",
"product_count",
"first_month",
"last_month"
],
"properties": {
"code": {
"type": "string",
"description": "MoroccoAPI city code; national is the index for Morocco as a whole."
},
"name": {
"type": "string",
"description": "City label as published by HCP."
},
"region_code": {
"anyOf": [
{
"type": "string"
},
{
"type": "string",
"nullable": true,
"enum": [
null
]
}
],
"description": "Region where the city is located; null for the national index."
},
"product_count": {
"type": "integer",
"minimum": 1,
"description": "Number of products with an index for this city."
},
"first_month": {
"type": "string",
"pattern": "^[0-9]{4}-(0[1-9]|1[0-2])$",
"description": "First published month."
},
"last_month": {
"type": "string",
"pattern": "^[0-9]{4}-(0[1-9]|1[0-2])$",
"description": "Last published month."
}
}
}
},
"meta": {
"type": "object",
"additionalProperties": false,
"required": [
"dataset",
"total",
"license",
"retrieved_at",
"transformation_version",
"sources",
"pagination"
],
"properties": {
"dataset": {
"enum": [
"prices-cpi"
]
},
"total": {
"type": "integer",
"minimum": 0
},
"license": {
"enum": [
"ODbL-1.0"
]
},
"retrieved_at": {
"enum": [
"2026-11-06"
]
},
"transformation_version": {
"enum": [
"1.0.0"
]
},
"sources": {
"type": "array",
"minItems": 1,
"items": {
"type": "object",
"additionalProperties": false,
"required": [
"dataset",
"producer",
"source_url",
"resource_url",
"license",
"source_updated_at"
],
"properties": {
"dataset": {
"type": "string"
},
"producer": {
"type": "string"
},
"source_url": {
"type": "string",
"format": "uri"
},
"resource_url": {
"type": "string",
"format": "uri"
},
"license": {
"enum": [
"ODbL-1.0"
]
},
"source_updated_at": {
"type": "string",
"format": "date"
}
}
}
},
"pagination": {
"type": "object",
"additionalProperties": false,
"required": [
"limit",
"offset",
"count",
"has_more",
"next_offset"
],
"properties": {
"limit": {
"type": "integer",
"minimum": 1,
"maximum": 500
},
"offset": {
"type": "integer",
"minimum": 0,
"maximum": 2147483647
},
"count": {
"type": "integer",
"minimum": 0,
"maximum": 500
},
"has_more": {
"type": "boolean"
},
"next_offset": {
"anyOf": [
{
"type": "integer",
"minimum": 0,
"maximum": 2147483647
},
{
"type": "string",
"nullable": true,
"enum": [
null
]
}
]
}
}
}
}
}
}
}Sources et pagination 19
metaobjectContexte du résultat : sources, dates, licence et pagination si applicable.
meta.datasetstringNom du jeu de données auquel appartient le résultat ou la source.
Valeurs acceptées:
"prices-cpi"meta.totalintegerNombre de résultats correspondant aux filtres, avant pagination ; pas la taille de cette page.
meta.licensestringLicence de réutilisation. mixed signifie des licences différentes : consultez chaque source.
Valeurs acceptées:
"ODbL-1.0"meta.retrieved_atstringDate de récupération du fichier source par le projet ; pas la date des observations.
Valeurs acceptées:
"2026-11-06"meta.transformation_versionstringVersion des règles de conversion du jeu de données ; distincte de l’API.
Valeurs acceptées:
"1.0.0"meta.sourcesobject[]Sources utilisées pour ce résultat, avec leurs producteurs et licences.
meta.sources[].datasetstringNom du jeu de données auquel appartient le résultat ou la source.
meta.sources[].producerstringOrganisme qui publie la donnée originale.
meta.sources[].source_urlstringPage de présentation ou de publication de la source.
meta.sources[].resource_urlstringLien vers le fichier ou la ressource utilisée.
meta.sources[].licensestringLicence de réutilisation. mixed signifie des licences différentes : consultez chaque source.
Valeurs acceptées:
"ODbL-1.0"meta.sources[].source_updated_atstringDernière mise à jour annoncée par la source ; pas la date de récupération.
meta.paginationobjectInformations pour parcourir une collection page par page.
meta.pagination.limitintegerNombre maximal demandé par page : 100 par défaut, 500 au maximum.
meta.pagination.offsetintegerNombre de résultats ignorés avant cette page, après filtrage. La première page commence à 0.
meta.pagination.countintegerNombre de résultats effectivement présents dans cette page.
meta.pagination.has_morebooleantrue s’il reste une autre page de résultats.
meta.pagination.next_offsetinteger | nullValeur de offset pour la page suivante ; null à la fin. Gardez les mêmes filtres.
Erreurs
400: Paramètre invalide ou manquant.
Les erreurs renvoient error.code, error.message et error.request_id.
errorobjectDétails d’une requête échouée ; remplace data et meta.
error.codestringCode stable de l’erreur, par exemple RESOURCE_NOT_FOUND ; à utiliser dans votre logique.
error.messagestringExplication lisible de l’erreur ; utilisez code pour la logique de votre application.
error.request_idstringIdentifiant du traitement de cette requête, utile pour retrouver un problème.