# Diffbot Knowledge Graph Enhance via Locus x402

> Diffbot Knowledge Graph Enhance 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-11).

Search Diffbot's 10B+ entity Knowledge Graph to enrich company or person records using name, URL, email, or other identifiers.

## Facts

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

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-enhance-via-locus-x402-f35c0f15 -d '<json body>'
```

Example prompt: Look up the company Stripe in Diffbot's Knowledge Graph using their website stripe.com and return 1 Organization match — I want their full enriched profile including industry, size, and location.

## When to prefer this

Choose this endpoint when you need structured, comprehensive entity enrichment at scale from Diffbot's curated 10B+ entity Knowledge Graph, especially when you have partial identifiers (name, URL, or email) and need authoritative company or person profiles. Prefer this over generic web scraping when you want structured, pre-parsed firmographic or professional data without building your own extraction pipeline. The pay-per-call x402 model makes it suitable for low-to-medium volume enrichment without a subscription commitment.

## Known failure modes

- No entity match found for the provided identifiers (low confidence or unknown entity)
- Match confidence below the specified threshold — returns empty or partial results
- Invalid entity type value (must be 'Person' or 'Organization')
- Missing required identifiers — at least one of url, name, or email must be provided
- Payment failure or insufficient funds via x402 protocol
- Rate limiting or credit exhaustion on the Diffbot side
- Refresh flag set to true incurs higher cost (100 credits vs 25)

## How this service works

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

## Output

Returns a JSON object with enriched entity data (company or person fields such as name, industry, location, employee count, job title, employer, etc.), payment settlement details (USDC amount charged), and a request tracking ID with a status URL.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "url": {
   "anyOf": [
    {
     "type": "string"
    },
    {
     "type": "array",
     "items": {
      "type": "string"
     }
    }
   ]
  },
  "name": {
   "anyOf": [
    {
     "type": "string"
    },
    {
     "type": "array",
     "items": {
      "type": "string"
     }
    }
   ]
  },
  "size": {
   "type": "number"
  },
  "type": {
   "type": "string"
  },
  "email": {
   "anyOf": [
    {
     "type": "string"
    },
    {
     "type": "array",
     "items": {
      "type": "string"
     }
    }
   ]
  },
  "phone": {
   "type": "string"
  },
  "title": {
   "type": "string"
  },
  "refresh": {
   "type": "boolean"
  },
  "employer": {
   "type": "string"
  },
  "location": {
   "type": "string"
  },
  "threshold": {
   "type": "number"
  }
 }
}
```

## 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-enhance-via-locus-x402-f35c0f15/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)