# Nobel Prize

> Look up every Nobel Prize and Nobel laureate since 1901 from the Nobel Foundation's own open data: search the prizes by year and category, get one prize or one year's full slate, and search laureates by name, gender, motivation, affiliation, dates, or where they were born. No account or API key required.

App · Research & Academia · 10 actions. Web page: https://docs.lodol.com/docs/integrations/nobel-prize

## Actions

### Count laureates

Count the laureates matching a filter without fetching them all: how many women have won the Physics prize, how many laureates were born in a country, how many motivations mention a subject. Returns the total and one example.

**Inputs**

- Gender (`gender`, text): Count laureates of one gender. Organizations have none, so setting this leaves them out. One of: `female`, `male`, `other`.
- Category (`category`, text): Count laureates of one prize category. One of: `che` (Chemistry), `eco` (Economic Sciences), `lit` (Literature), `pea` (Peace), `phy` (Physics), `med` (Physiology or Medicine).
- Prize year (`prize_year`, number): Count laureates awarded a prize in this year. With Prize end year set, this starts a range. At least 1901.
- Prize end year (`prize_year_to`, number): The last year of a prize-year range. Only narrows a range, so Prize year is required alongside it. At least 1901.
- Country of birth (`birth_country`, text): Count laureates born in this country, named as it was at the time.
- Continent of birth (`birth_continent`, text): Count laureates born on this continent. One of: `Africa`, `Asia`, `Europe`, `North America`, `Oceania`, `South America`, `Antarctica`.
- Motivation contains (`motivation`, text): Count laureates whose motivation contains this text.
- Language (`language`, text): Which language to return names, categories and motivations in. Defaults to English; a field the Nobel Foundation has not translated falls back to English. One of: `en` (English), `se` (Swedish), `no` (Norwegian).

**Outputs**

- `count` (number)
- `filters` (object)
- `sample_laureate` (text)

**Example output**

```json
{
  "count": 26,
  "filters": {
    "gender": "female",
    "nobelPrizeCategory": "phy"
  },
  "sample_laureate": "Marie Curie, n\u00e9e Sklodowska"
}
```

### Find laureates by name

Find the laureates whose name contains the search text. This is how a workflow turns a name into the numeric ID that Get a laureate takes.

**Inputs**

- Name (`name`, text, required): Text the laureate's name contains. Matches people and organizations.
- Number of results (`limit`, number): How many laureates to return (1-100). Defaults to 25. From 1 to 100.
- Skip (`offset`, number): How many matching records to skip before collecting results. Use it with Number of results to page through a large search. At least 0.
- Language (`language`, text): Which language to return names, categories and motivations in. Defaults to English; a field the Nobel Foundation has not translated falls back to English. One of: `en` (English), `se` (Swedish), `no` (Norwegian).

**Outputs**

- `has_more` (true/false)
- `laureate_count` (number)
- `laureates` (list)
- `limit` (number)
- `offset` (number)
- `total_count` (number)

**Example output**

