https://github.com/Hipo/university-domains-list

University Domains and Names Data List & API
https://github.com/Hipo/university-domains-list

Last synced: 7 months ago
JSON representation

University Domains and Names Data List & API

• Host: GitHub
• URL: https://github.com/Hipo/university-domains-list
• Owner: Hipo
• License: mit
• Created: 2014-10-22T18:07:51.000Z (about 11 years ago)
• Default Branch: master
• Last Pushed: 2024-11-05T11:34:11.000Z (about 1 year ago)
• Last Synced: 2024-11-11T18:11:40.643Z (about 1 year ago)
• Language: Python
• Homepage:
• Size: 25.4 MB
• Stars: 1,315
• Watchers: 26
• Forks: 443
• Open Issues: 66
• Metadata Files:
  • Readme: README.md
  • License: LICENSE.txt

Awesome Lists containing this project

• public-apis - Universities List
• fucking-public-apis - Universities List
• public-apis - Universities List
• Awesome-API-Provider - Universities List
• public-apis - Universities List

README

          
# 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.

Example usecases: 

- 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.

### 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

```bash

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 The 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](http://www.hipolabs.com) 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](https://github.com/Hipo/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](https://github.com/Hipo/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

- [more](https://github.com/Hipo/university-domains-list/graphs/contributors)

### Created and maintained by [Hipo](http://www.hipolabs.com)