Population/API v2

Population nationale

GET/api/v2/population/national

À savoir. RGPH 2024 et séries historiques HCP. Consultez meta pour la source et la date de chaque série.

Comprendre le contexte

RGPH est le recensement de la population réalisé par le HCP, l’office statistique marocain. Un résident n’est pas nécessairement de nationalité marocaine. Exemple de lecture : 100 résidents, dont 95 Marocains et 5 étrangers, donnent un total de 100 ; ne les additionnez pas une seconde fois. Cet exemple est illustratif.

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.

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 12

[] 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.totalinteger: Nombre total de résidents recensés dans le périmètre et l’année indiqués.
data.moroccansinteger: Nombre de résidents de nationalité marocaine dans le périmètre indiqué.
data.foreignersinteger: Nombre de résidents de nationalité étrangère dans le périmètre indiqué.
data.urbanobject: Population des zones classées urbaines par le recensement ; objet détaillé si présent.
data.urban.totalinteger: Nombre total de résidents recensés dans le périmètre et l’année indiqués.
data.urban.moroccansinteger: Nombre de résidents de nationalité marocaine dans le périmètre indiqué.
data.urban.foreignersinteger: Nombre de résidents de nationalité étrangère dans le périmètre indiqué.
data.ruralobject: Population des zones classées rurales par le recensement ; objet détaillé si présent.
data.rural.totalinteger: Nombre total de résidents recensés dans le périmètre et l’année indiqués.
data.rural.moroccansinteger: Nombre de résidents de nationalité marocaine dans le périmètre indiqué.
data.rural.foreignersinteger: Nombre de résidents de nationalité étrangère dans le périmètre indiqué.

Structure des données

{
  "type": "object",
  "additionalProperties": false,
  "required": [
    "data",
    "meta"
  ],
  "properties": {
    "data": {
      "type": "object",
      "additionalProperties": false,
      "required": [
        "total",
        "moroccans",
        "foreigners",
        "urban",
        "rural"
      ],
      "properties": {
        "total": {
          "type": "integer",
          "minimum": 0
        },
        "moroccans": {
          "type": "integer",
          "minimum": 0
        },
        "foreigners": {
          "type": "integer",
          "minimum": 0
        },
        "urban": {
          "type": "object",
          "additionalProperties": false,
          "required": [
            "total",
            "moroccans",
            "foreigners"
          ],
          "properties": {
            "total": {
              "type": "integer",
              "minimum": 0
            },
            "moroccans": {
              "type": "integer",
              "minimum": 0
            },
            "foreigners": {
              "type": "integer",
              "minimum": 0
            }
          }
        },
        "rural": {
          "type": "object",
          "additionalProperties": false,
          "required": [
            "total",
            "moroccans",
            "foreigners"
          ],
          "properties": {
            "total": {
              "type": "integer",
              "minimum": 0
            },
            "moroccans": {
              "type": "integer",
              "minimum": 0
            },
            "foreigners": {
              "type": "integer",
              "minimum": 0
            }
          }
        }
      }
    },
    "meta": {
      "type": "object",
      "additionalProperties": false,
      "required": [
        "dataset",
        "total",
        "license",
        "retrieved_at",
        "transformation_version",
        "sources"
      ],
      "properties": {
        "dataset": {
          "enum": [
            "national-population"
          ]
        },
        "total": {
          "type": "integer",
          "minimum": 0
        },
        "license": {
          "enum": [
            "CC-BY-4.0"
          ]
        },
        "retrieved_at": {
          "enum": [
            "2026-10-05"
          ]
        },
        "transformation_version": {
          "enum": [
            "2.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": [
                  "CC-BY-4.0"
                ]
              },
              "source_updated_at": {
                "type": "string",
                "format": "date"
              }
            }
          }
        }
      }
    }
  }
}

Sources et pagination 13

metaobject

Contexte du résultat : sources, dates, licence et pagination si applicable.

meta.datasetstring

Nom du jeu de données auquel appartient le résultat ou la source.

Valeurs acceptées: "national-population"

meta.totalinteger

Nombre de résultats correspondant aux filtres, avant pagination ; pas la taille de cette page.

meta.licensestring

Licence de réutilisation. mixed signifie des licences différentes : consultez chaque source.

Valeurs acceptées: "CC-BY-4.0"

meta.retrieved_atstring

Date de récupération du fichier source par le projet ; pas la date des observations.

Valeurs acceptées: "2026-10-05"

meta.transformation_versionstring

Version des règles de conversion du jeu de données ; distincte de l’API.

Valeurs acceptées: "2.0.0"

meta.sourcesobject[]

Sources utilisées pour ce résultat, avec leurs producteurs et licences.

meta.sources[].datasetstring

Nom du jeu de données auquel appartient le résultat ou la source.

meta.sources[].producerstring

Organisme qui publie la donnée originale.

meta.sources[].source_urlstring

Page de présentation ou de publication de la source.

meta.sources[].resource_urlstring

Lien vers le fichier ou la ressource utilisée.

meta.sources[].licensestring

Licence de réutilisation. mixed signifie des licences différentes : consultez chaque source.

Valeurs acceptées: "CC-BY-4.0"

meta.sources[].source_updated_atstring

Dernière mise à jour annoncée par la source ; pas la date de récupération.

Erreurs

Les erreurs renvoient error.code, error.message et error.request_id.

Population nationale

Paramètres

Votre requête