{"openapi":"3.1.0","info":{"title":"Wikidata API","version":"1.0.0","description":"The Wikidata structured knowledge graph as an API — the free, collaborative, multilingual knowledgebase that underpins Wikipedia and thousands of apps, powered by the official Wikidata action API. Search the knowledge graph by text to find entities and their Q-ids; read an entity for its label, description, aliases, a summary of its statements (each property with sample values), sitelink count and Wikipedia link; fetch the full claims for a property of an entity (values, ranks, qualifiers); resolve up to 50 Q/P ids to human-readable labels and descriptions in a single call; and look up any property's label, description and datatype. Covers tens of millions of items — people, places, organisations, works, species, events and concepts — in any language. Ideal for knowledge-graph and fact-lookup tools, entity linking and disambiguation, data enrichment, semantic search and research apps. Data is CC0.","contact":{"name":"PremiumApi","url":"https://www.oanor.com/by/premiumapi"}},"servers":[{"url":"https://api.oanor.com/wikidata-api","description":"oanor gateway"}],"tags":[{"name":"Entities"},{"name":"Statements"},{"name":"Reference"},{"name":"Meta"}],"components":{"securitySchemes":{"oanorKey":{"type":"apiKey","in":"header","name":"x-oanor-key","description":"Get your key at https://www.oanor.com/developer/keys"}}},"security":[{"oanorKey":[]}],"paths":{"/v1/entity":{"get":{"operationId":"get_v1_entity","tags":["Entities"],"summary":"An entity with a statement summary","description":"","parameters":[{"name":"id","in":"query","required":true,"description":"Q-id, e.g. Q42","schema":{"type":"string"},"example":"Q42"},{"name":"language","in":"query","required":false,"description":"Language code (default en)","schema":{"type":"string"},"example":"en"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"entity":{"id":"Q42","type":"item","label":"Douglas Adams","aliases":[],"wikipedia":"https://en.wikipedia.org/wiki/Douglas_Adams","statements":[{"count":1,"values":[{"type":"entity","value":"Q5"}],"property":"P31"},{"count":1,"values":[{"type":"entity","value":"Q6581097"}],"property":"P21"},{"count":8,"values":[{"type":"entity","value":"Q214917"},{"type":"entity","value":"Q28389"},{"type":"entity","value":"Q6625963"},{"type":"entity","value":"Q4853732"},{"type":"entity","value":"Q18844224"}],"property":"P106"},{"count":3,"values":[{"type":"entity","value":"Q25169"},{"type":"entity","value":"Q20736364"},{"type":"entity","value":"Q7758404"}],"property":"P800"},{"count":1,"values":[{"type":"time","value":"1952-03-11T00:00:00Z"}],"property":"P569"},{"count":1,"values":[{"type":"entity","value":"Q350"}],"property":"P19"},{"count":1,"values":[{"type":"time","value":"2001-05-11T00:00:00Z"}],"property":"P570"},{"count":1,"values":[{"type":"entity","value":"Q3739104"}],"property":"P1196"},{"count":1,"values":[{"type":"entity","value":"Q12152"}],"property":"P509"},{"count":1,"values":[{"type":"entity","value":"Q159288"}],"property":"P20"},{"count":1,"values":[{"type":"entity","value":"Q533697"}],"property":"P119"},{"count":1,"values":[{"type":"string","value":"Douglas Adams' gravestone.jpg"}],"property":"P1442"},{"count":1,"values":[{"type":"string","value":"90196888"}],"property":"P1015"},{"count":2,"values":[{"type":"entity","value":"Q463035"},{"type":"entity","value":"Q19688263"}],"property":"P735"},{"count":1,"values":[{"type":"entity","value":"Q351735"}],"property":"P734"},{"count":1,"values":[{"type":"entity","value":"Q145"}],"property":"P27"},{"count":1,"values":[{"type":"entity","value":"Q1860"}],"property":"P103"},{"count":1,"values":[{"type":"string","value":"000057405"}],"property":"P1368"},{"count":1,"values":[{"type":"string","value":"n80076765"}],"property":"P244"},{"count":1,"values":[{"type":"string","value":"000002833"}],"property":"P947"},{"count":1,"values":[{"type":"string","value":"113230702"}],"property":"P214"},{"count":1,"values":[{"type":"string","value":"nm0010930"}],"property":"P345"},{"count":1,"values":[{"type":"string","value":"Douglas Adams"}],"property":"P373"},{"count":1,"values":[{"type":"string","value":"00430962"}],"property":"P349"},{"count":1,"values":[{"type":"string","value":"e9ed318d-8cc5-4cf8-ab77-505e39ab6ea4"}],"property":"P434"},{"count":1,"values":[{"type":"string","value":"11888092r"}],"property":"P268"},{"count":1,"values":[{"type":"string","value":"119033364"}],"property":"P227"},{"count":1,"values":[{"type":"string","value":"22814"}],"property":"P535"},{"count":1,"values":[{"type":"entity","value":"Q14623675"}],"property":"P22"},{"count":1,"values":[{"type":"entity","value":"Q14623678"}],"property":"P25"},{"count":1,"values":[{"type":"entity","value":"Q14623683"}],"property":"P40"},{"count":1,"values":[{"type":"string","value":"230807"}],"property":"P906"},{"count":2,"values":[{"type":"string","value":"068744307"},{"type":"string","value":"339433876"}],"property":"P1006"},{"count":1,"values":[{"type":"string","value":"000163846"}],"property":"P949"},{"count":1,"values":[{"type":"string","value":"/m/0282x"}],"property":"P646"},{"count":2,"values":[{"type":"entity","value":"Q9531"},{"type":"entity","value":"Q3520623"}],"property":"P108"},{"count":6,"values":[{"type":"string","value":"Arts/Literature/Authors/A/Adams,_Douglas/"},{"type":"string","value":"World/Dansk/Kultur/Litteratur/Forfattere/A/Adams,_Douglas/"},{"type":"string","value":"World/Français/Arts/Littérature/Genres/Science-fiction_et_fantastique/Auteurs/Adams,_Douglas/"},{"type":"string","value":"World/Deutsch/Kultur/Literatur/Autoren_und_Autorinnen/A/Adams,_Douglas/"},{"type":"string","value":"World/Italiano/Arte/Letteratura/Autori/A/Adams,_Douglas/"}],"property":"P998"},{"count":1,"values":[{"type":"string","value":"122"}],"property":"P1233"},{"count":1,"values":[{"type":"string","value":"00000020676"}],"property":"P1284"},{"count":1,"values":[{"type":"string","value":"douglas-adams"}],"property":"P866"},{"count":1,"values":[{"type":"string","value":"a0000001157306"}],"property":"P1695"},{"count":1,"values":[{"type":"string","value":"mp60152"}],"property":"P1816"},{"count":1,"values":[{"type":"string","value":"731/000023662"}],"property":"P1263"},{"count":1,"values":[{"type":"string","value":"DA07517784"}],"property":"P271"},{"count":1,"values":[{"type":"string","value":"https://douglasadams.com"}],"property":"P856"},{"count":2,"values":[{"type":"entity","value":"Q3414212"},{"type":"entity","value":"Q2576795"}],"property":"P1411"},{"count":1,"values":[{"type":"string","value":"134923"}],"property":"P1953"},{"count":1,"values":[{"type":"string","value":"OL272947A"}],"property":"P648"},{"count":1,"values":[{"type":"string","value":"celebrity/douglas_adams"}],"property":"P1258"},{"count":1,"values":[{"type":"string","value":"10014"}],"property":"P2191"},{"count":1,"values":[{"type":"string","value":"97049"}],"property":"P1266"},{"count":1,"values":[{"type":"string","value":"p279442"}],"property":"P2019"},{"count":1,"values":[{"type":"string","value":"45993"}],"property":"P2188"},{"count":1,"values":[{"type":"string","value":"271209"}],"property":"P2168"},{"count":1,"values":[{"type":"string","value":"847711"}],"property":"P1315"},{"count":2,"values":[{"type":"string","value":"56544"},{"type":"string","value":"1775523"}],"property":"P2163"},{"count":1,"values":[{"type":"string","value":"biography/Douglas-Adams"}],"property":"P1417"},{"count":1,"values":[{"type":"string","value":"douglas_adams"}],"property":"P2611"},{"count":1,"values":[{"type":"string","value":"208947"}],"property":"P2435"},{"count":1,"values":[{"type":"string","value":"246164"}],"property":"P2604"}],"description":"British science fiction writer and humorist (1952–2001)","sitelink_count":132,"statement_property_count":301}},"meta":{"timestamp":"2026-06-01T08:14:04.892Z","request_id":"c709f95e-c12d-4ce8-b2ae-b7556f2c0978"},"status":"ok","message":"Entity retrieved","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/search":{"get":{"operationId":"get_v1_search","tags":["Entities"],"summary":"Search the knowledge graph","description":"","parameters":[{"name":"query","in":"query","required":true,"description":"Search text, e.g. Douglas Adams","schema":{"type":"string"},"example":"Douglas Adams"},{"name":"type","in":"query","required":false,"description":"item|property|lexeme","schema":{"type":"string"},"example":"item"},{"name":"language","in":"query","required":false,"description":"Language code (default en)","schema":{"type":"string"},"example":"en"},{"name":"limit","in":"query","required":false,"description":"Max results (1-50)","schema":{"type":"string"}}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"count":10,"query":"Douglas Adams","results":[{"id":"Q42","url":"http://www.wikidata.org/entity/Q42","label":"Douglas Adams","aliases":[],"description":"British science fiction writer and humorist (1952–2001)"},{"id":"Q28421831","url":"http://www.wikidata.org/entity/Q28421831","label":"Douglas Adams","aliases":[],"description":"American environmental engineer"},{"id":"Q117249850","url":"http://www.wikidata.org/entity/Q117249850","label":"Douglas Adams","aliases":[],"description":"Global Co-Head of Equity Capital Markets, Citi"},{"id":"Q61853920","url":"http://www.wikidata.org/entity/Q61853920","label":"Douglas H Adams","aliases":["Douglas Adams"],"description":"researcher ORCID ID = 0000-0002-3539-6629"},{"id":"Q75630160","url":"http://www.wikidata.org/entity/Q75630160","label":"Douglas Jerrold Adams","aliases":["Douglas Adams"],"description":"(1868-1961)"},{"id":"Q932869","url":"http://www.wikidata.org/entity/Q932869","label":"Douglas Q. Adams","aliases":["Douglas Adams"],"description":"American professor of English"},{"id":"Q21454969","url":"http://www.wikidata.org/entity/Q21454969","label":"Douglas Adams","aliases":[],"description":"British painter (1853–1920)"},{"id":"Q10268476","url":"http://www.wikidata.org/entity/Q10268476","label":"Douglas Howe Adams","aliases":["Douglas Adams"],"description":"American cricket player (1876-1931)"},{"id":"Q75824389","url":"http://www.wikidata.org/entity/Q75824389","label":"Douglas Adams","aliases":[],"description":"Peerage person ID=348982"},{"id":"Q90608601","url":"http://www.wikidata.org/entity/Q90608601","label":"Douglas J Adams","aliases":["Douglas Adams"],"description":"researcher (ORCID 0000-0002-6090-0516)"}],"language":"en"},"meta":{"timestamp":"2026-06-01T08:14:05.172Z","request_id":"e5588fe8-ef62-430c-a086-3ae4ff8dc646"},"status":"ok","message":"Search results retrieved","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/claims":{"get":{"operationId":"get_v1_claims","tags":["Statements"],"summary":"Claims for a property of an entity","description":"","parameters":[{"name":"id","in":"query","required":true,"description":"Q-id, e.g. Q42","schema":{"type":"string"},"example":"Q42"},{"name":"property","in":"query","required":false,"description":"P-id, e.g. P69 (omit for all)","schema":{"type":"string"},"example":"P69"},{"name":"limit","in":"query","required":false,"description":"Max properties","schema":{"type":"string"}}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"claims":[{"count":2,"property":"P69","statements":[{"rank":"normal","value":{"type":"entity","value":"Q4961791"},"qualifiers":["P582","P580"]},{"rank":"normal","value":{"type":"entity","value":"Q691283"},"qualifiers":["P812","P512","P580","P582"]}]}],"entity":"Q42","property":"P69","property_count":1,"total_statements":2},"meta":{"timestamp":"2026-06-01T08:14:05.438Z","request_id":"8ef198c4-9dff-4ec8-819a-7ad6d84783e3"},"status":"ok","message":"Claims retrieved","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/labels":{"get":{"operationId":"get_v1_labels","tags":["Statements"],"summary":"Resolve Q/P ids to labels (batch)","description":"","parameters":[{"name":"ids","in":"query","required":true,"description":"Comma-separated ids, e.g. Q42,Q64,P31","schema":{"type":"string"},"example":"Q42,Q64,P31"},{"name":"language","in":"query","required":false,"description":"Language code (default en)","schema":{"type":"string"},"example":"en"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"count":3,"labels":{"P31":{"label":"instance of","description":"type to which this subject corresponds/belongs. Different from P279 (subclass of); for example: K2 is an instance of mountain; volcano is a subclass of mountain"},"Q42":{"label":"Douglas Adams","description":"British science fiction writer and humorist (1952–2001)"},"Q64":{"label":"Berlin","description":"federated state, capital and largest city of Germany"}},"language":"en"},"meta":{"timestamp":"2026-06-01T08:14:05.713Z","request_id":"1b310788-7586-45d9-ab21-9aabba8e1c3f"},"status":"ok","message":"Labels retrieved","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/property":{"get":{"operationId":"get_v1_property","tags":["Reference"],"summary":"A property's metadata","description":"","parameters":[{"name":"id","in":"query","required":true,"description":"P-id, e.g. P69","schema":{"type":"string"},"example":"P69"},{"name":"language","in":"query","required":false,"description":"Language code (default en)","schema":{"type":"string"},"example":"en"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"property":{"id":"P69","label":"educated at","aliases":["alma mater","education","alumni of","alumna of","college attended","school attended","studied at","graduate of","graduated from","faculty","place of education","alumnus of","attended","went to school at","schooled at","attended school at","schooling place","education place","student of","student at"],"datatype":"wikibase-item","description":"educational institution attended by subject"}},"meta":{"timestamp":"2026-06-01T08:14:05.943Z","request_id":"38ebe279-912c-4b27-a597-b34c9f17c834"},"status":"ok","message":"Property retrieved","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/meta":{"get":{"operationId":"get_v1_meta","tags":["Meta"],"summary":"Usage notes","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"note":"The Wikidata structured knowledge graph. /v1/search?query=Douglas Adams (type=item|property, language=en) = search entities, returning their Q/P ids, labels & descriptions; /v1/entity?id=Q42 = an entity with its label, description, aliases, a summary of its statements (property + value samples), sitelink count and Wikipedia link; /v1/claims?id=Q42&property=P69 = the statements for a property of an entity (value, rank, qualifiers; omit property for all); /v1/labels?ids=Q42,Q64,P31 = resolve up to 50 Q/P ids to human-readable labels & descriptions in one call; /v1/property?id=P69 = a property's label, description and datatype. Items are Q-ids, properties are P-ids. Statement values reference other entities by id — resolve them with /v1/labels. Data from Wikidata, CC0. For article text use the Wikipedia API.","source":"Wikidata action API (wikidata.org/w/api.php)","endpoints":["/v1/search","/v1/entity","/v1/claims","/v1/labels","/v1/property","/v1/meta"]},"meta":{"timestamp":"2026-06-01T08:14:05.992Z","request_id":"8114ebf3-26b1-455d-972e-2675ddda170e"},"status":"ok","message":"Meta retrieved","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}}},"x-oanor-pricing":[{"slug":"free","name":"Free","price_cents_month":0,"monthly_call_quota":1000,"rps_limit":2,"hard_limit":true},{"slug":"starter","name":"Starter","price_cents_month":650,"monthly_call_quota":35000,"rps_limit":8,"hard_limit":true},{"slug":"pro","name":"Pro","price_cents_month":1950,"monthly_call_quota":150000,"rps_limit":20,"hard_limit":true},{"slug":"mega","name":"Mega","price_cents_month":5400,"monthly_call_quota":600000,"rps_limit":50,"hard_limit":true}],"x-oanor-marketplace-url":"https://www.oanor.com/api/wikidata-api"}