{ "openapi": "3.1.0", "info": { "title": "Notable People API", "version": "1.0.0", "description": "1.93 million notable people from Wikidata with birth and death dates, occupations and a notability rank.\n\nEvery notable person in history, structured and queryable: 1.93 million humans with an English Wikipedia article and a known birth date, from Wikidata (CC0). Each person carries name, one-line description, birth and death dates that honor the source's precision (a year-only date never fabricates a January 1st birthday), gender, citizenship, up to three occupations resolved to plain English, a Wikipedia link and a notability rank that puts Einstein above obscurity in every listing. Search by name the way people actually type it — token-prefix full-text, so \"Einstein\" or \"serena wil\" just work — and filter by occupation, citizenship, birth-year range or living/deceased. The born-on and died-on endpoints power \"on this day\" features with day-precision dates only (Mario Draghi on September 3rd, Elvis on August 16th); random serves quiz and trivia apps. Deaths refresh daily from Wikidata, keeping the fact users check most — is this person still alive? — current. Built for media, quiz and trivia products, genealogy, content enrichment and research. CC0 source data; self-hosted — no third-party calls at request time.", "contact": { "name": "Data and APIs", "url": "https://dataandapis.com/contact" }, "termsOfService": "https://dataandapis.com/terms-of-service", "license": { "name": "Data and APIs Terms of Service", "url": "https://dataandapis.com/terms-of-service" }, "x-logo": { "url": "https://dataandapis.com/images/notable-people.webp" } }, "externalDocs": { "description": "Documentation, live tester and pricing", "url": "https://dataandapis.com/apis/notable-people" }, "servers": [ { "url": "https://api-notable-people.dataandapis.com" } ], "tags": [ { "name": "Entertainment", "description": "Notable People API belongs to the Entertainment category of the Data and APIs catalog." } ], "paths": { "/v1/people/born-on": { "get": { "operationId": "bornOnDate", "summary": "Born On Date", "description": "Born On Date endpoint of the Notable People API. Costs 1 token per call.", "externalDocs": { "url": "https://dataandapis.com/apis/notable-people/born-on-date" }, "parameters": [ { "name": "day", "in": "query", "required": false, "schema": { "type": "string" }, "example": "14" }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "string" }, "example": "20" }, { "name": "month", "in": "query", "required": false, "schema": { "type": "string" }, "example": "3" } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object" }, "example": { "ok": true, "month": 3, "day": 14, "count": 3, "results": [ { "qid": "Q937", "name": "Albert Einstein", "description": "German-born theoretical physicist (1879–1955)", "born": "1879-03-14", "died": "1955-04-18", "alive": false, "gender": "male", "citizenship": "Cisleithania", "occupations": [ "theoretical physicist", "philosopher of science", "pacifist" ], "wikipedia": "https://en.wikipedia.org/wiki/Albert_Einstein", "notability_rank": 321 }, { "qid": "Q123351", "name": "Michael Caine", "description": "English actor (born 1933)", "born": "1933-03-14", "died": null, "alive": true, "gender": "male", "citizenship": "United Kingdom", "occupations": [ "film actor" ], "wikipedia": "https://en.wikipedia.org/wiki/Michael_Caine", "notability_rank": 109 }, { "qid": "Q9557", "name": "Aamir Khan", "description": "Indian actor", "born": "1965-03-14", "died": null, "alive": true, "gender": "male", "citizenship": "India", "occupations": [ "producer", "film actor", "film producer" ], "wikipedia": "https://en.wikipedia.org/wiki/Aamir_Khan", "notability_rank": 103 } ] } } } }, "401": { "description": "Missing or invalid API key" }, "402": { "description": "Subscription past due; the response carries a payment_url" }, "429": { "description": "Monthly token allowance exhausted" } }, "security": [ { "ApiKey": [] } ] } }, "/v1/sources": { "get": { "operationId": "dataSources", "summary": "Data Sources", "description": "Data Sources endpoint of the Notable People API. Costs 1 token per call.", "externalDocs": { "url": "https://dataandapis.com/apis/notable-people/data-sources" }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object" }, "example": { "ok": true, "attribution": "Data from Wikidata (CC0)", "count": 1, "sources": [ { "slug": "wikidata-people", "name": "Wikidata: humans with an English Wikipedia article and known birth date", "publisher": "Wikidata contributors", "licence": "CC0 1.0", "source_url": "https://www.wikidata.org/", "cadence": "daily deaths refresh + periodic re-seed", "record_count": 1928892, "retrieved_at": "2026-09-04" } ] } } } }, "401": { "description": "Missing or invalid API key" }, "402": { "description": "Subscription past due; the response carries a payment_url" }, "429": { "description": "Monthly token allowance exhausted" } }, "security": [ { "ApiKey": [] } ] } }, "/v1/people/died-on": { "get": { "operationId": "diedOnDate", "summary": "Died On Date", "description": "Died On Date endpoint of the Notable People API. Costs 1 token per call.", "externalDocs": { "url": "https://dataandapis.com/apis/notable-people/died-on-date" }, "parameters": [ { "name": "day", "in": "query", "required": false, "schema": { "type": "string" }, "example": "16" }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "string" }, "example": "20" }, { "name": "month", "in": "query", "required": false, "schema": { "type": "string" }, "example": "8" } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object" }, "example": { "ok": true, "month": 8, "day": 16, "count": 3, "results": [ { "qid": "Q303", "name": "Elvis Presley", "description": "American singer and actor (1935–1977)", "born": "1935-01-08", "died": "1977-08-16", "alive": false, "gender": "male", "citizenship": "United States", "occupations": [ "singer" ], "wikipedia": "https://en.wikipedia.org/wiki/Elvis_Presley", "notability_rank": 215 }, { "qid": "Q7728", "name": "Grazia Deledda", "description": "Italian novelist (1871-1936)", "born": "1871-09-27", "died": "1936-08-16", "alive": false, "gender": "female", "citizenship": "Kingdom of Italy", "occupations": [ "short story writer", "prose writer", "novelist" ], "wikipedia": "https://en.wikipedia.org/wiki/Grazia_Deledda", "notability_rank": 120 }, { "qid": "Q125121", "name": "Aretha Franklin", "description": "American singer, songwriter, and pianist (1942–2018)", "born": "1942-03-25", "died": "2018-08-16", "alive": false, "gender": "female", "citizenship": "United States", "occupations": [ "soul musician", "activist", "songwriter" ], "wikipedia": "https://en.wikipedia.org/wiki/Aretha_Franklin", "notability_rank": 116 } ] } } } }, "401": { "description": "Missing or invalid API key" }, "402": { "description": "Subscription past due; the response carries a payment_url" }, "429": { "description": "Monthly token allowance exhausted" } }, "security": [ { "ApiKey": [] } ] } }, "/v1/people/{qid}": { "get": { "operationId": "getPersonByQid", "summary": "Get Person By QID", "description": "Get Person By QID endpoint of the Notable People API. Costs 1 token per call.", "externalDocs": { "url": "https://dataandapis.com/apis/notable-people/get-person-by-qid" }, "parameters": [ { "name": "qid", "in": "path", "required": true, "schema": { "type": "string" }, "example": "Q937" } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object" }, "example": { "ok": true, "person": { "qid": "Q937", "name": "Albert Einstein", "description": "German-born theoretical physicist (1879–1955)", "born": "1879-03-14", "died": "1955-04-18", "alive": false, "gender": "male", "citizenship": "Cisleithania", "occupations": [ "theoretical physicist", "philosopher of science", "pacifist" ], "wikipedia": "https://en.wikipedia.org/wiki/Albert_Einstein", "notability_rank": 321 } } } } }, "401": { "description": "Missing or invalid API key" }, "402": { "description": "Subscription past due; the response carries a payment_url" }, "429": { "description": "Monthly token allowance exhausted" } }, "security": [ { "ApiKey": [] } ] } }, "/v1/people/random": { "get": { "operationId": "randomPeople", "summary": "Random People", "description": "Random People endpoint of the Notable People API. Costs 1 token per call.", "externalDocs": { "url": "https://dataandapis.com/apis/notable-people/random-people" }, "parameters": [ { "name": "amount", "in": "query", "required": false, "schema": { "type": "string" }, "example": "3" } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object" }, "example": { "ok": true, "count": 3, "results": [ { "qid": "Q377454", "name": "Ivan Skobrev", "description": "Russian speed skater", "born": "1983-02-08", "died": null, "alive": true, "gender": "male", "citizenship": "Russia", "occupations": [ "speed skater" ], "wikipedia": "https://en.wikipedia.org/wiki/Ivan_Skobrev", "notability_rank": 23 }, { "qid": "Q352001", "name": "Sebastián Viera", "description": "Uruguayan footballer", "born": "1983-07-03", "died": null, "alive": true, "gender": "male", "citizenship": "Uruguay", "occupations": [ "association football player", "association football coach" ], "wikipedia": "https://en.wikipedia.org/wiki/Sebasti%C3%A1n_Viera", "notability_rank": 23 }, { "qid": "Q368396", "name": "Jean-Jacques Gosso", "description": "Ivorian footballer", "born": "1983-03-15", "died": null, "alive": true, "gender": "male", "citizenship": null, "occupations": [ "association football player" ], "wikipedia": "https://en.wikipedia.org/wiki/Jean-Jacques_Gosso", "notability_rank": 23 } ] } } } }, "401": { "description": "Missing or invalid API key" }, "402": { "description": "Subscription past due; the response carries a payment_url" }, "429": { "description": "Monthly token allowance exhausted" } }, "security": [ { "ApiKey": [] } ] } }, "/v1/people": { "get": { "operationId": "searchPeople", "summary": "Search People", "description": "Search People endpoint of the Notable People API. Costs 1 token per call.", "externalDocs": { "url": "https://dataandapis.com/apis/notable-people/search-people" }, "parameters": [ { "name": "alive", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "born_after", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "born_before", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "citizenship", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "string" }, "example": "20" }, { "name": "occupation", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "page", "in": "query", "required": false, "schema": { "type": "string" }, "example": "1" }, { "name": "q", "in": "query", "required": false, "schema": { "type": "string" }, "example": "Einstein" } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object" }, "example": { "ok": true, "total": 32, "page": 1, "limit": 20, "count": 3, "results": [ { "qid": "Q937", "name": "Albert Einstein", "description": "German-born theoretical physicist (1879–1955)", "born": "1879-03-14", "died": "1955-04-18", "alive": false, "gender": "male", "citizenship": "Cisleithania", "occupations": [ "theoretical physicist", "philosopher of science", "pacifist" ], "wikipedia": "https://en.wikipedia.org/wiki/Albert_Einstein", "notability_rank": 321 }, { "qid": "Q2051128", "name": "Bob Einstein", "description": "American comedian, actor (1942–2019)", "born": "1942-11-20", "died": "2019-01-02", "alive": false, "gender": "male", "citizenship": "United States", "occupations": [ "film actor", "television actor", "film director" ], "wikipedia": "https://en.wikipedia.org/wiki/Bob_Einstein", "notability_rank": 49 }, { "qid": "Q68761", "name": "Elsa Einstein", "description": "second wife and cousin of Albert Einstein (1876-1936)", "born": "1876-01-18", "died": "1936-12-20", "alive": false, "gender": "female", "citizenship": "Germany", "occupations": [ "politician" ], "wikipedia": "https://en.wikipedia.org/wiki/Elsa_Einstein", "notability_rank": 30 } ] } } } }, "401": { "description": "Missing or invalid API key" }, "402": { "description": "Subscription past due; the response carries a payment_url" }, "429": { "description": "Monthly token allowance exhausted" } }, "security": [ { "ApiKey": [] } ] } } }, "components": { "securitySchemes": { "ApiKey": { "type": "apiKey", "in": "header", "name": "X-Api-Key", "description": "Create a free key at https://dataandapis.com/sign-up. 500 tokens a month on the Free plan; this API costs 1 token per call." } } }, "security": [ { "ApiKey": [] } ] }