# Wikidata Entity Enrichment

> Wikidata Entity Enrichment is a paid API for AI agents from agent402.tools, paid per call via x402, $0.005/call, status unknown (last checked 2026-09-15).

Retrieves structured facts about a company, person, or organization from Wikidata by entity ID or name search, returning label, description, aliases, and curated attributes like founding date, HQ, industry, founders, CEO, and employee count.

## Facts

- Endpoint: POST https://agent402.tools/api/wikidata-entity
- Price: $0.005/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/wikidata-entity-enrichment-1b285c10
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_hCKxgV3u1XW44CJblpb8Z

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-enrichment-1b285c10 -d '<json body>'
```

Example prompt: Can you pull up the Wikidata facts for Apple Inc. — specifically when it was founded, who the CEO is, and where its headquarters are? The Wikidata ID is Q312.

## When to prefer this

Use this endpoint when you need structured, curated facts about a well-known company, person, or organization and want a reliable knowledge-graph source rather than web scraping. Prefer it over search-based enrichment when you already have a Wikidata entity ID (Q-number) for exact lookup, or when you need canonical metadata like founding date, HQ, or CEO that Wikidata reliably covers for major entities.

## Known failure modes

- Entity ID not found in Wikidata — returns empty or 404-style error
- Ambiguous name search returns multiple candidates with no clear top match
- Entity exists but has sparse Wikidata coverage — many fact fields will be null or missing
- Malformed entity ID format (e.g. missing Q prefix) causes validation error
- Rate limit or payment failure via x402 protocol blocks the call

## How this service works

Company/person/organization facts from Wikidata. Pass an entity id (e.g. Q312 for Apple Inc.) for the enrichment record - label, description, aliases, and a curated fact set (inception, HQ location, country, industry, founders, CEO, employees, revenue, official website, LEI, ticker + exchange, ISIN, logo; for people: birth/death dates, citizenship, occupation) with item references resolved to human-readable labels.

## Output

Returns a structured enrichment record for the matched entity, including the canonical label, human-readable description, known aliases, and a curated fact set covering inception date, headquarters location, country, industry, founders, current CEO, employee count, and revenue figures sourced from Wikidata.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "id": {
   "type": "string",
   "description": "Wikidata entity id, e.g. Q312 (exact entity lookup)."
  },
  "name": {
   "type": "string",
   "description": "Entity name to search instead (ranked candidate list). Provide id OR name."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "id": "Q312",
  "facts": {
   "lei": [
    "HWUPKR0MPOU8FGXBT394"
   ],
   "inception": [
    "1976-04-01T00:00:00Z"
   ],
   "tickerSymbol": [
    "AAPL"
   ],
   "officialWebsite": [
    "https://www.apple.com/"
   ],
   "headquartersLocation": [
    {
     "id": "Q3070754",
     "label": "Apple Park"
    }
   ]
  },
  "found": true,
  "label": "Apple Inc.",
  "source": "wikidata.org",
  "aliases": [
   "Apple",
   "Apple Computer, Inc."
  ],
  "description": "American multinational technology company",
  "statementCount": 300
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/wikidata-entity-enrichment-1b285c10/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from agent402.tools](https://www.zero.xyz/host/agent402.tools/llms.txt)