```json
{
  "has_more": false,
  "laureate_count": 1,
  "laureates": [
    {
      "acronym": null,
      "birth_date": "1879-03-14",
      "birth_place": {
        "city": "Ulm",
        "city_now": "Ulm",
        "continent": "Europe",
        "country": "Germany",
        "country_now": "Germany",
        "location": "Ulm, Germany"
      },
      "death_date": "1955-04-18",
      "death_place": {
        "city": "Princeton, NJ",
        "city_now": "Princeton, NJ",
        "continent": "North America",
        "country": "USA",
        "country_now": "USA",
        "location": "Princeton, NJ, USA"
      },
      "dissolution_date": null,
      "dissolution_place": {},
      "family_name": "Einstein",
      "founded_date": null,
      "founded_place": {},
      "full_name": "Albert Einstein",
      "gender": "male",
      "given_name": "Albert",
      "headquarters": {},
      "id": 26,
      "name": "Albert Einstein",
      "native_name": null,
      "penname": null,
      "prize_categories": [
        "Physics"
      ],
      "prize_count": 1,
      "prize_years": [
        1921
      ],
      "prizes": [
        {
          "affiliations": [
            {
              "city": "Berlin",
              "country": "Germany",
              "location": "Berlin, Germany",
              "name": "Kaiser-Wilhelm-Institut f\u00fcr Physik",
              "name_now": "Kaiser-Wilhelm-Institut f\u00fcr Physik",
              "native_name": "Kaiser-Wilhelm-Institut f\u00fcr Physik"
            }
          ],
          "award_year": 1921,
          "category": "Physics",
          "category_code": "phy",
          "category_full_name": "The Nobel Prize in Physics",
          "date_awarded": "1922-11-09",
          "motivation": "for his services to Theoretical Physics, and especially for his discovery of the law of the photoelectric effect",
          "portion": "1",
          "prize_amount": 121572,
          "prize_amount_adjusted": 2900000,
          "prize_status": "received",
          "residences": [],
          "sort_order": "1"
        }
      ],
      "same_as": [
        "https://www.wikidata.org/wiki/Q937"
      ],
      "type": "person",
      "wikidata_url": "https://www.wikidata.org/wiki/Q937",
      "wikipedia_url": "https://en.wikipedia.org/wiki/Albert_Einstein"
    }
  ],
  "limit": 25,
  "offset": 0,
  "total_count": 1
}
```

### Find laureates by place

Find laureates by where they were born or died, or where an organization was founded or is headquartered. Pick which of those the country, city and continent apply to; at least one of the three is required.

**Inputs**

- Place (`place_kind`, text): Which place the country, city and continent refer to. Defaults to place of birth. One of: `birth` (Place of birth), `death` (Place of death), `founded` (Where an organization was founded), `headquarters` (Where an organization is headquartered).
- Country (`country`, text): The country's name as it was at the time, such as 'Japan' or 'Prussia'.
- City (`city`, text): The city's name as it was at the time.
- Continent (`continent`, text): The continent, as geonames.org names them. One of: `Africa`, `Asia`, `Europe`, `North America`, `Oceania`, `South America`, `Antarctica`.
- Category (`category`, text): Narrow to laureates of one prize category. One of: `che` (Chemistry), `eco` (Economic Sciences), `lit` (Literature), `pea` (Peace), `phy` (Physics), `med` (Physiology or Medicine).
- Number of results (`limit`, number): How many laureates to return (1-100). Defaults to 25. From 1 to 100.
- Skip (`offset`, number): How many matching records to skip before collecting results. Use it with Number of results to page through a large search. At least 0.
- Language (`language`, text): Which language to return names, categories and motivations in. Defaults to English; a field the Nobel Foundation has not translated falls back to English. One of: `en` (English), `se` (Swedish), `no` (Norwegian).

**Outputs**

- `has_more` (true/false)
- `laureate_count` (number)
- `laureates` (list)
- `limit` (number)
- `offset` (number)
- `place_kind` (text)
- `total_count` (number)

**Example output**

