Skip to content
University Domains and Names Data List & API
Branch: master
Clone or download
yigitguler Merge pull request #194 from ChFlick/master
Fix name and domain of TU Dortmund
Latest commit 967e4f2 May 17, 2019
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
tests Refactor tests Jan 21, 2019
.travis.yml Forgot to update .travis.yml Sep 14, 2017
LICENSE.txt license added Mar 24, 2016
README.md Added DUT MMI - Université Bordeaux Montaigne. Oct 4, 2018
world_universities_and_domains.json Fix name and domain of TU Dortmund May 17, 2019

README.md

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/"
	    ],
	},
	...
]

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

Created and maintained by Hipo

You can’t perform that action at this time.