Skip to content

Designed to facilitate the retrieval of universities data, in order to ease the process of building a catalog of colleges for various purposes

Notifications You must be signed in to change notification settings

Project-G-Org/world-universities-api

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

26 Commits
 
 
 
 
 
 

Repository files navigation

The Universities API (On development project)

This API is designed to facilitate the retrieval and addition of universities data through a web crawler and API integration. The project consists of two main parts: the Web Crawler and the API.

Motivation

I created this API because I faced challenges finding free resources for gathering comprehensive data on multiple universities. The goal is to ease the process of building a catalog of universities for various purposes.

Web Crawler

The Web Crawler is responsible for searching and collecting data about universities from the web. It gathers information and metadata about universities, which is later used to populate the database through the API.

API

The API exposes GET and POST endpoints, allowing users to retrieve existing university data and add new information to the database.

Endpoints

GET /colleges: Retrieve a list of universities from the database. POST /colleges: Add new university data to the database. These endpoints work seamlessly with the data collected by the Web Crawler, enabling a comprehensive search-and-add functionality for university information.

Tooling

To streamline the process of sending data from the Web Crawler to the API, we have integrated the PokeGelo-CLI tool. It simplifies the HTTP request process by constructing requests using metadata obtained from the Web Crawler. This allows for efficient and automated communication between the crawler and the Uni-API.

How it Works

The Web Crawler searches for university data on the web and outputs metadata. PokeGelo-CLI reads the metadata and constructs an HTTP request body. The constructed request is sent to the Uni-API's POST endpoint, adding the university data to the database.

TODO:

  • Postgres Database (Notes: on docker)
  • Get colleges endpoint
  • Basics search spiders
  • Post endpoint
  • Store colleges data into database
  • Describe process with poke-cli
  • Better spiders implementation
  • Deploy

About

Designed to facilitate the retrieval of universities data, in order to ease the process of building a catalog of colleges for various purposes

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Contributors 2

  •  
  •  

Languages