# Diffbot KG Enhance

> Diffbot KG Enhance is a paid API for AI agents from Diffbot KG at diffbot-kg.mpp.paywithlocus.com, paid per call via MPP, $0.03 ($0.12 with refresh) (dynamic), status unknown (last checked 2026-10-11).

Enriches a Person or Organization entity with detailed knowledge-graph data using partial identifiers like name, URL, email, or location

## Facts

- Endpoint: POST https://diffbot-kg.mpp.paywithlocus.com/diffbot-kg/enhance?utm_source=zero.xyz
- Price: $0.03 ($0.12 with refresh) (dynamic)
- Payment: MPP
- Status: unknown
- Last checked: 2026-10-11
- Activations on Zero: 0
- Provider: Diffbot KG
- Docs: https://docs.diffbot.com/reference/knowledge-graph
- Website: https://www.diffbot.com
- Tags: knowledge-graph, entities, enrichment, company-data, data
- Canonical page: https://www.zero.xyz/c/diffbot-kg-enhance-a68be83e
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_uVGDGoQ4bgKAq3X9xaWGp

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-kg-enhance-a68be83e -d '<json body>'
```

Example prompt: Can you enrich the Organization record for 'Acme Corp' using their website acme.com and location 'San Francisco, CA' — I need their full profile from the Diffbot Knowledge Graph?

## When to prefer this

Use this endpoint when you have partial information about a company or person and need to resolve and enrich it with a full structured profile from Diffbot's Knowledge Graph. Prefer this over the Search endpoint when you already have some identifying attributes (name, URL, email) and want a single best-match enrichment rather than a broad search across multiple results.

## Known failure modes

- No match found for the provided identifiers — returns empty results or low-confidence match
- Ambiguous entity name with no disambiguating fields (URL, email, location) leads to incorrect match
- refresh=true increases cost to 100 credits instead of 25 and may time out for complex entities
- Missing required 'type' field (Person or Organization) causes a validation error
- Confidence threshold too high results in no matches returned even when candidates exist
- Person-only fields (email, title, employer) sent for Organization type may be ignored or cause errors

## How this service works

Enrich a person or organization record with Knowledge Graph data using minimal identifiers.

## Output

Returns a matched and enriched entity record (Person or Organization) from Diffbot's Knowledge Graph of 10B+ entities, including structured profile data such as company details, employee info, location, social profiles, and a match confidence score. The number of matches returned is configurable via the size parameter.

## Example request

```json
{
 "url": "https://acme.com",
 "name": "Acme Corp",
 "size": 1,
 "type": "Organization",
 "location": "San Francisco, CA"
}
```

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "required": [
  "type"
 ],
 "properties": {
  "url": {
   "anyOf": [
    {
     "type": "string"
    },
    {
     "type": "array",
     "items": {
      "type": "string"
     }
    }
   ],
   "description": "Website URL(s) for the entity"
  },
  "name": {
   "anyOf": [
    {
     "type": "string"
    },
    {
     "type": "array",
     "items": {
      "type": "string"
     }
    }
   ],
   "description": "Entity name(s)"
  },
  "size": {
   "type": "number",
   "description": "Number of matches to return (default 1)"
  },
  "type": {
   "type": "string",
   "description": "Entity type: Person or Organization"
  },
  "email": {
   "anyOf": [
    {
     "type": "string"
    },
    {
     "type": "array",
     "items": {
      "type": "string"
     }
    }
   ],
   "description": "Email address(es) (Person only)"
  },
  "phone": {
   "type": "string",
   "description": "Phone number"
  },
  "title": {
   "type": "string",
   "description": "Job title (Person only)"
  },
  "refresh": {
   "type": "boolean",
   "description": "Re-crawl the entity (costs 100 credits instead of 25)"
  },
  "employer": {
   "type": "string",
   "description": "Employer name (Person only)"
  },
  "location": {
   "type": "string",
   "description": "Location of the entity"
  },
  "threshold": {
   "type": "number",
   "description": "Match confidence threshold (0-1)"
  }
 },
 "additionalProperties": true
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/diffbot-kg-enhance-a68be83e/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from diffbot-kg.mpp.paywithlocus.com](https://www.zero.xyz/host/diffbot-kg.mpp.paywithlocus.com/llms.txt)