/nigerian-universities

An API that provides Nigerian universities, vice chancellors, website, and year of establishment

Primary LanguageGo

Nigerian Universities API Documentation

Table of Contents

Overview

This API provides access to a list of Nigerian universities' scraped from the official website of the National Universities Commission (NUC) - https://www.nuc.edu.ng/.

Prerequisites

  • Go installed
  • Docker installed (optional)

Installation

To run the API locally, follow these steps:

  1. Clone the repository from Github:
git clone https://github.com/coolpythoncodes/nigerian-universities.git
  1. Navigate to the project directory:
cd nigerian-universities
  1. Run the application:
go run main.go

The application will be served on port 8080

Endpoints

The App provides the following endpoints:

GET / fetches all the Nigerian universities (Federal, State and Private)

Example

curl http://localhost:8080

Response

error: false,
message: "success"
data: [
    {
        name: "Abubakar Tafawa Balewa University, Bauchi",
        vice_chancellor: "Professor M A Abdulazeez",
        year_of_establishment: "1988",
        type: "Federal",
        url: "https://www.atbu.edu.ng"
    },
    {
        name: "Ahmadu Bello University, Zaria",
        vice_chancellor: "Professor Kabir Bala",
        year_of_establishment: "1962",
        type: "Federal",
        url: "https://www.abu.edu.ng"
    },
    // more universities with also State and Private
]

GET /federal fetches all the Nigerian Federal universities

Example

curl http://localhost:8080/federal

Response

error: false,
message: "success"
data: [
    {
        name: "Abubakar Tafawa Balewa University, Bauchi",
        vice_chancellor: "Professor M A Abdulazeez",
        year_of_establishment: "1988",
        type: "Federal",
        url: "https://www.atbu.edu.ng"
    },
    {
        name: "Ahmadu Bello University, Zaria",
        vice_chancellor: "Professor Kabir Bala",
        year_of_establishment: "1962",
        type: "Federal",
        url: "https://www.abu.edu.ng"
    },
    // more federal universities 
]

GET /state fetches all the Nigerian State universities

Example

curl http://localhost:8080/state

Response

error: false,
message: "success"
data: [
    {
        name: "Abia State University, Uturu",
        vice_chancellor: "Prof. Onyemachi M. Ogbulu",
        year_of_establishment: "1981",
        type: "State",
        url: "https://www.abiastateuniversity.edu.ng"
    },
    {
        name: "Adamawa State University Mubi",
        vice_chancellor: "Prof (Mrs) Kaletapwa Farauta",
        year_of_establishment: "2002",
        type: "State",
        url: "https://www.adsu.edu.ng"
    },
    // more state universities 
]

GET /private fetches all the Nigerian Private universities

Example

curl http://localhost:8080/private

Response

error: false,
message: "success"
data: [
    {
        name: "Achievers University, Owo",
        vice_chancellor: "Professor Samuel Aje",
        year_of_establishment: "2007",
        type: "Private",
        url: "https://www.achievers.edu.ng"
    },
    {
        name: "Adeleke University, Ede",
        vice_chancellor: "Prof. Samuel E Alao",
        year_of_establishment: "2011",
        type: "Private",
        url: "https://www.adelekeuniversity.edu.ng"
    },
    // more private universities 
]