# Wikidata API: List items by criteria > Lists Wikidata items of a named kind, optionally in a country or directly assigned to a region or city, or with an award, sorted by Wikipedia language editions, date or name. Unofficial. Not affiliated with or endorsed by Wikidata. - Page: https://fous.com/methods/wikidata.org/list-items-by-criteria - Method: `wikidata.org/list_items_by_criteria`, version 1 - Website: wikidata.org - Returns: name, short description, country, start date, English Wikipedia link, Wikidata link, item id - Effect: read (it gets data and changes nothing) - Sign-in: none needed - Cost: 1 credit per completed run (1ยข with pay as you go); failed runs are free - Verified: Nov 2, 2026 ## Inputs | Field | Type | Required | In the run below | Description | |---|---|---|---|---| | `kind` | string | yes | `"person"` | Kind of item, for example university or person. | | `sort` | string | no | | Result order; most_notable ranks by number of Wikipedia language editions, for example newest. One of "most_notable", "newest", "oldest", "alphabetical". Default "most_notable". | | `award` | string | no | `"Nobel Prize in Physics"` | Optional award received, for example Nobel Prize in Physics. Default "". | | `located_in` | string | no | | Optional country, region, or city, for example Canada. Default "". | | `max_results` | integer | no | `500` | Maximum number of items, for example 50 (up to 500). Default 50. | ## Output From a run on Oct 31, 2026, shortened. Its input: ```json { "kind": "person", "award": "Nobel Prize in Physics", "max_results": 500 } ``` Its output: ```json { "items": [ { "name": "Albert Einstein", "country": "Germany", "item_id": "Q937", "start_date": "1879-03-14", "wikidata_link": "https://www.wikidata.org/wiki/Q937", "short_description": "German-born theoretical physicist (1879โ€“1955)", "english_wikipedia_link": "https://en.wikipedia.org/wiki/Albert_Einstein" }, { "name": "Marie Curie", "country": "France", "item_id": "Q7186", "start_date": "1867-11-07", "wikidata_link": "https://www.wikidata.org/wiki/Q7186", "short_description": "Polish-born French physicist and chemist (1867โ€“1934)", "english_wikipedia_link": "https://en.wikipedia.org/wiki/Marie_Curie" }, { "name": "Niels Bohr", "country": "Kingdom of Denmark", "item_id": "Q7085", "start_date": "1885-10-07", "wikidata_link": "https://www.wikidata.org/wiki/Q7085", "short_description": "Danish physicist (1885โ€“1962)", "english_wikipedia_link": "https://en.wikipedia.org/wiki/Niels_Bohr" } ] } ``` ## Run it From code, with a Fous API key in `FOUS_API_KEY`; the answer's `data` holds the output: ```bash curl https://api.fous.com/v1/runs \ -H "Authorization: Bearer $FOUS_API_KEY" \ -H "Content-Type: application/json" \ -d '{"method":"wikidata.org/list_items_by_criteria","input":{"kind":"person","award":"Nobel Prize in Physics","max_results":500}}' ``` From an AI agent connected to the Fous MCP server: its `run` with the same method and input. To connect one, give it `set up https://fous.com/SKILL.md`. ## Ask your agent - List the 20 most notable universities in Canada along with their founding dates and English Wikipedia links - Which people have received the Nobel Prize in Chemistry? Give me up to 100, ordered from earliest to latest, using Wikidata - I need an alphabetical list of museums located in Lyon, with short descriptions and item IDs - Show me the newest airports in Brazil, maybe 30 of them, with their Wikidata links - Pull the 200 best-known novels that won the Pulitzer Prize for Fiction from wikidata.org, ranked by how many Wikipedia languages cover them ## Input schema ```json { "type": "object", "required": [ "kind" ], "properties": { "kind": { "type": "string", "description": "Kind of item, for example university or person." }, "sort": { "enum": [ "most_notable", "newest", "oldest", "alphabetical" ], "type": "string", "default": "most_notable", "description": "Result order; most_notable ranks by number of Wikipedia language editions, for example newest." }, "award": { "type": "string", "default": "", "description": "Optional award received, for example Nobel Prize in Physics." }, "located_in": { "type": "string", "default": "", "description": "Optional country, region, or city, for example Canada." }, "max_results": { "type": "integer", "default": 50, "maximum": 500, "minimum": 1, "description": "Maximum number of items, for example 50 (up to 500)." } } } ``` ## Output schema ```json { "type": "object", "required": [ "items" ], "properties": { "items": { "type": "array", "items": { "type": "object", "required": [ "name", "short_description", "country", "start_date", "english_wikipedia_link", "wikidata_link", "item_id" ], "properties": { "name": { "type": "string" }, "country": { "type": [ "string", "null" ] }, "item_id": { "type": "string" }, "start_date": { "type": [ "string", "null" ], "format": "date" }, "wikidata_link": { "type": "string" }, "short_description": { "type": [ "string", "null" ] }, "english_wikipedia_link": { "type": [ "string", "null" ] } }, "additionalProperties": false } } }, "additionalProperties": false } ``` ## See more - [Wikidata API: Get facts](https://fous.com/methods/wikidata.org/get-facts.md): Looks up a Wikidata item by name, item ID or link and returns its name, description, image, links and readable facts. A hint picks between items with similar names. - [topuniversities.com API: List QS university rankings](https://fous.com/methods/topuniversities.com/list-university-rankings.md): Lists the QS World University Rankings, or a QS subject ranking, for an edition and optionally one country, with each university's displayed rank, location, overall score and the indicator scores published for that table. - [Hacker News API: List stories](https://fous.com/methods/news.ycombinator.com/list-front-page.md): Lists current Hacker News stories in rank order from the top, newest, best, Ask HN, Show HN or jobs list. - [Similarweb API: List top websites](https://fous.com/methods/similarweb.com/list-top-websites.md): Lists Similarweb's most visited websites for a category and country, with rankings and engagement figures for the reported month. Anonymous view limits may restrict results, especially for country rankings. - [Steam API: List top sellers](https://fous.com/methods/store.steampowered.com/list-top-sellers.md): Lists Steam's top-selling, discounted, or new and trending games in store order, with prices for a chosen country, review summaries and release dates. - [Wikipedia API: Search articles](https://fous.com/methods/wikipedia.org/search-articles.md): Searches a Wikipedia language edition by keywords and returns matching articles in relevance order, with descriptions, snippets, word counts, last edit dates and links. - [Kaggle API: Search datasets](https://fous.com/methods/kaggle.com/search-datasets.md): Finds public Kaggle datasets on a topic, with size, file formats, usability, popularity and license. Lists at most 100 results in Kaggle's order; files are not downloaded. - [Kick API: List live streams](https://fous.com/methods/kick.com/list-live-streams.md): Lists the most-watched live Kick streams right now, optionally in one category and language, sorted by current viewers. - [All Wikidata methods](https://fous.com/methods/wikidata.org.md)