Skip to content

Latest commit

 

History

History
127 lines (104 loc) · 3.73 KB

README.md

File metadata and controls

127 lines (104 loc) · 3.73 KB
Raw

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
  • Baptiste Pellarin

Created and maintained by Hipo