# Delx Commerce — Open Entities Search (Wikidata)

> Delx Commerce — Open Entities Search (Wikidata) is a paid API for AI agents from commerce.delx.ai, paid per call via x402, $0.001/call, status unknown (last checked 2026-10-01).

Searches Wikidata's open knowledge graph for structured entity records matching a text query, returning entity IDs, labels, descriptions, and source URLs.

## Facts

- Endpoint: POST https://commerce.delx.ai/api/v1/x402/open-entities-search?utm_source=zero.xyz
- Price: $0.001/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-01
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/delx-commerce-open-entities-search-wikidata-353adeab
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_-C4WC7Jj0_ffh4MV1dqrw

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 delx-commerce-open-entities-search-wikidata-353adeab -d '<json body>'
```

Example prompt: Search the open knowledge graph for 'Fortaleza' and return up to 5 entity results with their Wikidata IDs and descriptions.

## When to prefer this

Choose this endpoint when you need structured, canonical entity metadata (IDs, descriptions, URIs) from Wikidata's open knowledge graph at low cost ($0.001/call) without requiring an API key or account. Prefer it over raw Wikidata API calls when you want a normalized, agent-ready response with attribution and license metadata pre-included. Best for entity resolution, knowledge graph enrichment, and named entity disambiguation tasks.

## Known failure modes

- Empty results array if no entity matches the query string
- Timeout if provider response exceeds the configured timeout (2–8 seconds)
- Invalid input if query is empty or exceeds 120 characters
- Rate-limiting or payment failure if USDC payment via x402 is not processed correctly

## How this service works

Pay-per-result APIs for agents. No signup. Exact price. Verifiable delivery. USDC on Base + Solana via x402.

## Output

A JSON object containing the search query, provider (Wikidata), result count, and an array of matching entities. Each entity includes a Wikidata entity ID (e.g. Q43433), a human-readable label, a short description, a concept URI, and a URL to the Wikidata page. Also includes cache status, language, license URL (CC0), and attribution text.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "query": {
   "type": "string",
   "maxLength": 120,
   "minLength": 1
  },
  "timeout": {
   "type": "integer",
   "default": 8,
   "maximum": 8,
   "minimum": 2
  },
  "max_records": {
   "type": "integer",
   "default": 10,
   "maximum": 10,
   "minimum": 1
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "result": {
   "cache": "miss",
   "count": 1,
   "query": "Fortaleza",
   "scope": "open_entities",
   "schema": "delx/open-entities-search/v1",
   "results": [
    {
     "id": "Q43433",
     "url": "https://www.wikidata.org/wiki/Q43433",
     "label": "Fortaleza",
     "concept_uri": "https://www.wikidata.org/entity/Q43433",
     "description": "municipality in Brazil"
    }
   ],
   "language": "en",
   "provider": "Wikidata",
   "attribution": "Structured data supplied by Wikidata under CC0; preserve the entity ID and source link. This result contains public entity metadata only.",
   "license_url": "https://creativecommons.org/publicdomain/zero/1.0/",
   "max_records": 3,
   "provider_url": "https://www.wikidata.org/"
  },
  "tool_name": "search_open_entities"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/delx-commerce-open-entities-search-wikidata-353adeab/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from commerce.delx.ai](https://www.zero.xyz/host/commerce.delx.ai/llms.txt)