Swot 🍎

If you have a product or service and offer academic discounts, there's a good chance there's some manual component to the approval process. Perhaps .edu email addresses are automatically approved because, for the most part at least, they're associated with American post-secondary educational institutions. Perhaps .ac.uk email addresses are automatically approved because they're guaranteed to belong to British universities and colleges. Unfortunately, not every country has an education-specific TLD (Top Level Domain) and plenty of schools use .com or .net.

Swot is a community-driven or crowdsourced library for verifying that domain names and email addresses are tied to a legitimate university of college - more specifically, an academic institution providing higher education in tertiary, quaternary or any other kind of post-secondary education in any country in the world.

Pop quiz: Which of the following domain names should be eligible for an academic discount? stanford.edu, america.edu, duep.edu, gla.ac.uk, unizar.es, usask.ca, hil.no, unze.ba, fu-berlin.de, ecla.de, bvb.de, lsmu.com. Answers at the foot of the page.

which has since been archived. The original gem has gotten overwhelmed by false pull requests and issues. This fork removes the responsibility of maintaining the list of domains and emails from the gem and instead relies on a submodule to be updated. There is a nightly job which will update the submodule and push the changes to this repo. However, to pick up the new domains, a gem release will be required. I'm still considering the best path for this.

Since there is a reliance on the submodule's data being updated, there will be periodic releases that do not contain any code changes of this library. However, this library will follow the Semantic versioning + a date stamp of the latest list of academic institutions.

For example, the gem 1.0.2.20230618 references to the gem version 1.0.2 and the list of academic institutions was last updated on June 18th, 2023.

Or add this to your Gemfile before doing a bundle install:

gem 'swot-ruby', require 'swot'

Do not ref this repo directly in your Gemfile. It will not work. It relies on the submodule to be updated.

• Ruby >= 2.7

Other versions of Ruby may work, but the gem is tested against the above versions.

Swot::is_academic? 'lreilly@stanford.edu'           # true
Swot::is_academic? 'lreilly@strath.ac.uk'           # true
Swot::is_academic? 'lreilly@soft-eng.strath.ac.uk'  # true
Swot::is_academic? 'pedro@ugr.es'                   # true
Swot::is_academic? 'lee@uottawa.ca'                 # true
Swot::is_academic? 'lee@leerilly.net'               # false

Swot::is_academic? 'harvard.edu'              # true
Swot::is_academic? 'www.harvard.edu'          # true
Swot::is_academic? 'http://www.harvard.edu'   # true
Swot::is_academic? 'http://www.github.com'    # false
Swot::is_academic? 'http://www.rangers.co.uk' # false

Swot::school_name 'lreilly@cs.strath.ac.uk'
# => "University of Strathclyde"

Swot::school_name 'http://www.stanford.edu'
# => "Stanford University"

Contributions welcome! Please see the contribution guidelines for details on how to add, update, or delete schools.

Thanks to @lreilly for the original implementation and you can find more thanks for the original contributors on the original repo.

• You can search by email and domain names only. You cannot search by IP.
• You don't know if the email address belongs to a student, faculty, staff member, alumni, or a contractor.
• There may be a few false positives, missing institutions... maybe even a couple of typos. Contributions welcome!

Please note: just because someone has verified that they own lreilly@stanford.edu does not mean that they're a student. They could be faculty, staff, alumnni, or maybe even an external contractor. If you're suddenly getting a lot of traffic from websites like FatWallet or SlickDeals, you might want to find out why. If you're suddenly getting a lot of requests from a particular school, you should look into that too. It may be good business, word of mouth, or someone may have found a loophole. Swot gives you a high confidence level - not a guarantee. I recommend putting some controls in place or at least monitor how it's doing from time to time.

Hopefully, you'll be surprised by some of this:

If you verified this by visiting all of the websites, how long did it take you? Did you have fun? Imagine you had to do this 10 - 100 times every day. Now you know a little something about the inspiration for Swot. Swot can verify them all in a fraction of a second and remove a 💩 part of someone's job.

https://github.com/jetbrains/swot is the canonical source of truth for the list of domains. If you want to add a new domain, please submit a pull request there. This database is updated periodically based on the information in that repository.