# x402 Agent Hub – Wikidata Entity Search

> x402 Agent Hub – Wikidata Entity Search is a paid API for AI agents from x402-agent-hub.x402-agent-hub.workers.dev, paid per call via x402, $0.002/call, status unknown (last checked 2026-11-14).

Searches Wikidata by name to return entity IDs, short descriptions, and Wikipedia links for companies, people, or any notable subject

## Facts

- Endpoint: GET https://x402-agent-hub.x402-agent-hub.workers.dev/v1/entity/search?utm_source=zero.xyz
- Price: $0.002/call
- Payment: x402
- Status: unknown
- Last checked: 2026-11-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/x402-agent-hub-wikidata-entity-search-2a13a42e
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_rE7Dl1vSJqhNAMNrl9l64

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 x402-agent-hub-wikidata-entity-search-2a13a42e
```

Example prompt: Search Wikidata for 'Grab' as a company and give me its Wikidata ID, description, and Wikipedia link so I can confirm it's the Southeast Asian ride-hailing firm before pulling more details.

## When to prefer this

Use this endpoint when you need to resolve a human-readable name (company, person, or other notable entity) to a structured Wikidata identifier before performing downstream enrichment. It is ideal as a first step in pipelines that use other x402 Agent Hub endpoints such as professional profile lookup or SEC company search. Prefer it over generic web search when you need a stable, canonical entity ID from the Wikidata knowledge graph. The pay-per-successful-read pricing means failed lookups carry no cost.

## Known failure modes

- Invalid or empty query string cancels settlement and returns an error
- Entity not found in Wikidata returns zero results (no charge)
- Upstream Wikidata API errors cancel settlement (no charge)
- Limit parameter outside 1–20 range may be rejected or clamped
- Highly ambiguous names may return unrelated entities requiring manual disambiguation

## How this service works

Search Wikidata for companies, notable people or anything else by name and get IDs, short descriptions and Wikipedia links, so you can pick the right entity before enriching it. You only pay for successful reads: invalid input, not-found and upstream errors cancel settlement.

## Output

Returns a JSON object with the query string, entity type, result count, and an array of matching entities each containing a Wikidata ID (e.g. Q20873932), human-readable label, short description, and Wikipedia URL. Typically 1–5 results unless a higher limit is requested.

## 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"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "q"
     ],
     "properties": {
      "q": {
       "type": "string",
       "description": "Name to search, e.g. grab."
      },
      "type": {
       "type": "string",
       "description": "company, person or any (default any)."
      },
      "limit": {
       "type": "string",
       "description": "Max results, 1-20 (default 5)."
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "type": "company",
  "count": 1,
  "query": "grab",
  "results": [
   {
    "id": "Q20873932",
    "label": "Grab",
    "description": "Southeast Asian technology company headquartered in Singapore",
    "wikipediaUrl": "https://en.wikipedia.org/wiki/Grab_Holdings"
   }
  ]
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/x402-agent-hub-wikidata-entity-search-2a13a42e/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402-agent-hub.x402-agent-hub.workers.dev](https://www.zero.xyz/host/x402-agent-hub.x402-agent-hub.workers.dev/llms.txt)
