# SYNTHORA Wikidata Entity Search (wbsearchentities)

> SYNTHORA Wikidata Entity Search (wbsearchentities) is a paid API for AI agents from wikidata-entity-search.hergertsynthora.com, paid per call via x402, $0.001/call, status unknown (last checked 2026-09-13).

Resolves a natural-language text label to ranked Wikidata entity IDs (Q-numbers) with labels and descriptions, enabling entity linking to canonical knowledge-graph identifiers.

## Facts

- Endpoint: POST https://wikidata-entity-search.hergertsynthora.com/service
- Price: $0.001/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/synthora-wikidata-entity-search-wbsearchentities-02a39779
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_xXFRCttTdtpZ7OFSB5p9I

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 synthora-wikidata-entity-search-wbsearchentities-02a39779 -d '<json body>'
```

Example prompt: Look up 'Marie Curie' on Wikidata and give me her Q-number along with the top ranked entity descriptions so I can confirm the right one.

## When to prefer this

Prefer this endpoint when an AI agent needs to map a natural-language entity mention to a canonical Wikidata Q-number for downstream knowledge-graph operations, structured data enrichment, or agent-to-agent workflows. It is keyless and fast, making it ideal for high-frequency entity-linking tasks in autonomous pipelines. Choose it over direct Wikidata API calls when you need a metered, x402-compatible microservice with predictable per-call pricing and no API key management.

## Known failure modes

- Missing query parameter returns ok:false with error 'Missing query parameter' and empty result
- Ambiguous or very short queries may return many low-confidence candidates requiring downstream disambiguation
- Entity not in Wikidata returns an empty result list
- Network or upstream Wikidata API unavailability causes service errors
- Non-Latin or rare-language queries may return fewer or lower-quality matches

## How this service works

Resolves a text label to ranked Wikidata entity IDs (Q-numbers) with labels and descriptions across languages. A fast keyless entity-linking endpoint for autonomous agents and agent-to-agent workflows that map natural-language mentions to canonical knowledge-graph identifiers. First 3 calls FREE per wallet — send header X-WALLET: 0x<addr>. No charge on upstream failure.

## Output

A JSON object containing an 'ok' boolean, a ranked list of Wikidata entity candidates each with their Q-number identifier, human-readable label, and short description, plus provenance information indicating the result came from the Wikidata wbsearchentities API.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "query": {
   "type": "string",
   "description": "query"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "ok": true,
  "niche": "wikidata-entity-search",
  "result": {
   "ok": false,
   "error": "Missing query parameter",
   "niche": "wikidata-entity-search",
   "result": {},
   "provenance": {}
  },
  "provenance": {
   "url": "https://www.wikidata.org/w/api.php",
   "source": "Wikidata Entity Search (wbsearchentities)"
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/synthora-wikidata-entity-search-wbsearchentities-02a39779/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from wikidata-entity-search.hergertsynthora.com](https://www.zero.xyz/host/wikidata-entity-search.hergertsynthora.com/llms.txt)