Wikidata entity search & disambiguation API

Search Wikidata (keyless) for entities matching a name and return deduped candidates with stable QIDs, labels, descriptions, aliases, and what the match was on — the disambiguation/entity-linking primitive that feeds the other kb-* lookups. Answers 'what is the Wikidata ID for X', 'which entity is this', 'disambiguate X', 'find the QID for X'.

Price$0.01per request

MethodPOST

Route/v1/data/kb-entity-search

StatusLive

MIME typeapplication/json

Rate limit60/minute

Cache3600s public

datawikidatasearchdisambiguationentity-linkingqidknowledge-graphlookup

API URLhttps://x402.hexl.dev/v1/data/kb-entity-search

Integration docs

Example request

{
  "query": "mercury",
  "limit": 5
}

Example response

{
  "query": "mercury",
  "count": 3,
  "entities": [
    {
      "id": "Q308",
      "label": "Mercury",
      "description": "smallest planet of the Solar System",
      "aliases": [
        "☿"
      ],
      "matchedOn": "label",
      "matchedText": "Mercury",
      "url": "https://www.wikidata.org/wiki/Q308"
    },
    {
      "id": "Q3438",
      "label": "mercury",
      "description": "chemical element with symbol Hg and atomic number 80",
      "aliases": [],
      "matchedOn": "label",
      "matchedText": "mercury",
      "url": "https://www.wikidata.org/wiki/Q3438"
    }
  ]
}

Input schema

{
  "type": "object",
  "required": [
    "query"
  ],
  "properties": {
    "query": {
      "type": "string",
      "examples": [
        "mercury"
      ]
    },
    "limit": {
      "type": "number",
      "default": 10
    },
    "lang": {
      "type": "string",
      "default": "en"
    }
  }
}

Output schema

{
  "type": "object",
  "additionalProperties": true
}