{ "openapi": "3.0.1", "info": { "title": "Nobel Prize Laureates and Prizes by Year, Category, Country", "description": "Nobel laureates and prizes from the official keyless Nobel Prize API as rows: award year, category, laureate, motivation, prize share, amount, affiliation, birth and death place, age at award, Wikipedia link. Filter by year, category, birth country, gender, name. For newsrooms, teachers and agents.", "version": "0.1", "x-build-id": "M9jejGUFkUqSQCNE7" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/yadroo~nobel-prize-laureates/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-yadroo-nobel-prize-laureates", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/yadroo~nobel-prize-laureates/runs": { "post": { "operationId": "runs-sync-yadroo-nobel-prize-laureates", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/yadroo~nobel-prize-laureates/run-sync": { "post": { "operationId": "run-sync-yadroo-nobel-prize-laureates", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "properties": { "mode": { "title": "What one row stands for", "enum": [ "laureates", "prizes" ], "type": "string", "description": "`laureates` = one row per laureate and award, with the biographical columns: a laureate who won twice gives two rows, each with its own year, category, motivation, share and affiliation. `prizes` = one row per year and category, with the laureate names and ids joined into lists, the prize amount and the shared motivation - the compact shape for tables, charts and year-by-year reports. `birthCountries`, `gender` and `laureateType` narrow `laureates` mode only.", "default": "laureates" }, "categories": { "title": "Prize categories", "type": "array", "description": "The six categories of the prize; several values are combined with OR, empty means every category. Each row carries the value you see here in its `category` column, so a filter and a column always use the same words. The platform refuses any value outside the six before the run starts, so write them exactly as listed - `Physiology or Medicine` is the official name of what is usually called the medicine prize, and `Economic Sciences` exists only from 1969 on.", "items": { "type": "string", "enum": [ "Chemistry", "Economic Sciences", "Literature", "Peace", "Physics", "Physiology or Medicine" ], "enumTitles": [ "Chemistry", "Economic Sciences - the Sveriges Riksbank prize, awarded since 1969", "Literature", "Peace", "Physics", "Physiology or Medicine" ] } }, "yearFrom": { "title": "First award year", "minimum": 1901, "maximum": 2100, "type": "integer", "description": "Earliest award year to include, counted inclusively. The first prizes were awarded in 1901, so 1901 means \"from the beginning\". Leave empty for no lower bound. A year range is the cheapest filter there is: it is sent to the source, so the run pays for the years you asked for and nothing else." }, "yearTo": { "title": "Last award year", "minimum": 1901, "maximum": 2100, "type": "integer", "description": "Latest award year to include, counted inclusively. Leave empty for no upper bound, or set both years to the same number for a single year. Note that the current year only has rows once the award has been announced - the announcements run over the first half of October, one category at a time, and a category not yet announced simply has no row yet." }, "birthCountries": { "title": "Country the laureate was born in", "maxItems": 10, "type": "array", "description": "Country names as the source writes them: `USA`, `Germany`, `United Kingdom`. Case, spaces and common spellings are accepted (`United States`, `us`, `UK`, `Deutschland`); an unknown value is refused with the closest names. The source records the country of the time, so the filter matches `birthCountry` (`Prussia`, `Austria-Hungary`) or `birthCountryNow`, and `requestedBirthCountry` says which. Organizations drop out of such a run. Ignored in `prizes` mode. Full list: README - Birth countries.", "items": { "type": "string" } }, "gender": { "title": "Gender of the laureate", "enum": [ "female", "male" ], "type": "string", "description": "The gender the source records for a person. Leave empty for all laureates. Organizations carry no gender and drop out of a run that sets this filter. Ignored in `prizes` mode." }, "laureateType": { "title": "People, organizations or both", "enum": [ "all", "person", "organization" ], "type": "string", "description": "About thirty peace prizes went to institutions rather than people. They have a name, a founding year and a place, but no birth date, no gender and no affiliation, so a report that mixes them with people has empty biographical columns. Pick one kind to keep the dataset clean; every row says which it is in `laureateType`. Applied to the rows by this actor, which the source cannot do itself. Ignored in `prizes` mode.", "default": "all" }, "nameContains": { "title": "Name contains", "type": "string", "description": "Keep only laureates whose name contains this text, matched case- and accent-insensitively against the known name, the full name and an organization's name: `curie`, `einstein`, `red cross`. Applied by this actor to the rows it fetched, not by the source, so pair it with a year range or a category - otherwise it walks the whole list of laureates, which is slower and costs more. A text that matches nothing returns no rows and the status message says so." }, "sort": { "title": "Order of the results", "enum": [ "yearDesc", "yearAsc" ], "type": "string", "description": "Which rows you get first when `maxItems` cuts the answer. Newest first is the default, because the recent prizes are the ones people look up and it makes a repeat run during prize week predictable.", "default": "yearDesc" }, "onlyNew": { "title": "Skip rows seen in earlier runs", "type": "boolean", "description": "Remember the award rows this run writes in the actor's key-value store and, on the next run of the same actor or task, write only rows that were not written before. Made for watching the announcements: a task with `yearFrom` and `yearTo` set to the current year, scheduled through the first half of October, then holds exactly the laureates announced since the last run. The memory is kept per actor or task, so two tasks watching two categories do not interfere.", "default": false }, "maxItems": { "title": "Maximum rows", "minimum": 1, "maximum": 1000, "type": "integer", "description": "Hard cap on the rows this run writes, and therefore on what it costs. Paging stops as soon as the cap is reached. For scale: the whole history is roughly a thousand laureates and about six hundred and fifty prizes, so 1000 rows covers everything the source has in `prizes` mode and almost all of it in `laureates` mode.", "default": 50 }, "fields": { "title": "Only these columns", "type": "array", "description": "Keep only the named columns, in the order given - for example `name, awardYear, category, motivation`. Empty = every column. `awardYear`, `category`, `url`, `fetchedAt` and `sourceMode` are always present; name one of them here and it moves to the position you gave it. Unknown names are reported in the status message instead of being dropped in silence.", "items": { "type": "string" } } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 }, "PROXY_UNBLOCKER_UNITS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 }, "PROXY_UNBLOCKER_UNITS": { "type": "integer", "example": 0 } } } } } } } } } }