African-states-and-tribes

This project provides comprehensive insights into African countries, the origins of various tribes, and their geographic distributions. Built to celebrate and document Africa’s rich multicultural landscape, it allows users to explore the continent’s diverse cultural heritage, discovering the roots and locations of countless ethnic groups across Africa.

Install

npm i country-state-city

Usage

• ES6 Module usage

  import * as africanStates from 'african-states-and-tribes'

• ES5 Module usage

  const africanStates = require('african-states-and-tribes')

Docs

• Get all African Countries

  import * as africanStates from 'african-states-and-tribes'
  
  africanStates.getCountries().then(countries =>{
      console.log(countries)
  })

  Output:

      [
          {
                  phoneCode: 244,
                  capitalCity: "Luanda",
                  colonialMaster:"",
                  countryCode:"AO",
                  flagEmoji: "🇦🇴",
                  name: "Angola",
                  currency: "Angolan kwanza",
                  currencyCode:"AOA",
                  currencySymbol:"Kz",
                  officialLanguage: "Portuguese",
                  majorEthnicGroups:["Bakongo", "Chokwe", "Herero", "Humbi", "Kimbundu", "Mbundu", "Ngangela", "Ovimbundu"]
          },
          {
                  phoneCode: 229,
                  capitalCity: "Porto-Novo",
                  colonialMaster:"",
                  countryCode:"BJ",
                  flagEmoji: "🇧🇯",
                  name: "Benin",
                  currency: "West African CFA franc",
                  currencyCode:"XOF",
                  currencySymbol:"Fr",
                  officialLanguage: "French",
                  majorEthnicGroups:["Adja (Aja)","Bariba","Dendi (Songhai)","Fon (Dahomey)","Fulani","Lukpa","Tammari (Betammaribe)","Yoruba"]
          },
          ...
      ]

• Get All African Countries + Tribal Data

  import * as africanStates from 'african-states-and-tribes'
  
  africanStates.getCountriesAndTribalData("NG").then(countries =>{
      console.log(countries)
  })

  Output:

   [
      {
          phoneCode: 244,
          capitalCity: "Luanda",
          colonialMaster:"",
          countryCode:"AO",
          flagEmoji: "🇦🇴",
          name: "Angola",
          currency: "Angolan kwanza",
          currencyCode:"AOA",
          currencySymbol:"Kz",
          officialLanguage: "Portuguese",
          majorEthnicGroups:["Bakongo", "Chokwe", "Herero", "Humbi", "Kimbundu", "Mbundu", "Ngangela", "Ovimbundu"]
          tribalDistribution:[
              {
                  capitalCity:"Caxito",
                  subdivisions:["Ambriz", "Bula Atumba", "Dande", "Dembos","Nambuangongo", "Pango Aluquém"],
                  geoPoliticalZone:"",
                  location:"North",
                  name: "Bengo",
                  stateCode: "BGO",
                  tribes:["Bakongo", "Kimbundu (Mbundu)", "Kikongo","Songo"],
                  type: "province"
              },
              {
                  capitalCity:"Benguela",
                  subdivisions:[],
                  geoPoliticalZone:"",
                  location:"West Central",
                  name: "Benguela",
                  stateCode: "BGU",
                  tribes:["Herero", "Khoisan (San)", "Nyaneka-Nkhumbi", "Ovimbundu"],
                  type: "province"
              },
              ... // list of state/province/region and tribes that can be found there.
          ]
      }
      ...
   ]
  

• Get Specific Country by CountryCode

  import * as africanStates from 'african-states-and-tribes'
  
  africanStates.getCountry("NG").then(country =>{
      console.log(country)
  })
  

  Output:

      {
          phoneCode: 234,
          capitalCity: "Abuja",
          colonialMaster:"",
          countryCode:"NG",
          flagEmoji: "🇳🇬",
          name: "Nigeria",
          currency: "Nigerian naira",
          currencyCode:"NGN",
          currencySymbol:"₦",
          officialLanguage: "English",
          majorEthnicGroups:["Fulani", "Hausa","Kanuri","Ibibio", "Igbo","Ijaw", "Tiv","Yoruba"]
      }
  

• Get Specific Country + Tribal Data by CountryCode

  import * as africanStates from 'african-states-and-tribes'
  
   africanStates.getCountryAndTribalData("NG").then(country =>{
      console.log(country)
  })

  Output:

      {
          phoneCode: 234,
          capitalCity: "Abuja",
          colonialMaster:"",
          countryCode:"NG",
          flagEmoji: "🇳🇬",
          name: "Nigeria",
          currency: "Nigerian naira",
          currencyCode:"NGN",
          currencySymbol:"₦",
          officialLanguage: "English",
          majorEthnicGroups:["Fulani", "Hausa","Kanuri","Ibibio", "Igbo","Ijaw", "Tiv","Yoruba"]
          tribalDistribution:[
               {
                  capitalCity:"Umuahia",
                  subdivisions: ["Aba North", "Aba South", "Arochukwu", "Bende", "Ikwuano", "Isiala Ngwa North", "Isiala Ngwa South", "Isuikwuato", "Obi Ngwa", "Ohafia", "Osisioma", "Ugwunagbo", "Ukwa East", "Ukwa West", "Umuahia North", "Umuahia South"],
                  geoPoliticalZone: "South East",
                  location:"South East",
                  name: "Abia",
                  stateCode: "AB",
                  tribes:["Igbo"],
                  type: "state"
              }
          ]
      }
  

