# Diffbot Knowledge Graph Search via Locus x402

> Diffbot Knowledge Graph Search via Locus x402 is a paid API for AI agents from diffbot-kg.x402.paywithlocus.com, paid per call via x402, $0.03/call, status unknown (last checked 2026-10-13).

Search and enrich company/person records from Diffbot's Knowledge Graph of 10B+ entities using DQL queries, paid per-call via x402 micropayments.

## Facts

- Endpoint: POST https://diffbot-kg.x402.paywithlocus.com/diffbot-kg/search?utm_source=zero.xyz
- Price: $0.03/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/diffbot-knowledge-graph-search-via-locus-x402-2bd91a77
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_rNLLbYUTB3BI1EEhnJDyP

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 diffbot-knowledge-graph-search-via-locus-x402-2bd91a77 -d '<json body>'
```

Example prompt: Search the Diffbot Knowledge Graph for up to 20 organizations headquartered in Austin, Texas — use the DQL query type and return their names, industries, and employee counts.

## When to prefer this

Choose this endpoint when you need to search or enrich records against a massive, structured knowledge graph of 10B+ real-world entities (companies, people, organizations) using structured DQL queries. It is ideal for firmographic enrichment, lead research, and entity lookup at scale. Prefer this over web scraping or simpler business search APIs when you need structured, canonical entity data with rich facts and relationships, and when you are comfortable with per-call USDC micropayment billing via the x402 protocol.

## Known failure modes

- Invalid DQL query syntax returns an error with no results
- Querying an entity type that doesn't exist yields empty data
- Pagination offset beyond result set returns empty array
- Malformed JsonPath filter expression causes a filter error
- Payment authorization failure prevents the query from executing
- Rate limiting or network timeout from the upstream Diffbot API

## How this service works

Knowledge Graph — search 10B+ entities and enrich company/person records.

## Output

Returns a JSON object containing matched entity records from Diffbot's Knowledge Graph (companies, people, or other entity types), along with pagination metadata, payment settlement details (USDC amount charged), and a request ID for status tracking. The 'data' field holds the entity results matching the DQL query.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "from": {
   "type": "number"
  },
  "size": {
   "type": "number"
  },
  "type": {
   "type": "string"
  },
  "query": {
   "type": "string"
  },
  "filter": {
   "type": "string"
  },
  "jsonmode": {
   "type": "string"
  },
  "nonCanonicalFacts": {
   "type": "boolean"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "data": {},
  "payment": {
   "scheme": "exact",
   "settledUsdc": "0.001000",
   "authorizedMaxUsdc": "0.001000"
  },
  "request": {
   "id": "00000000-0000-4000-8000-000000000000",
   "statusUrl": "/requests/00000000-0000-4000-8000-000000000000"
  },
  "success": true
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/diffbot-knowledge-graph-search-via-locus-x402-2bd91a77/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from diffbot-kg.x402.paywithlocus.com](https://www.zero.xyz/host/diffbot-kg.x402.paywithlocus.com/llms.txt)