# Suverse Wikidata Entity Search

> Suverse Wikidata Entity Search is a paid API for AI agents from proxy.suverse.io, paid per call via x402, $0.002/call, status unknown (last checked 2026-09-16).

Search Wikidata by label or name to resolve entities into their canonical IDs, labels, and descriptions from the knowledge graph

## Facts

- Endpoint: POST https://proxy.suverse.io/v1/data/suverse-wikidata-search
- Price: $0.002/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-16
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/suverse-wikidata-entity-search-080d5706
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_Fwmp4d3XYo_kjA6NTMH7L

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 suverse-wikidata-entity-search-080d5706 -d '<json body>'
```

Example prompt: Can you find the Wikidata entity for 'Marie Curie' and tell me her entity ID and description?

## When to prefer this

Use this endpoint when you need to resolve a human-readable name or label into a canonical Wikidata entity ID (QID) without requiring an API key. It is ideal for AI agents enriching data pipelines, building knowledge graph links, or disambiguating named entities from free text. Prefer it over direct Wikidata API calls when you want a proxied, pay-per-use model with no credential management.

## Known failure modes

- No matching entities found for the given label — returns empty results
- Ambiguous label matches many entities — returns multiple candidates requiring manual disambiguation
- Wikidata upstream service unavailable — request fails with error
- Malformed or empty body — returns validation error
- Payment not fulfilled (x402) — request rejected before reaching Wikidata

## How this service works

Search Wikidata entities by label, no key. Returns matching entity IDs, labels, and descriptions. For AI agents resolving names to structured knowledge-graph entities.

## Output

A list of matching Wikidata entities, each with a Wikidata entity ID (QID), a human-readable label, and a short description that helps distinguish between similarly named entities.

## 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": {
     "properties": {}
    },
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "POST",
      "PUT",
      "PATCH"
     ],
     "type": "string"
    },
    "bodyType": {
     "enum": [
      "json",
      "form-data",
      "text"
     ],
     "type": "string"
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/suverse-wikidata-entity-search-080d5706/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from proxy.suverse.io](https://www.zero.xyz/host/proxy.suverse.io/llms.txt)