Enrich company or person records via Diffbot's 10B+ entity Knowledge Graph
What it does
The Diffbot KG Enhance endpoint lets you submit partial entity information (name, URL, email, employer, job title, phone, location) and receive a fully enriched company or person record drawn from Diffbot's Knowledge Graph of over 10 billion entities. It is exposed through the Locus MPP (Micropayment Protocol) gateway, settling payments on Tempo L2 in pathUSD.
The endpoint accepts POST requests with a JSON body specifying the entity type (Person or Organization) along with any combination of identifying fields. It returns matched and enriched entity data. You can tune the number of results returned (size) and the confidence threshold for matching. An optional "refresh" flag triggers a live re-crawl of the entity's sources at a higher cost ($0.12 vs. the standard $0.03 per call). The companion /diffbot-kg/search endpoint provides DQL-based querying across the same Knowledge Graph.
Note: The probe only tested HEAD and GET methods, which returned 404. The endpoint is documented as a POST-only route in the OpenAPI spec, so the 404s do not indicate the endpoint is down — they simply reflect the wrong HTTP method being used. The root domain also returns 404 by design, directing callers to the skill file and llms.txt for routing information.
Capabilities
Use cases
- —Enrich CRM records with full company or person profiles from Diffbot's Knowledge Graph
- —Resolve partial contact information (name + employer) into a complete person record
- —Augment lead lists with firmographic and demographic data on demand
- —Verify and complete organization records using URL or name matching
- —Agent-driven data enrichment pipelines that pay per call via MPP
Fit
Best for
- —AI agents needing on-demand entity enrichment without API key management
- —Sales and marketing automation requiring company/person data enrichment
- —Data pipelines that need pay-per-call access to Diffbot's Knowledge Graph
Not for
- —Bulk batch enrichment of millions of records (per-call pricing may be costly at scale)
- —Use cases requiring free or open-source entity data
Quick start
curl -X POST https://diffbot-kg.mpp.paywithlocus.com/diffbot-kg/enhance \
-H "Content-Type: application/json" \
-H "Authorization: Bearer <MPP_TOKEN>" \
-d '{"type": "Organization", "name": "OpenAI", "url": "https://openai.com"}'Example
Request
{
"url": "https://openai.com",
"name": "OpenAI",
"size": 1,
"type": "Organization",
"threshold": 0.8
}Endpoint
Quality
The OpenAPI spec provides a clear request schema, pricing description, and endpoint summary, but no response schema or example response is available. The probe used HEAD/GET which returned 404; the endpoint is POST-only so liveness could not be confirmed. No crawled documentation beyond the OpenAPI was retrievable.
Warnings
- —Endpoint liveness not confirmed: probe used HEAD/GET but endpoint is POST-only; 404 is expected for non-POST methods
- —No response schema or example response available in the OpenAPI spec
- —Pricing is described textually ($0.03 / $0.12 with refresh) but the amount field in x-payment-info is null, so exact on-chain pricing is unclear
- —Documentation links (docs.diffbot.com, beta.paywithlocus.com/mpp/diffbot-kg.md) were not crawled and could not be verified
Citations
- —Knowledge Graph contains 10B+ entitieshttps://diffbot-kg.mpp.paywithlocus.com
- —Enhance endpoint costs $0.03 per call ($0.12 with refresh)https://diffbot-kg.mpp.paywithlocus.com
- —Payment settles via Tempo method on pathUSDhttps://diffbot-kg.mpp.paywithlocus.com
- —API reference available at docs.diffbot.comhttps://diffbot-kg.mpp.paywithlocus.com