{"id":19878929,"url":"https://github.com/devrapture/nigerian-universities","last_synced_at":"2025-08-19T21:16:57.797Z","repository":{"id":220819796,"uuid":"751133250","full_name":"devrapture/nigerian-universities","owner":"devrapture","description":"An API that provides Nigerian universities, vice chancellors, website, and year of establishment","archived":false,"fork":false,"pushed_at":"2024-02-04T13:05:09.000Z","size":21,"stargazers_count":8,"open_issues_count":0,"forks_count":2,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-04-07T02:11:18.057Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"https://nigerian-universities.onrender.com","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/devrapture.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null}},"created_at":"2024-02-01T01:50:12.000Z","updated_at":"2025-02-25T14:23:17.000Z","dependencies_parsed_at":"2024-02-09T17:47:47.841Z","dependency_job_id":null,"html_url":"https://github.com/devrapture/nigerian-universities","commit_stats":null,"previous_names":["coolpythoncodes/nigerian-universities","devrapture/nigerian-universities"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/devrapture%2Fnigerian-universities","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/devrapture%2Fnigerian-universities/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/devrapture%2Fnigerian-universities/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/devrapture%2Fnigerian-universities/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/devrapture","download_url":"https://codeload.github.com/devrapture/nigerian-universities/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":252046100,"owners_count":21685947,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-11-12T17:07:05.286Z","updated_at":"2025-05-02T13:31:05.765Z","avatar_url":"https://github.com/devrapture.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"## Nigerian Universities API Documentation\n\n### Table of Contents\n\n- [Overview](#overview)\n- [Prerequisites](#prerequisites)\n- [Installation](#installation)\n- [Usage](#usage)\n- [Endpoints](#endpoints)\n\n### Overview\n\nThis 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/.\n\n### Prerequisites\n\n- [Go](https://go.dev/doc/install) installed\n- [Docker](https://www.docker.com/get-started/) installed (optional)\n\n### Installation\n\nTo run the API locally, follow these steps:\n\n1. Clone the repository from Github:\n\n```bash\ngit clone https://github.com/coolpythoncodes/nigerian-universities.git\n```\n\n2. Navigate to the project directory:\n\n```bash\ncd nigerian-universities\n```\n\n3. Run the application:\n\n```bash\ngo run main.go\n```\n\nThe application will be served on port `8080`\n\n### Endpoints\n\nThe App provides the following endpoints:\n\nGET / fetches all the Nigerian universities (Federal, State and Private)\n\nExample\n\n```bash\ncurl http://localhost:8080\n```\n\nResponse\n\n```json\nerror: false,\nmessage: \"success\"\ndata: [\n    {\n        name: \"Abubakar Tafawa Balewa University, Bauchi\",\n        vice_chancellor: \"Professor M A Abdulazeez\",\n        year_of_establishment: \"1988\",\n        type: \"Federal\",\n        url: \"https://www.atbu.edu.ng\"\n    },\n    {\n        name: \"Ahmadu Bello University, Zaria\",\n        vice_chancellor: \"Professor Kabir Bala\",\n        year_of_establishment: \"1962\",\n        type: \"Federal\",\n        url: \"https://www.abu.edu.ng\"\n    },\n    // more universities with also State and Private\n]\n```\n\n\nGET /federal fetches all the Nigerian Federal universities\n\nExample\n\n```bash\ncurl http://localhost:8080/federal\n```\n\nResponse\n\n```json\nerror: false,\nmessage: \"success\"\ndata: [\n    {\n        name: \"Abubakar Tafawa Balewa University, Bauchi\",\n        vice_chancellor: \"Professor M A Abdulazeez\",\n        year_of_establishment: \"1988\",\n        type: \"Federal\",\n        url: \"https://www.atbu.edu.ng\"\n    },\n    {\n        name: \"Ahmadu Bello University, Zaria\",\n        vice_chancellor: \"Professor Kabir Bala\",\n        year_of_establishment: \"1962\",\n        type: \"Federal\",\n        url: \"https://www.abu.edu.ng\"\n    },\n    // more federal universities \n]\n```\n\nGET /state fetches all the Nigerian State universities\n\nExample\n\n```bash\ncurl http://localhost:8080/state\n```\n\nResponse\n\n```json\nerror: false,\nmessage: \"success\"\ndata: [\n    {\n        name: \"Abia State University, Uturu\",\n        vice_chancellor: \"Prof. Onyemachi M. Ogbulu\",\n        year_of_establishment: \"1981\",\n        type: \"State\",\n        url: \"https://www.abiastateuniversity.edu.ng\"\n    },\n    {\n        name: \"Adamawa State University Mubi\",\n        vice_chancellor: \"Prof (Mrs) Kaletapwa Farauta\",\n        year_of_establishment: \"2002\",\n        type: \"State\",\n        url: \"https://www.adsu.edu.ng\"\n    },\n    // more state universities \n]\n```\n\n\nGET /private fetches all the Nigerian Private universities\n\nExample\n\n```bash\ncurl http://localhost:8080/private\n```\n\nResponse\n\n```json\nerror: false,\nmessage: \"success\"\ndata: [\n    {\n        name: \"Achievers University, Owo\",\n        vice_chancellor: \"Professor Samuel Aje\",\n        year_of_establishment: \"2007\",\n        type: \"Private\",\n        url: \"https://www.achievers.edu.ng\"\n    },\n    {\n        name: \"Adeleke University, Ede\",\n        vice_chancellor: \"Prof. Samuel E Alao\",\n        year_of_establishment: \"2011\",\n        type: \"Private\",\n        url: \"https://www.adelekeuniversity.edu.ng\"\n    },\n    // more private universities \n]\n```","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdevrapture%2Fnigerian-universities","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdevrapture%2Fnigerian-universities","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdevrapture%2Fnigerian-universities/lists"}