# Wikidata API: Get facts

> 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.

Unofficial. Not affiliated with or endorsed by Wikidata.

- Page: https://fous.com/methods/wikidata.org/get-facts
- Method: `wikidata.org/get_facts`, version 1
- Website: wikidata.org
- Returns: name, short description, image URL, English Wikipedia URL, Wikidata URL, item ID, facts
- 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 |
|---|---|---|---|---|
| `hint` | string | no |  | Word in the description to distinguish similar items, for example company. Default "". |
| `name` | string | yes | `"Q2283"` | Name, Wikidata item ID, or Wikidata item link, for example Microsoft. |
| `language` | string | no |  | Language code for names and facts, for example en or fr. Default "en". |

## Output

From a run on Oct 31, 2026, shortened. Its input:

```json
{
  "name": "Q2283"
}
```

Its output:

```json
{
  "name": "Microsoft",
  "facts": [
    {
      "value": "Microsoft Corporation",
      "fact_name": "official name"
    },
    {
      "value": "Portal:Microsoft",
      "fact_name": "topic's main Wikimedia portal"
    },
    {
      "value": "Bill Gates",
      "fact_name": "founder"
    }
  ],
  "item_id": "Q2283",
  "image_url": "https://commons.wikimedia.org/wiki/Special:FilePath/Aerial_Microsoft_West_Campus_August_2009.jpg",
  "wikidata_url": "https://www.wikidata.org/wiki/Q2283",
  "short_description": "American multinational technology corporation",
  "english_wikipedia_url": "https://en.wikipedia.org/wiki/Microsoft"
}
```

## 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/get_facts","input":{"name":"Q2283"}}'
```

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

- Pull up the Wikidata entry for Q90 and give me its description, image and key facts
- Look up Mercury the planet (not the element or Freddie) and list its structured facts like mass and orbital period
- I need basic facts about Tesla the company — founding date, headquarters, CEO — plus its Wikipedia link
- Récupère les informations sur Marie Curie en français : description, image et faits principaux
- What does wikidata.org have on https://www.wikidata.org/wiki/Q7186? Return the item ID, English Wikipedia URL and readable facts

## Input schema

```json
{
  "type": "object",
  "required": [
    "name"
  ],
  "properties": {
    "hint": {
      "type": "string",
      "default": "",
      "description": "Word in the description to distinguish similar items, for example company."
    },
    "name": {
      "type": "string",
      "description": "Name, Wikidata item ID, or Wikidata item link, for example Microsoft."
    },
    "language": {
      "type": "string",
      "default": "en",
      "description": "Language code for names and facts, for example en or fr."
    }
  },
  "additionalProperties": false
}
```

## Output schema

```json
{
  "type": "object",
  "required": [
    "name",
    "short_description",
    "image_url",
    "english_wikipedia_url",
    "wikidata_url",
    "item_id",
    "facts"
  ],
  "properties": {
    "name": {
      "type": "string"
    },
    "facts": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "fact_name",
          "value"
        ],
        "properties": {
          "value": {
            "type": "string"
          },
          "fact_name": {
            "type": "string"
          }
        },
        "additionalProperties": false
      }
    },
    "item_id": {
      "type": "string",
      "x-fous-developer": true
    },
    "image_url": {
      "type": [
        "string",
        "null"
      ]
    },
    "wikidata_url": {
      "type": "string"
    },
    "short_description": {
      "type": [
        "string",
        "null"
      ]
    },
    "english_wikipedia_url": {
      "type": [
        "string",
        "null"
      ]
    }
  },
  "additionalProperties": false
}
```

## See more

- [Wikidata API: List items by criteria](https://fous.com/methods/wikidata.org/list-items-by-criteria.md): 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.
- [Wikipedia API: Get key facts from an article](https://fous.com/methods/wikipedia.org/get-key-facts.md): Returns the labeled facts, in order, from the information box of a Wikipedia article in any language edition. Articles without an information box have no facts.
- [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.
- [Wikipedia API: Get article summary](https://fous.com/methods/wikipedia.org/get-article-summary.md): Returns the opening summary, short description, main image, article link and last edit time for a Wikipedia topic in the chosen language. For ambiguous names it uses the top matching article and lists up to five alternatives.
- [Fandom API: Get a wiki article](https://fous.com/methods/fandom.com/get-wiki-article.md): Finds a topic on the main English Fandom wiki for a franchise (picked from Fandom's cross-wiki search, or given as a wiki or article link) and returns the article's opening paragraphs, infobox facts, section headings, main image and links.
- [Wikimedia Commons API: Search free images](https://fous.com/methods/commons.wikimedia.org/search-free-images.md): Finds free-to-use Wikimedia Commons images for a topic in Commons relevance order. Each image comes with its links, creator and licence details.
- [Britannica API: Get article](https://fous.com/methods/britannica.com/get-article.md): Finds the best-matching Britannica encyclopedia article for a topic and returns its introduction, quick facts, section headings, update date and main image.
- [Wikipedia API: Get full article](https://fous.com/methods/wikipedia.org/get-full-article.md): Returns the full text of a Wikipedia article in ordered sections, with its last edit time, reference count and visible categories, in any language edition. Footnotes, tables and navigation material are excluded; a topic that is not an exact title uses the best search match.
- [All Wikidata methods](https://fous.com/methods/wikidata.org.md)