```json
{
  "has_more": false,
  "laureate_count": 1,
  "laureates": [
    {
      "acronym": null,
      "birth_date": "1879-03-14",
      "birth_place": {
        "city": "Ulm",
        "city_now": "Ulm",
        "continent": "Europe",
        "country": "Germany",
        "country_now": "Germany",
        "location": "Ulm, Germany"
      },
      "death_date": "1955-04-18",
      "death_place": {
        "city": "Princeton, NJ",
        "city_now": "Princeton, NJ",
        "continent": "North America",
        "country": "USA",
        "country_now": "USA",
        "location": "Princeton, NJ, USA"
      },
      "dissolution_date": null,
      "dissolution_place": {},
      "family_name": "Einstein",
      "founded_date": null,
      "founded_place": {},
      "full_name": "Albert Einstein",
      "gender": "male",
      "given_name": "Albert",
      "headquarters": {},
      "id": 26,
      "name": "Albert Einstein",
      "native_name": null,
      "penname": null,
      "prize_categories": [
        "Physics"
      ],
      "prize_count": 1,
      "prize_years": [
        1921
      ],
      "prizes": [
        {
          "affiliations": [
            {
              "city": "Berlin",
              "country": "Germany",
              "location": "Berlin, Germany",
              "name": "Kaiser-Wilhelm-Institut f\u00fcr Physik",
              "name_now": "Kaiser-Wilhelm-Institut f\u00fcr Physik",
              "native_name": "Kaiser-Wilhelm-Institut f\u00fcr Physik"
            }
          ],
          "award_year": 1921,
          "category": "Physics",
          "category_code": "phy",
          "category_full_name": "The Nobel Prize in Physics",
          "date_awarded": "1922-11-09",
          "motivation": "for his services to Theoretical Physics, and especially for his discovery of the law of the photoelectric effect",
          "portion": "1",
          "prize_amount": 121572,
          "prize_amount_adjusted": 2900000,
          "prize_status": "received",
          "residences": [],
          "sort_order": "1"
        }
      ],
      "same_as": [
        "https://www.wikidata.org/wiki/Q937"
      ],
      "type": "person",
      "wikidata_url": "https://www.wikidata.org/wiki/Q937",
      "wikipedia_url": "https://en.wikipedia.org/wiki/Albert_Einstein"
    }
  ],
  "limit": 25,
  "offset": 0,
  "place_kind": "birth",
  "total_count": 1
}
```

### Get a laureate

Get one laureate's full record by their numeric ID: their biography or founding details, links to Wikipedia and Wikidata, and every prize they have won with its motivation and their share of it.

**Inputs**

- Laureate ID (`laureate_id`, text, required): The laureate's numeric ID, as returned by any of the search actions.
- Language (`language`, text): Which language to return names, categories and motivations in. Defaults to English; a field the Nobel Foundation has not translated falls back to English. One of: `en` (English), `se` (Swedish), `no` (Norwegian).

**Outputs**

- `laureate` (object)

**Example output**

```json
{
  "laureate": {
    "acronym": null,
    "birth_date": "1879-03-14",
    "birth_place": {
      "city": "Ulm",
      "city_now": "Ulm",
      "continent": "Europe",
      "country": "Germany",
      "country_now": "Germany",
      "location": "Ulm, Germany"
    },
    "death_date": "1955-04-18",
    "death_place": {
      "city": "Princeton, NJ",
      "city_now": "Princeton, NJ",
      "continent": "North America",
      "country": "USA",
      "country_now": "USA",
      "location": "Princeton, NJ, USA"
    },
    "dissolution_date": null,
    "dissolution_place": {},
    "family_name": "Einstein",
    "founded_date": null,
    "founded_place": {},
    "full_name": "Albert Einstein",
    "gender": "male",
    "given_name": "Albert",
    "headquarters": {},
    "id": 26,
    "name": "Albert Einstein",
    "native_name": null,
    "penname": null,
    "prize_categories": [
      "Physics"
    ],
    "prize_count": 1,
    "prize_years": [
      1921
    ],
    "prizes": [
      {
        "affiliations": [
          {
            "city": "Berlin",
            "country": "Germany",
            "location": "Berlin, Germany",
            "name": "Kaiser-Wilhelm-Institut f\u00fcr Physik",
            "name_now": "Kaiser-Wilhelm-Institut f\u00fcr Physik",
            "native_name": "Kaiser-Wilhelm-Institut f\u00fcr Physik"
          }
        ],
        "award_year": 1921,
        "category": "Physics",
        "category_code": "phy",
        "category_full_name": "The Nobel Prize in Physics",
        "date_awarded": "1922-11-09",
        "motivation": "for his services to Theoretical Physics, and especially for his discovery of the law of the photoelectric effect",
        "portion": "1",
        "prize_amount": 121572,
        "prize_amount_adjusted": 2900000,
        "prize_status": "received",
        "residences": [],
        "sort_order": "1"
      }
    ],
    "same_as": [
      "https://www.wikidata.org/wiki/Q937"
    ],
    "type": "person",
    "wikidata_url": "https://www.wikidata.org/wiki/Q937",
    "wikipedia_url": "https://en.wikipedia.org/wiki/Albert_Einstein"
  }
}
```

