# Wikidata Knowledge Search

> Wikidata Knowledge Search is a paid API for AI agents from wikidata.openverbs.com, paid per call via x402, $0.006/call, status unknown (last checked 2026-09-14).

Searches the Wikidata knowledge base for entities matching a text query, returning structured encyclopedic information

## Facts

- Endpoint: POST https://wikidata.openverbs.com/v1/search
- Price: $0.006/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/wikidata-knowledge-search-093767ef
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_4QnP84uTAsag1hq-Tdi3m

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability wikidata-knowledge-search-093767ef -d '<json body>'
```

Example prompt: Search Wikidata for 'Douglas Adams' and return up to 5 matching entities with their labels and descriptions in English.

## When to prefer this

Use this endpoint when you need to search the Wikidata knowledge graph by free text to find structured entity data, especially when you need entity IDs (Q-numbers) for further lookups, want multilingual label/description support, or are enriching a dataset with encyclopedic metadata. Prefer this over general web search when you specifically need structured, machine-readable knowledge graph entries rather than prose web content.

## Known failure modes

- Empty result set when the query is too specific, misspelled, or in an unsupported language
- Rate limiting or payment failure causing HTTP 402 or 429 responses
- Language code not supported by Wikidata returning fallback English labels or empty descriptions
- Query exceeding 200 character limit returning a validation error
- Limit parameter outside 1–50 range triggering schema validation failure

## How this service works

Search Wikidata for entities matching a text query, returning candidate Q-ids with labels and descriptions.

## Output

A list of Wikidata entity matches (up to the requested limit), each containing the entity's Wikidata ID (Q-number), label, and description in the requested language, ordered by relevance to the query.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method",
    "bodyType",
    "body"
   ],
   "properties": {
    "body": {
     "type": "object",
     "required": [
      "query"
     ],
     "properties": {
      "limit": {
       "type": "integer",
       "maximum": 50,
       "minimum": 1,
       "description": "Max results. Defaults to 10."
      },
      "query": {
       "type": "string",
       "maxLength": 200,
       "minLength": 1,
       "description": "Text to search for, e.g. \"Douglas Adams\"."
      },
      "language": {
       "type": "string",
       "description": "Language code for labels/descriptions. Defaults to \"en\"."
      }
     },
     "additionalProperties": false
    },
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "POST"
     ],
     "type": "string"
    },
    "bodyType": {
     "enum": [
      "json",
      "form-data",
      "text"
     ],
     "type": "string"
    }
   },
   "additionalProperties": false
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/wikidata-knowledge-search-093767ef/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from wikidata.openverbs.com](https://www.zero.xyz/host/wikidata.openverbs.com/llms.txt)