Skip to content

Hipo/university-domains-list-api

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

31 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

University Domains and Names API

An API and JSON list contains domains, names and countries of most of the universities of the world.

Provides a search endpoint you can search for an autocomplete for university name or/and filter by country.

Feel free to update the list from university-domains-list

SEARCH FROM OUR PUBLIC API


http://universities.hipolabs.com

http://universities.hipolabs.com/search?name=middle

http://universities.hipolabs.com/search?name=middle&country=turkey

API Search Endpoint

Request

/search?name=Middle

Response

[
{
web_page: "http://www.meu.edu.jo/",
country: "Jordan",
domain: "meu.edu.jo",
name: "Middle East University"
},
{
web_page: "http://www.odtu.edu.tr/",
country: "Turkey",
domain: "odtu.edu.tr",
name: "Middle East Technical University"
},
{
web_page: "http://www.mtsu.edu/",
country: "USA",
domain: "mtsu.edu",
name: "Middle Tennessee State University"
},
{
web_page: "http://www.mga.edu/",
country: "USA",
domain: "mga.edu",
name: "Middle Georgia State College"
},
{
web_page: "http://www.mdx.ac.uk/",
country: "United Kingdom",
domain: "mdx.ac.uk",
name: "Middlesex University"
},
{
web_page: "http://www.middlebury.edu/",
country: "USA",
domain: "middlebury.edu",
name: "Middlebury College"
}
]

Request

/search?name=Middle&country=Turkey

Response

[
{
web_page: "http://www.odtu.edu.tr/",
country: "Turkey",
domain: "odtu.edu.tr",
name: "Middle East Technical University"
}
]

Pagination

To paginate requests, we can use the limit and offset parameters. This allows to fetch limited data.

Request

/search?name=Middle&limit=1

Response

[
{
web_page: "http://www.meu.edu.jo/",
country: "Jordan",
domain: "meu.edu.jo",
name: "Middle East University"
}
]

Request

/search?name=Middle&offset=1&limit=1

Response

[
{
web_page: "http://www.odtu.edu.tr/",
country: "Turkey",
domain: "odtu.edu.tr",
name: "Middle East Technical University"
}
]

API Update Endpoint

If the university dataset changes, the API won't automatically update it. Use this endpoint to force a refresh.

Request

/update

Response

{
    'status': str,
    'message': str
}

Run the Project

  • Clone Project git clone https://github.com/Hipo/university-domains-list-api.git
  • Setup and activate your virtual environment
  • Install requirements pip install -r requirements.txt
  • Run server python app.py

Contribution

Please contribute to this list! We need your support to keep this list up-to-date. Do not hesitate to fix any wrong data. It is extremely easy. Just open a PR, or create an issue.

Created and maintained by Hipo

About

The API server for the University Domains

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages