# Wikidata Entity Search (Q-ID Lookup)

> Wikidata Entity Search (Q-ID Lookup) is a paid API for AI agents from twin.unykorn.org, paid per call via x402, $0.002/call, status unknown (last checked 2026-10-03).

Searches Wikidata to find the canonical Q-identifier (e.g. Q76, Q2) for any named person, company, place, concept, or thing

## Facts

- Endpoint: POST https://twin.unykorn.org/research/wikidata-search?utm_source=zero.xyz
- Price: $0.002/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-03
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/wikidata-entity-search-q-id-lookup-b295cecf
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_P5MKzbVxnDUdm4e1nIXX-

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-entity-search-q-id-lookup-b295cecf -d '<json body>'
```

Example prompt: What's the Wikidata Q-ID for Elon Musk? Give me up to 3 results so I can pick the right one.

## When to prefer this

Choose this endpoint when you need to resolve a named entity (person, organization, location, concept) to its canonical Wikidata Q-identifier, particularly for knowledge graph enrichment, linked data pipelines, or entity disambiguation. Prefer this over a general web search when you specifically need a structured, machine-readable Wikidata ID rather than web page links or prose descriptions.

## Known failure modes

- No matching entities found for an obscure or misspelled query — returns empty result list
- Ambiguous query returns many unrelated entities requiring manual disambiguation
- Rate limiting or upstream Wikidata API unavailability — may return 5xx error
- Invalid limit parameter (outside 1–20 range) returns a validation error
- Non-string or missing 'q' parameter causes a 400 bad request

## How this service works

Wikidata entity search (find the Q-id for any person, company, place, thing) — Genesis402 / UnyKorn Operator Network

## Output

Returns a ranked list of matching Wikidata entities, each with a Q-ID (e.g. Q76), a human-readable label, a short description disambiguating the entity, and a link to its Wikidata page. Up to 20 results can be returned per query (default 5).

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "params": {
   "type": "object",
   "properties": {
    "q": {
     "type": "string",
     "description": "required"
    },
    "limit": {
     "type": "integer",
     "maximum": 20,
     "minimum": 1,
     "description": "optional: max rows (default 5, max 20)"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "ok": true,
  "type": "wikidata-search",
  "receipt": {
   "tx_hash": "0x<64hex>",
   "amount_usd": 0.002,
   "receipt_id": "g402-<16hex>"
  },
  "sources": [
   {
    "ok": true,
    "name": "<source>"
   }
  ],
  "limitations": "<text>",
  "generated_at": "<iso time>",
  "evidence_hash": "sha256:<64hex>"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/wikidata-entity-search-q-id-lookup-b295cecf/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from twin.unykorn.org](https://www.zero.xyz/host/twin.unykorn.org/llms.txt)