### Get a Nobel Prize

Get one Nobel Prize by the category and year that identify it, with its laureates, their shares of the prize and their motivations. For the winners' full biographies, use Get the laureates of a prize instead.

**Inputs**

- Category (`category`, text, required): Which of the six prize categories to get. One of: `che` (Chemistry), `eco` (Economic Sciences), `lit` (Literature), `pea` (Peace), `phy` (Physics), `med` (Physiology or Medicine).
- Year (`year`, number, required): The award year, as YYYY. At least 1901.
- Language (`language`, text): Which language to return names, categories and motivations in. Defaults to English; a field the Nobel Foundation has not translated falls back to English. One of: `en` (English), `se` (Swedish), `no` (Norwegian).

**Outputs**

- `prize` (object)

**Example output**

```json
{
  "prize": {
    "award_year": 1921,
    "awarded": true,
    "category": "Physics",
    "category_code": "phy",
    "category_full_name": "The Nobel Prize in Physics",
    "date_awarded": "1922-11-09",
    "laureate_count": 1,
    "laureate_names": [
      "Albert Einstein"
    ],
    "laureates": [
      {
        "id": 26,
        "motivation": "for his services to Theoretical Physics, and especially for his discovery of the law of the photoelectric effect",
        "name": "Albert Einstein",
        "portion": "1",
        "sort_order": "1"
      }
    ],
    "prize_amount": 121572,
    "prize_amount_adjusted": 2900000,
    "top_motivation": null
  }
}
```

### Get the latest prizes

Get the most recently awarded Nobel Prizes, newest year first, optionally narrowed to one category. This is the "who just won?" question, with no year to fill in.

**Inputs**

- Category (`category`, text): Narrow to one category, to get that category's most recent prizes. Leave blank for all of them. One of: `che` (Chemistry), `eco` (Economic Sciences), `lit` (Literature), `pea` (Peace), `phy` (Physics), `med` (Physiology or Medicine).
- Number of results (`limit`, number): How many prizes to return (1-100). Defaults to 6, one award year's worth. From 1 to 100.
- Language (`language`, text): Which language to return names, categories and motivations in. Defaults to English; a field the Nobel Foundation has not translated falls back to English. One of: `en` (English), `se` (Swedish), `no` (Norwegian).

**Outputs**

- `latest_year` (number)
- `prize_count` (number)
- `prizes` (list)

**Example output**

```json
{
  "latest_year": 1921,
  "prize_count": 1,
  "prizes": [
    {
      "award_year": 1921,
      "awarded": true,
      "category": "Physics",
      "category_code": "phy",
      "category_full_name": "The Nobel Prize in Physics",
      "date_awarded": "1922-11-09",
      "laureate_count": 1,
      "laureate_names": [
        "Albert Einstein"
      ],
      "laureates": [
        {
          "id": 26,
          "motivation": "for his services to Theoretical Physics, and especially for his discovery of the law of the photoelectric effect",
          "name": "Albert Einstein",
          "portion": "1",
          "sort_order": "1"
        }
      ],
      "prize_amount": 121572,
      "prize_amount_adjusted": 2900000,
      "top_motivation": null
    }
  ]
}
```

### Get the laureates of a prize

Get the full record of everyone who shared one Nobel Prize: their biography, where they were born, the institution they worked at, and every other prize they have won. Each record also carries the single prize entry this category and year refer to.

**Inputs**

- Category (`category`, text, required): Which of the six prize categories to look up. One of: `che` (Chemistry), `eco` (Economic Sciences), `lit` (Literature), `pea` (Peace), `phy` (Physics), `med` (Physiology or Medicine).
- Year (`year`, number, required): The award year, as YYYY. At least 1901.
- Language (`language`, text): Which language to return names, categories and motivations in. Defaults to English; a field the Nobel Foundation has not translated falls back to English. One of: `en` (English), `se` (Swedish), `no` (Norwegian).

**Outputs**

- `category` (text)
- `category_code` (text)
- `laureate_count` (number)
- `laureates` (list)
- `year` (number)