• Get a Country's Tribal Data Only

  import * as africanStates from 'african-states-and-tribes'
  
  africanStates.getTribesByCountry("NG").then(tribes =>{
      console.log(tribes)
  })

  Output:

    [
       {
          capitalCity:"Umuahia",
          subdivisions: ["Aba North", "Aba South", "Arochukwu", "Bende", "Ikwuano", "Isiala Ngwa North", "Isiala Ngwa South", "Isuikwuato", "Obi Ngwa", "Ohafia", "Osisioma", "Ugwunagbo", "Ukwa East", "Ukwa West", "Umuahia North", "Umuahia South"],
          geoPoliticalZone: "South East",
          location:"South East",
          name: "Abia",
          stateCode: "AB",
          tribes:["Igbo"],
          type: "state"
      },
      {
          capitalCity:"Uyo",
          subdivisions: ["Abak", "Eastern Obolo", "Eket", "Esit Eket", "Essien Udim", "Etim Ekpo", "Etinan", "Ibeno", "Ibesikpo Asutan", "Ibiono Ibom", "Ika", "Ikono", "Ikot Abasi", "Ikot Ekpene", "Ini", "Itu", "Mbo", "Mkpat Enin", "Nsit Atai", "Nsit Ibom", "Nsit Ubium", "Obot Akara", "Okobo", "Onna", "Oron", "Oruk Anam", "Udung Uko", "Ukanafun", "Uruan", "Urue Offong/Oruko", "Uyo"],
          geoPoliticalZone: "South South",
          location:"South South",
          name: "Akwa Ibom",
          stateCode: "AK",
          tribes:["Anang","Andoni", "Eket", "Ibeno", "Ibibio", "Obolo", "Okobo (Okkobor)", "Oron" ],
          type: "state"
      },
      ...
    ]

  | Key | Description
  |----------------------------------------|----------------------------- | capitalCity | Country's capital city
  | colonialMaster | Country's colonial master
  | countryCode | Country's 2-alphabet country code
  | flagEmoji | Country's flag emoji | name | Country name | currency | Country's official currency | currencyCode | Country's official currency code | currencySymbol | Country's official currency symbol | officialLanguage | Country's official language | majorEthnicGroups | Major ethnic found in the country | tribalDistribution | Array containing country's tribal origin grouped by state/region/province found in. | tribalDistribution.capitalCity | state/region/province capital city | tribalDistribution.subdivisions | state/region/province administrative sub divisions such as Local Government | tribalDistribution.geoPoliticalZone | Geopolitical zone in which the state/region/province falls under | tribalDistribution.location | state/region/province location on country's map | tribalDistribution.name | state/region/province | tribalDistribution.stateCode | state/region/province official code | tribalDistribution.tribes | Tribes found in state/region/province | tribalDistribution.type | type of either state/region/province

Countries Covered.

• Angola
• Algeria
• Benin - Departments/Communes
• Botswana
• Burkina Faso
• Burundi
• Cabo Verde
• Cameroon
• Central African Republic
• Chad
• Comoros
• Democratic Republic of the Congo
• Republic of the Congo
• Cote D'Ivoire
• Djibouti
• Egypt
• Equatorial Guinea
• Eritrea
• Ethiopia
• Gabon
• Ghana
• Gambia
• Guinea
• Guinea-Bissau
• Kenya
• Lesotho
• Liberia
• Libya
• Madagascar
• Malawi
• Mali
• Mauritania
• Mauritius
• Morocco
• Mozambique
• Namibia
• Niger
• Nigeria - States/Local Government
• Rwanda
• Sao Tome And Principe
• Senegal
• Seychelles
• Sierra Leone
• Somalia - Regions/Districts
• South Africa
• South Sudan
• Sudan
• Eswatini
• Tanzania
• Togo
• Tunisia
• Uganda
• Zambia
• Zimbabwe

Data Sources

• https://www.vanguardngr.com/2017/05/full-list-of-all-371-tribes-in-nigeria-states-where-they-originate/
• https://euaa.europa.eu/
• https://www.citypopulation.de/
• https://www.odsef.fss.ulaval.ca/sites/odsef.fss.ulaval.ca/files/odsef_assani_web.pdf