Skip to content

therakius/moz-demog-api

Repository files navigation

Moz-Demog-API

📘 Para ler em português, clique aqui

Moz-Demog-API is a public RESTful API that provides Mozambique's demographic data from 2017 to 2026, delivered in standard JSON format.

It was built to support:

  • Developers building data-driven applications
  • Programming students practicing API consumption
  • Data scientists performing population analysis
  • Anyone with technical knowledge who needs access to structured demographic data

All datasets are sourced from the official National Institute of Statistics of Mozambique (INE).

📄 API Documentation:
You can view and interact with the documentation at
👉 https://moz-demog-api.vercel.app/v1/documentation


📦 Tech Stack & Tools

Languages & Frameworks

  • HTML, CSS, JavaScript
  • Node.js, Express.js

Data & Modeling

  • PostgreSQL
  • PlantUML (for diagrams)

Tooling

  • Visual Studio Code
  • Postman

🗂 Endpoints Overview (English)

Resource Endpoint Method
Country Data /country GET
Provinces /province-info GET
Districts /province-info/list GET
Indicators /indicators/ GET

For full parameter details and example responses, visit the documentation.


📌 Limitations

  • Province level data is only available for 2023
  • Write operations (POST, PUT, DELETE) are not supported in the current version

🤝 Contact

For suggestions, issues, or collaborations, feel free to reach out:

📫 Email: therakius.dev@gmail.com


Developed by therakius.

About

A RESTful api that provides demographic data for mozambique

Topics

Resources

Stars

Watchers

Forks

Packages

 
 
 

Contributors