**Example output**

```json
{
  "category": "Physics",
  "category_code": "phy",
  "laureate_count": 1,
  "laureates": [
    {
      "acronym": null,
      "birth_date": "1879-03-14",
      "birth_place": {
        "city": "Ulm",
        "city_now": "Ulm",
        "continent": "Europe",
        "country": "Germany",
        "country_now": "Germany",
        "location": "Ulm, Germany"
      },
      "death_date": "1955-04-18",
      "death_place": {
        "city": "Princeton, NJ",
        "city_now": "Princeton, NJ",
        "continent": "North America",
        "country": "USA",
        "country_now": "USA",
        "location": "Princeton, NJ, USA"
      },
      "dissolution_date": null,
      "dissolution_place": {},
      "family_name": "Einstein",
      "founded_date": null,
      "founded_place": {},
      "full_name": "Albert Einstein",
      "gender": "male",
      "given_name": "Albert",
      "headquarters": {},
      "id": 26,
      "name": "Albert Einstein",
      "native_name": null,
      "penname": null,
      "prize": {
        "affiliations": [
          {
            "city": "Berlin",
            "country": "Germany",
            "location": "Berlin, Germany",
            "name": "Kaiser-Wilhelm-Institut f\u00fcr Physik",
            "name_now": "Kaiser-Wilhelm-Institut f\u00fcr Physik",
            "native_name": "Kaiser-Wilhelm-Institut f\u00fcr Physik"
          }
        ],
        "award_year": 1921,
        "category": "Physics",
        "category_code": "phy",
        "category_full_name": "The Nobel Prize in Physics",
        "date_awarded": "1922-11-09",
        "motivation": "for his services to Theoretical Physics, and especially for his discovery of the law of the photoelectric effect",
        "portion": "1",
        "prize_amount": 121572,
        "prize_amount_adjusted": 2900000,
        "prize_status": "received",
        "residences": [],
        "sort_order": "1"
      },
      "prize_categories": [
        "Physics"
      ],
      "prize_count": 1,
      "prize_years": [
        1921
      ],
      "prizes": [
        {
          "affiliations": [
            {
              "city": "Berlin",
              "country": "Germany",
              "location": "Berlin, Germany",
              "name": "Kaiser-Wilhelm-Institut f\u00fcr Physik",
              "name_now": "Kaiser-Wilhelm-Institut f\u00fcr Physik",
              "native_name": "Kaiser-Wilhelm-Institut f\u00fcr Physik"
            }
          ],
          "award_year": 1921,
          "category": "Physics",
          "category_code": "phy",
          "category_full_name": "The Nobel Prize in Physics",
          "date_awarded": "1922-11-09",
          "motivation": "for his services to Theoretical Physics, and especially for his discovery of the law of the photoelectric effect",
          "portion": "1",
          "prize_amount": 121572,
          "prize_amount_adjusted": 2900000,
          "prize_status": "received",
          "residences": [],
          "sort_order": "1"
        }
      ],
      "same_as": [
        "https://www.wikidata.org/wiki/Q937"
      ],
      "type": "person",
      "wikidata_url": "https://www.wikidata.org/wiki/Q937",
      "wikipedia_url": "https://en.wikipedia.org/wiki/Albert_Einstein"
    }
  ],
  "year": 1921
}
```

### Get the prizes of a year

Get every Nobel Prize awarded in one year, across all six categories, in a single step. Categories that were not awarded that year are still returned, flagged as not awarded with the Nobel Foundation's explanation.

**Inputs**

- Year (`year`, number, required): The award year, as YYYY. The first Nobel Prizes were awarded in 1901; the Economic Sciences prize starts in 1969. At least 1901.
- Language (`language`, text): Which language to return names, categories and motivations in. Defaults to English; a field the Nobel Foundation has not translated falls back to English. One of: `en` (English), `se` (Swedish), `no` (Norwegian).

**Outputs**

- `awarded_categories` (list)
- `awarded_count` (number)
- `laureate_count` (number)
- `prize_count` (number)
- `prizes` (list)
- `year` (number)

