University Domains and Names Data List & API
Do you need a list of universities and their domain names? You found it!
This package includes a JSON file that contains domains, names and countries of most of the universities of the world.
- You can create a validation script that checks the email domain.
- You can automatically generate a user's country and university by looking at their emails.
You can use this data source in three ways:
- Use the JSON file as your data source and do whatever you like with your favourite programming language.
- Use free hosted-API.
- Use the tiny Python app to serve a fast API that you can query data.
Update - New structure
After September of 2017, we changed our structure to support multiple domains and web pages. With this update, we added a State/Province field, "domain" and "web_page" fields changed as list with "domains" and "web_pages" fields respectively.
1 - Using the Data Source
The whole data source is located in the world_universities_and_domains.json
file. It is just a list of dictionaries in the following format:
[
...
{
"alpha_two_code": "TR",
"country": "Turkey",
"state-province": null,
"domains": [
"sabanciuniv.edu",
"sabanciuniv.edu.tr"
],
"name": "Sabanci University",
"web_pages": [
"http://www.sabanciuniv.edu/",
"http://www.sabanciuniv.edu.tr/"
],
},
...
]
If you want a smaller final payload and only need a subset of countries, run
filter.py $country1 [Optional: $country2]
from the root directory to return
filtered_world_universities_and_domains.json
NOTE: Some universities use a format like [user]@[department].[domain]
, but this list only contains the [domain]
portion.
For example, an email address might be [student]@cs.usc.edu
, and this list will contain 'usc.edu', the domain for the
University of Southern California. Take this into consideration if using this list for email address validation.
2 - Using Hosted API
This is the easiest method if you're making a small project or just want to discover the data without any hassle. It is sponsored by Hipo and free. If you have a big project, please host it on your own server.
Some example searches:
- http://universities.hipolabs.com
- http://universities.hipolabs.com/search?name=middle
- http://universities.hipolabs.com/search?name=middle&country=turkey
The hosted API uses university-domains-list-api package.
3 - Using the built-in API on your server
You can access the python API via university-domains-list-api
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.
Contributors
- Yiğit Güler
- Tuna Vargı
- Patrick Michelberger
- Rasim Demirbay
- Ryan White
- Bilal Arslan
- anwilli5
- Thomas Bauer
- Emin Mastizada
- Jai
- Jimi Ford
- Lars Schwegmann
- Sedat Karancı
- Charles Bedrosian
- Harrison Lo
- mattdfloyd
- Ender Ahmet Yurt
- Enis Behiç Tuysuz
- Syed Zakawat
- Daksh Shah
- Maizer Gomes
- Denys Vitali
- Ary Wibowo
- Matt Floyd
- Joris Boquet
- Konstantin Ladutenko
- Romain Odeval
- remediate
- Errorific
- summerplaybook
- hamedty
- Sedat
- Sotirios Roussis
- majilesh
- Itay Grudev
- luungoc2005
- Ajithkumar Sekar
- Christopher Chen
- Dimitris Karakostas
- Chun Fei Lung
- Mamat Rahmat
- Wisnu Adi Nurcahyo
- jvanstraten
- Ekin Dursun
- Kevin Bohinski
- Lachlan Marnham
- Baptiste Pellarin
- Kelian Baert