https://github.com/ycd/universities

:school_satchel: Free & open source API service for obtaining information about +9600 universities worldwide.
https://github.com/ycd/universities

api api-rest asyncpg fastapi fastapi-sqlalchemy postgresql python python3 sqlalchemy uvicorn

Last synced: 11 days ago
JSON representation

:school_satchel: Free & open source API service for obtaining information about +9600 universities worldwide.

• Host: GitHub
• URL: https://github.com/ycd/universities
• Owner: ycd
• License: mit
• Created: 2020-07-08T10:31:28.000Z (over 4 years ago)
• Default Branch: master
• Last Pushed: 2021-06-10T15:48:56.000Z (over 3 years ago)
• Last Synced: 2024-10-12T18:58:08.614Z (26 days ago)
• Topics: api, api-rest, asyncpg, fastapi, fastapi-sqlalchemy, postgresql, python, python3, sqlalchemy, uvicorn
• Language: Python
• Homepage: https://universitiesapi.herokuapp.com
• Size: 142 KB
• Stars: 61
• Watchers: 3
• Forks: 8
• Open Issues: 2
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

• awesome-fastapi - Universities - API service for obtaining information about +9600 universities worldwide. (Projects / Open Source Projects)
• awesome-fastapi - Universities - API service for obtaining information about +9600 universities worldwide. (Projects / Open Source Projects)

README

        


![](https://img.shields.io/github/stars/ycd/universities?style=for-the-badge)

![](https://img.shields.io/github/forks/ycd/universities?style=for-the-badge)

![](https://img.shields.io/github/issues/ycd/universities?style=for-the-badge)

![](https://img.shields.io/github/license/ycd/universities?style=for-the-badge)

![](https://img.shields.io/bitbucket/pr/ycd/universities?style=for-the-badge)



## Universities is free & open source API service. :school_satchel:

   

## Features :rocket:

* **Python **FastAPI** backend.** :hammer:

* **SQLAlchemy** - models :bar_chart:

* **Asynchronous** - Thanks to Uvicorn **Universities API** comes with a incredibly fast ASGI server, :rocket:

* **Large database** - Supports over +140 countries +9600 Universities :satellite:

* **Documentation** - Have an automatic API documentation web user interface thanks to FastAPI

* **Open source** - Everything from the code base is opensource and free to use under a permissive MIT license.

## Try it online with the [Documentation](https://universitiesapi.herokuapp.com) now! 

## How to use & query parameters :bulb:

### You can search by:

* **Country**             ```/search?country=India``` or ```/search?country=United+States```

* **Name**                ```/search?name=harvard``` 

* **Alpha_two_code**      ```/search?alpha_two_code=FR```

* **Domain**              ```/search?domain=uni-muenchen.de```

### Multiple querying & Auto completion

* **Name** and **Country** ```/search?country=Brazil&name=Centro```

* **Name** and **Alpha_two_code** ```/search?name=oxford&alpha_two_code=gb```

### Example Response 

```JSON

{

    "name": "Ludwig-Maximilians-Universität München",

    "alpha_two_code": "DE",

    "country": "Germany",

    "web_pages": [

      "http://www.uni-muenchen.de/"

    ],

    "domains": [

      "uni-muenchen.de"

    ],

    "state_province": null

}

```

## For Installation :pushpin:

```shell

git clone https://github.com/ycd/universities.git

cd universities

virtulenv env

source env/bin/activate

pip install -r requirements.txt

uvicorn app.main:app --reload

```

## License

This project is licensed under the terms of the MIT license.