**Example output**

```json
{
  "awarded_categories": [
    "Physics"
  ],
  "awarded_count": 1,
  "laureate_count": 1,
  "prize_count": 1,
  "prizes": [
    {
      "award_year": 1921,
      "awarded": true,
      "category": "Physics",
      "category_code": "phy",
      "category_full_name": "The Nobel Prize in Physics",
      "date_awarded": "1922-11-09",
      "laureate_count": 1,
      "laureate_names": [
        "Albert Einstein"
      ],
      "laureates": [
        {
          "id": 26,
          "motivation": "for his services to Theoretical Physics, and especially for his discovery of the law of the photoelectric effect",
          "name": "Albert Einstein",
          "portion": "1",
          "sort_order": "1"
        }
      ],
      "prize_amount": 121572,
      "prize_amount_adjusted": 2900000,
      "top_motivation": null
    }
  ],
  "year": 1921
}
```

### Search laureates

Search Nobel Prize laureates, people and organizations alike, by name, gender, motivation text, affiliation, residence, birth or death date, and the year and category of the prize. Every filter is optional and they combine, so "women awarded the Physics prize" is one call.

**Inputs**

- Name (`name`, text): Text the laureate's name contains. Organizations match on their name too.
- Gender (`gender`, text): Narrow to laureates of one gender. Organizations have none, so setting this leaves them out. One of: `female`, `male`, `other`.
- Motivation contains (`motivation`, text): Text the Nobel committee's motivation contains, such as 'DNA' or 'human rights'.
- Affiliation (`affiliation`, text): The institution the laureate belonged to when the prize was awarded, such as a university.
- Residence (`residence`, text): Where the laureate was living when the prize was awarded.
- Born (`birth_date`, text): A year (1867), a month across all years (-11-), a day of the month (-07), or a full date (1867-11-07).
- Born before (`birth_date_to`, text): The end of a birth-date range. Only narrows a range, so Born is required alongside it.
- Died (`death_date`, text): Same forms as Born: a year, a month, a day of the month, or a full date.
- Died before (`death_date_to`, text): The end of a death-date range. Only narrows a range, so Died is required alongside it.
- Prize year (`prize_year`, number): Narrow to laureates awarded a prize in this year. With Prize end year set, this starts a range. At least 1901.
- Prize end year (`prize_year_to`, number): The last year of a prize-year range. Only narrows a range, so Prize year is required alongside it. At least 1901.
- Category (`category`, text): Narrow to laureates of one prize category. One of: `che` (Chemistry), `eco` (Economic Sciences), `lit` (Literature), `pea` (Peace), `phy` (Physics), `med` (Physiology or Medicine).
- Order (`sort`, text): Sort alphabetically by the laureate's known name, ascending or descending. One of: `asc` (Oldest first), `desc` (Newest first).
- Number of results (`limit`, number): How many laureates to return (1-100). Defaults to 25. From 1 to 100.
- Skip (`offset`, number): How many matching records to skip before collecting results. Use it with Number of results to page through a large search. At least 0.
- Language (`language`, text): Which language to return names, categories and motivations in. Defaults to English; a field the Nobel Foundation has not translated falls back to English. One of: `en` (English), `se` (Swedish), `no` (Norwegian).

**Outputs**

- `has_more` (true/false)
- `laureate_count` (number)
- `laureates` (list)
- `limit` (number)
- `offset` (number)
- `total_count` (number)

**Example output**

