# Nobel Prize API
> Browse Nobel Prizes by year and category — physics, chemistry, medicine, literature, peace and economics — with laureates and their official citations, and look up laureate profiles by name or id with birth details and every prize won. Great for education, trivia, research and history apps.

## 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/nobel-api/..."
```

## Pricing
- **Free** (Free) — 2,000 calls/Mo, 2 req/s
- **Basic** ($6/Mo) — 80,000 calls/Mo, 8 req/s
- **Pro** ($19/Mo) — 450,000 calls/Mo, 25 req/s
- **Mega** ($49/Mo) — 2,000,000 calls/Mo, 80 req/s

## Endpoints

### Nobel

#### `GET /v1/laureate` — Laureate by id

**Parameters:**
- `id` (query, required, string) — Numeric laureate id Example: `6`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/nobel-api/v1/laureate?id=6"
```

**Response:**
```json
{
    "data": {
        "id": "6",
        "name": "Marie Curie",
        "birth": {
            "date": "1867-11-07",
            "place": "Warsaw",
            "country": "Russian Empire"
        },
        "death": {
            "date": "1934-07-04"
        },
        "gender": "female",
        "prizes": [
            {
                "year": "1903",
                "portion": "1/4",
                "category": "Physics",
                "motivation": "in recognition of the extraordinary services they have rendered by their joint researches on the radiation phenomena discovered by Professor Henri Becquerel"
            },
            {
                "year": "1911",
                "portion": "1",
                "category": "Chemistry",
                "motivation": "in recognition of her services to the advancement of chemistry by the discovery of the elements radium and polonium, by the isolation of radium and the study of the nature and compounds of this remarkable element"
            }
        ],
        "full_name": "Marie Curie, née Skłodowska"
    },
    "meta": {
        "timestamp": "2026-05-30T05:43:50.555Z",
        "request_id": "dfd8a829-3d17-4737-995d-c3513b3b96cd"
    },
    "status": "ok",
    "message": "Laureate retrieved",
    "success": true
}
```

#### `GET /v1/laureates` — Search laureates

**Parameters:**
- `name` (query, required, string) — Laureate name Example: `curie`
- `limit` (query, optional, string) — Max 1-50 Example: `15`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/nobel-api/v1/laureates?name=curie&limit=15"
```

**Response:**
```json
{
    "data": {
        "count": 3,
        "query": "curie",
        "results": [
            {
                "id": "194",
                "name": "Irène Joliot-Curie",
                "birth": {
                    "date": "1897-09-12",
                    "place": "Paris",
                    "country": "France"
                },
                "death": {
                    "date": "1956-03-17"
                },
                "gender": "female",
                "prizes": [
                    {
                        "year": "1935",
                        "portion": "1/2",
                        "category": "Chemistry",
                        "motivation": "in recognition of their synthesis of new radioactive elements"
                    }
                ],
                "full_name": "Irène Joliot-Curie"
            },
            {
                "id": "6",
                "name": "Marie Curie",
                "birth": {
                    "date": "1867-11-07",
                    "place": "Warsaw",
                    "country": "Russian Empire"
                },
                "death": {
                    "date": "1934-07-04"
                },
                "gender": "female",
                "prizes": [
                    {
                        "year": "1903",
                        "portion": "1/4",
                        "category": "Physics",
                        "motivation": "in recognition of the extraordinary services they ha
…(truncated, see openapi.json for full schema)
```

#### `GET /v1/prizes` — Nobel prizes

**Parameters:**
- `year` (query, optional, string) — Award year 1901+ Example: `2020`
- `category` (query, optional, string) — che eco lit pea phy med Example: `phy`
- `limit` (query, optional, string) — Max 1-50 Example: `25`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/nobel-api/v1/prizes?year=2020&category=phy&limit=25"
```

**Response:**
```json
{
    "data": {
        "year": 2020,
        "count": 1,
        "results": [
            {
                "year": "2020",
                "category": "Physics",
                "laureates": [
                    {
                        "id": "988",
                        "name": "Roger Penrose",
                        "portion": "1/2",
                        "motivation": "for the discovery that black hole formation is a robust prediction of the general theory of relativity",
                        "sort_order": "1"
                    },
                    {
                        "id": "989",
                        "name": "Reinhard Genzel",
                        "portion": "1/4",
                        "motivation": "for the discovery of a supermassive compact object at the centre of our galaxy",
                        "sort_order": "2"
                    },
                    {
                        "id": "990",
                        "name": "Andrea Ghez",
                        "portion": "1/4",
                        "motivation": "for the discovery of a supermassive compact object at the centre of our galaxy",
                        "sort_order": "3"
                    }
                ],
                "prize_amount": 10000000,
                "category_code": null
            }
        ],
        "category": "phy"
    },
    "meta": {
        "timestamp": "2026-05-30T05:42:51.359Z",
        "request_id": "9d8cc320-189c-4e27-abf1-bd0db771e0
…(truncated, see openapi.json for full schema)
```


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