{"openapi":"3.1.0","info":{"title":"Universities API","version":"1.0.0","description":"Search a database of 10,000+ universities and colleges worldwide (Hipolabs open dataset). Find institutions by name and country, look one up by its email domain, and browse counts per country. Each record includes the official name, country, region, email domains and websites — ideal for sign-up forms, student-email verification, education directories and enrichment.","contact":{"name":"PremiumApi","url":"https://www.oanor.com/by/premiumapi"}},"servers":[{"url":"https://api.oanor.com/universities-api","description":"oanor gateway"}],"tags":[{"name":"Universities"},{"name":"Countries"},{"name":"Meta"}],"components":{"securitySchemes":{"oanorKey":{"type":"apiKey","in":"header","name":"x-oanor-key","description":"Get your key at https://www.oanor.com/developer/keys"}}},"security":[{"oanorKey":[]}],"paths":{"/v1/search":{"get":{"operationId":"get_v1_search","tags":["Universities"],"summary":"Search universities by name and country","description":"","parameters":[{"name":"q","in":"query","required":false,"description":"University name (substring)","schema":{"type":"string"},"example":"oxford"},{"name":"country","in":"query","required":false,"description":"Country name or ISO-2 code","schema":{"type":"string"},"example":"GB"},{"name":"limit","in":"query","required":false,"description":"Results per page (1-100, default 20)","schema":{"type":"string"},"example":"20"},{"name":"offset","in":"query","required":false,"description":"Pagination offset","schema":{"type":"string"},"example":"0"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"count":2,"limit":20,"total":2,"offset":0,"filters":{"q":"oxford","country":"GB"},"results":[{"id":8395,"name":"Oxford Brookes University","country":"United Kingdom","domains":["brookes.ac.uk"],"web_pages":["http://www.brookes.ac.uk/"],"country_code":"GB"},{"id":8474,"name":"University of Oxford","country":"United Kingdom","domains":["oxford.ac.uk","ox.ac.uk"],"web_pages":["http://www.ox.ac.uk/"],"country_code":"GB"}]},"meta":{"timestamp":"2026-05-31T00:16:35.415Z","request_id":"13f04e84-fd4a-4611-8489-38e3c37d4f09"},"status":"ok","message":"Search completed","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/university":{"get":{"operationId":"get_v1_university","tags":["Universities"],"summary":"A single university by domain or id","description":"","parameters":[{"name":"domain","in":"query","required":false,"description":"University email domain","schema":{"type":"string"},"example":"harvard.edu"},{"name":"id","in":"query","required":false,"description":"Dataset id (alternative to domain)","schema":{"type":"string"}}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"id":495,"name":"Harvard University","country":"United States","domains":["harvard.edu"],"web_pages":["http://www.harvard.edu/"],"country_code":"US"},"meta":{"timestamp":"2026-05-31T00:16:35.495Z","request_id":"0311c68e-2b91-48e8-a5b9-0e2de3ae0b80"},"status":"ok","message":"University retrieved","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/countries":{"get":{"operationId":"get_v1_countries","tags":["Countries"],"summary":"Countries with university counts","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"count":201,"countries":[{"country":"United States","universities":2348},{"country":"Japan","universities":572},{"country":"India","universities":474},{"country":"China","universities":398},{"country":"Germany","universities":320},{"country":"Russian Federation","universities":308},{"country":"France","universities":293},{"country":"Korea, Republic of","universities":244},{"country":"United Kingdom","universities":193},{"country":"Iran","universities":193},{"country":"Indonesia","universities":192},{"country":"Turkiye","universities":188},{"country":"Brazil","universities":187},{"country":"Mexico","universities":166},{"country":"Canada","universities":156},{"country":"Malaysia","universities":152},{"country":"Poland","universities":138},{"country":"Pakistan","universities":136},{"country":"Argentina","universities":121},{"country":"Philippines","universities":118},{"country":"Nigeria","universities":115},{"country":"Colombia","universities":104},{"country":"Spain","universities":96},{"country":"Italy","universities":93},{"country":"Taiwan, Province of China","universities":86},{"country":"Bangladesh","universities":83},{"country":"Switzerland","universities":76},{"country":"Ukraine","universities":75},{"country":"Peru","universities":67},{"country":"Thailand","universities":67},{"country":"Chile","universities":65},{"country":"Portugal","universities":65},{"country":"Romania","universities":63},{"country":"Saudi Arabia","universities":63},{"country":"Australia","universities":59},{"country":"Belgium","universities":50},{"country":"Kenya","universities":49},{"country":"Viet Nam","universities":49},{"country":"Netherlands","universities":48},{"country":"Iraq","universities":47},{"country":"Austria","universities":46},{"country":"Egypt","universities":44},{"country":"Ecuador","universities":43},{"country":"Hungary","universities":42},{"country":"Afghanistan","universities":40},{"country":"United Arab Emirates","universities":37},{"country":"Bulgaria","universities":37},{"country":"Venezuela, Bolivarian Republic of","universities":37},{"country":"Sweden","universities":36},{"country":"Finland","universities":35},{"country":"Sudan","universities":35},{"country":"Belarus","universities":34},{"country":"Denmark","universities":34},{"country":"Greece","universities":33},{"country":"Morocco","universities":33},{"country":"Azerbaijan","universities":32},{"country":"Costa Rica","universities":32},{"country":"Ghana","universities":31},{"country":"Bolivia, Plurinational State of","universities":31},{"country":"Slovakia","universities":31},{"country":"Czech Republic","universities":30},{"country":"Ethiopia","universities":30},{"country":"Algeria","universities":29},{"country":"Jordan","universities":29},{"country":"Kazakhstan","universities":29},{"country":"South Africa","universities":29},{"country":"Ireland","universities":27},{"country":"Sri Lanka","universities":27},{"country":"Dominican Republic","universities":26},{"country":"El Salvador","universities":25},{"country":"Norway","universities":25},{"country":"Puerto Rico","universities":25},{"country":"Israel","universities":24},{"country":"Latvia","universities":24},{"country":"Lebanon","universities":24},{"country":"Uzbekistan","universities":23},{"country":"Cambodia","universities":21},{"country":"Tanzania, United Republic of","universities":19},{"country":"Tunisia","universities":19},{"country":"Uganda","universities":18},{"country":"Singapore","universities":18},{"country":"Cyprus","universities":17},{"country":"Lithuania","universities":17},{"country":"Nicaragua","universities":17},{"country":"Panama","universities":17},{"country":"Somalia","universities":17},{"country":"Albania","universities":16},{"country":"Bosnia and Herzegovina","universities":16},{"country":"Palestine, State of","universities":16},{"country":"Georgia","universities":15},{"country":"Hong Kong","universities":15},{"country":"Nepal","universities":15},{"country":"Syrian Arab Republic","universities":15},{"country":"Zimbabwe","universities":15},{"country":"Paraguay","universities":14},{"country":"Cuba","universities":13},{"country":"Kyrgyzstan","universities":13},{"country":"Serbia","universities":13},{"country":"Yemen","universities":13},{"country":"Armenia","universities":12},{"country":"Bahrain","universities":12},{"country":"Croatia","universities":12},{"country":"Moldova, Republic of","universities":12},{"country":"New Zealand","universities":12},{"country":"Guatemala","universities":11},{"country":"Libya","universities":11},{"country":"Mongolia","universities":11},{"country":"Oman","universities":11},{"country":"Rwanda","universities":11},{"country":"Cameroon","universities":10},{"country":"Congo, the Democratic Republic of the","universities":10},{"country":"Estonia","universities":10},{"country":"Iceland","universities":10},{"country":"Senegal","universities":10},{"country":"Botswana","universities":9},{"country":"Honduras","universities":9},{"country":"North Macedonia","universities":9},{"country":"Vietnam","universities":9},{"country":"Angola","universities":8},{"country":"Kuwait","universities":8},{"country":"Malawi","universities":8},{"country":"Mozambique","universities":8},{"country":"Zambia","universities":7},{"country":"Haiti","universities":6},{"country":"Madagascar","universities":6},{"country":"Uruguay","universities":6},{"country":"Belize","universities":5},{"country":"Myanmar","universities":5},{"country":"Holy See (Vatican City State)","universities":5},{"country":"Kosovo","universities":5},{"country":"Namibia","universities":5},{"country":"Papua New Guinea","universities":5},{"country":"Qatar","universities":5},{"country":"Côte d'Ivoire","universities":4},{"country":"Fiji","universities":4},{"country":"Guinea","universities":4},{"country":"Guyana","universities":4},{"country":"Macao","universities":4},{"country":"Malta","universities":4},{"country":"Saint Kitts and Nevis","universities":4},{"country":"Sierra Leone","universities":4},{"country":"Slovenia","universities":4},{"country":"Benin","universities":3},{"country":"Brunei Darussalam","universities":3},{"country":"Burundi","universities":3},{"country":"Dominica","universities":3},{"country":"Gambia","universities":3},{"country":"Jamaica","universities":3},{"country":"Maldives","universities":3},{"country":"Tajikistan","universities":3},{"country":"Trinidad and Tobago","universities":3},{"country":"Antigua and Barbuda","universities":2},{"country":"Cayman Islands","universities":2},{"country":"Lao People's Democratic Republic","universities":2},{"country":"Liechtenstein","universities":2},{"country":"Luxembourg","universities":2},{"country":"Mauritius","universities":2},{"country":"Seychelles","universities":2},{"country":"South Sudan","universities":2},{"country":"Andorra","universities":1},{"country":"Bahamas","universities":1},{"country":"Barbados","universities":1},{"country":"Bermuda","universities":1},{"country":"Bhutan","universities":1},{"country":"Burkina Faso","universities":1},{"country":"Cape Verde","universities":1},{"country":"Central African Republic","universities":1},{"country":"Chad","universities":1},{"country":"Congo","universities":1},{"country":"Djibouti","universities":1},{"country":"Equatorial Guinea","universities":1},{"country":"Eritrea","universities":1},{"country":"Faroe Islands","universities":1},{"country":"French Guiana","universities":1},{"country":"French Polynesia","universities":1},{"country":"Gabon","universities":1},{"country":"Greenland","universities":1},{"country":"Grenada","universities":1},{"country":"Guadeloupe","universities":1},{"country":"Guam","universities":1},{"country":"Korea, Democratic People's Republic of","universities":1},{"country":"Lesotho","universities":1},{"country":"Liberia","universities":1},{"country":"Mali","universities":1},{"country":"Mauritania","universities":1},{"country":"Montenegro","universities":1},{"country":"Montserrat","universities":1},{"country":"New Caledonia","universities":1},{"country":"Niger","universities":1},{"country":"Niue","universities":1},{"country":"Réunion","universities":1},{"country":"Saint Lucia","universities":1},{"country":"Saint Vincent and the Grenadines","universities":1},{"country":"Samoa","universities":1},{"country":"San Marino","universities":1},{"country":"Suriname","universities":1},{"country":"Swaziland","universities":1},{"country":"Togo","universities":1},{"country":"Turkmenistan","universities":1},{"country":"Turks and Caicos Islands","universities":1},{"country":"Virgin Islands, British","universities":1}],"total_universities":10249},"meta":{"timestamp":"2026-05-31T00:16:35.570Z","request_id":"a57d0d1b-05a2-4dd0-a2fe-467fd08be953"},"status":"ok","message":"Countries retrieved","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/meta":{"get":{"operationId":"get_v1_meta","tags":["Meta"],"summary":"Dataset totals & source","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"total":10249,"fields":["id","name","country","country_code","state_province","domains","web_pages"],"source":"Hipolabs university-domains-list","countries":201},"meta":{"timestamp":"2026-05-31T00:16:35.619Z","request_id":"51a5cbc7-b901-48a7-b083-2fbc2a0479d2"},"status":"ok","message":"Meta retrieved","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}}},"x-oanor-pricing":[{"slug":"free","name":"Free","price_cents_month":0,"monthly_call_quota":1000,"rps_limit":2,"hard_limit":true},{"slug":"starter","name":"Starter","price_cents_month":600,"monthly_call_quota":25000,"rps_limit":5,"hard_limit":true},{"slug":"pro","name":"Pro","price_cents_month":1600,"monthly_call_quota":150000,"rps_limit":15,"hard_limit":true},{"slug":"mega","name":"Mega","price_cents_month":4500,"monthly_call_quota":1500000,"rps_limit":40,"hard_limit":true}],"x-oanor-marketplace-url":"https://www.oanor.com/api/universities-api"}