```json
{
  "has_more": false,
  "laureate_count": 1,
  "laureates": [
    {
      "acronym": null,
      "birth_date": "1879-03-14",
      "birth_place": {
        "city": "Ulm",
        "city_now": "Ulm",
        "continent": "Europe",
        "country": "Germany",
        "country_now": "Germany",
        "location": "Ulm, Germany"
      },
      "death_date": "1955-04-18",
      "death_place": {
        "city": "Princeton, NJ",
        "city_now": "Princeton, NJ",
        "continent": "North America",
        "country": "USA",
        "country_now": "USA",
        "location": "Princeton, NJ, USA"
      },
      "dissolution_date": null,
      "dissolution_place": {},
      "family_name": "Einstein",
      "founded_date": null,
      "founded_place": {},
      "full_name": "Albert Einstein",
      "gender": "male",
      "given_name": "Albert",
      "headquarters": {},
      "id": 26,
      "name": "Albert Einstein",
      "native_name": null,
      "penname": null,
      "prize_categories": [
        "Physics"
      ],
      "prize_count": 1,
      "prize_years": [
        1921
      ],
      "prizes": [
        {
          "affiliations": [
            {
              "city": "Berlin",
              "country": "Germany",
              "location": "Berlin, Germany",
              "name": "Kaiser-Wilhelm-Institut f\u00fcr Physik",
              "name_now": "Kaiser-Wilhelm-Institut f\u00fcr Physik",
              "native_name": "Kaiser-Wilhelm-Institut f\u00fcr Physik"
            }
          ],
          "award_year": 1921,
          "category": "Physics",
          "category_code": "phy",
          "category_full_name": "The Nobel Prize in Physics",
          "date_awarded": "1922-11-09",
          "motivation": "for his services to Theoretical Physics, and especially for his discovery of the law of the photoelectric effect",
          "portion": "1",
          "prize_amount": 121572,
          "prize_amount_adjusted": 2900000,
          "prize_status": "received",
          "residences": [],
          "sort_order": "1"
        }
      ],
      "same_as": [
        "https://www.wikidata.org/wiki/Q937"
      ],
      "type": "person",
      "wikidata_url": "https://www.wikidata.org/wiki/Q937",
      "wikipedia_url": "https://en.wikipedia.org/wiki/Albert_Einstein"
    }
  ],
  "limit": 25,
  "offset": 0,
  "total_count": 1
}
```

### Search Nobel Prizes

Search the Nobel Prizes awarded since 1901 by year, year range and category. Every filter is optional, so with none set this pages through the whole history. Each prize comes back with its laureates' names, shares and motivations.

**Inputs**

- Year (`year`, number): The year the prize was awarded, as YYYY. With End year set, this is the start of a range. At least 1901.
- End year (`year_to`, number): The last year of a range, as YYYY. Only narrows a range, so Year is required alongside it. At least 1901.
- Category (`category`, text): Narrow to one of the six prize categories. Leave blank for all of them. One of: `che` (Chemistry), `eco` (Economic Sciences), `lit` (Literature), `pea` (Peace), `phy` (Physics), `med` (Physiology or Medicine).
- Order (`sort`, text): Sort by award year, oldest or newest first. One of: `asc` (Oldest first), `desc` (Newest first).
- Number of results (`limit`, number): How many prizes to return (1-100). Defaults to 25. From 1 to 100.
- Skip (`offset`, number): How many matching records to skip before collecting results. Use it with Number of results to page through a large search. At least 0.
- Language (`language`, text): Which language to return names, categories and motivations in. Defaults to English; a field the Nobel Foundation has not translated falls back to English. One of: `en` (English), `se` (Swedish), `no` (Norwegian).

**Outputs**

- `has_more` (true/false)
- `limit` (number)
- `offset` (number)
- `prize_count` (number)
- `prizes` (list)
- `total_count` (number)

**Example output**

```json
{
  "has_more": false,
  "limit": 25,
  "offset": 0,
  "prize_count": 1,
  "prizes": [
    {
      "award_year": 1921,
      "awarded": true,
      "category": "Physics",
      "category_code": "phy",
      "category_full_name": "The Nobel Prize in Physics",
      "date_awarded": "1922-11-09",
      "laureate_count": 1,
      "laureate_names": [
        "Albert Einstein"
      ],
      "laureates": [
        {
          "id": 26,
          "motivation": "for his services to Theoretical Physics, and especially for his discovery of the law of the photoelectric effect",
          "name": "Albert Einstein",
          "portion": "1",
          "sort_order": "1"
        }
      ],
      "prize_amount": 121572,
      "prize_amount_adjusted": 2900000,
      "top_motivation": null
    }
  ],
  "total_count": 1
}
```