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

包详细信息