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

## Authentication
All requests require your oanor API key in the `x-oanor-key` header. Get one at https://www.oanor.com/developer/keys.

```bash
curl -H "x-oanor-key: oanor_live_…" "https://api.oanor.com/universities-api/..."
```

## Pricing
- **Free** (Free) — 1,000 calls/Mo, 2 req/s
- **Starter** ($6/Mo) — 25,000 calls/Mo, 5 req/s
- **Pro** ($16/Mo) — 150,000 calls/Mo, 15 req/s
- **Mega** ($45/Mo) — 1,500,000 calls/Mo, 40 req/s

## Endpoints

### Universities

#### `GET /v1/search` — Search universities by name and country

**Parameters:**
- `q` (query, optional, string) — University name (substring) Example: `oxford`
- `country` (query, optional, string) — Country name or ISO-2 code Example: `GB`
- `limit` (query, optional, string) — Results per page (1-100, default 20) Example: `20`
- `offset` (query, optional, string) — Pagination offset Example: `0`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/universities-api/v1/search?q=oxford&country=GB&limit=20&offset=0"
```

**Response:**
```json
{
    "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",
                "state_province": null
            },
            {
                "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",
                "state_province": null
            }
        ]
    },
    "meta": {
        "timestamp": "2026-05-31T00:16:35.415Z",
        "request_id": "13f04e84-fd4a-4611-8489-38e3c37d4f09"
    },
    "status": "ok",
    "message": "Search completed",
    "success": true
}
```

#### `GET /v1/university` — A single university by domain or id

**Parameters:**
- `domain` (query, optional, string) — University email domain Example: `harvard.edu`
- `id` (query, optional, string) — Dataset id (alternative to domain)

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/universities-api/v1/university?domain=harvard.edu"
```

**Response:**
```json
{
    "data": {
        "id": 495,
        "name": "Harvard University",
        "country": "United States",
        "domains": [
            "harvard.edu"
        ],
        "web_pages": [
            "http://www.harvard.edu/"
        ],
        "country_code": "US",
        "state_province": null
    },
    "meta": {
        "timestamp": "2026-05-31T00:16:35.495Z",
        "request_id": "0311c68e-2b91-48e8-a5b9-0e2de3ae0b80"
    },
    "status": "ok",
    "message": "University retrieved",
    "success": true
}
```

### Countries

#### `GET /v1/countries` — Countries with university counts

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/universities-api/v1/countries"
```

**Response:**
```json
{
    "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",
                "unive
…(truncated, see openapi.json for full schema)
```

### Meta

#### `GET /v1/meta` — Dataset totals & source

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/universities-api/v1/meta"
```

**Response:**
```json
{
    "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
}
```


---
Marketplace page: https://www.oanor.com/api/universities-api
OpenAPI spec: https://www.oanor.com/api/universities-api/openapi.json