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:

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

aozalevsky/university-domains-list