{"openapi":"3.1.0","info":{"title":"Diffbot KG via Locus MPP","version":"1.0.0","description":"Knowledge Graph — search 10B+ entities and enrich company/person records.","contact":{"email":"api@paywithlocus.com"},"x-guidance":"Use the documented POST operations for Diffbot KG. Send JSON matching each requestBody schema. Unpaid public x402 requests return an x402 v2 payment challenge; retry the same body with PAYMENT-SIGNATURE and the returned x-locus-request-id."},"x-agentcash-guidance":{"llmsTxtUrl":"https://paywithlocus.com/mpp/diffbot-kg.md"},"x-service-info":{"categories":["data"],"docs":{"homepage":"https://www.diffbot.com","apiReference":"https://docs.diffbot.com/reference/knowledge-graph","llms":"https://paywithlocus.com/mpp/diffbot-kg.md"}},"paths":{"/diffbot-kg/search":{"post":{"operationId":"diffbot_kg_search","summary":"Search (DQL)","description":"Search Diffbot Knowledge Graph of 10B+ entities using Diffbot Query Language.","tags":["Data / Intelligence"],"security":[],"x-payment-info":{"intent":"charge","method":"tempo","amount":null,"currency":"0x20c000000000000000000000b9537d11c60e8b50","description":"$0.03–$1.50 (25 credits/entity)"},"parameters":[{"name":"x-locus-request-id","in":"header","required":false,"description":"UUID returned by the initial 402. Echo it on the paid retry and later recovery attempts.","schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"query":{"type":"string","description":"DQL query string (e.g. type:Organization locations.city.name:\"San Francisco\")"},"type":{"type":"string","description":"Query type: query, text, queryTextFallback (default: query)"},"from":{"type":"number","description":"Pagination offset (default 0)"},"size":{"type":"number","description":"Max entities to return (default 50)"},"filter":{"type":"string","description":"JsonPath expression to filter response fields"},"jsonmode":{"type":"string","description":"Response format: extended or id"},"nonCanonicalFacts":{"type":"boolean","description":"Include non-canonical facts"}},"required":["query"],"additionalProperties":true},"example":{"query":"type:Organization","type":"query","size":1}}}},"responses":{"200":{"description":"Successful response with PAYMENT-RESPONSE and durable request receipt"},"202":{"description":"The supplied request ID is already in progress"},"400":{"description":"Invalid request"},"402":{"description":"Payment Required"},"409":{"description":"Request ID conflict or terminal failed request"}}}},"/diffbot-kg/enhance":{"post":{"operationId":"diffbot_kg_enhance","summary":"Enhance","description":"Enrich a person or organization record with Knowledge Graph data using minimal identifiers.","tags":["Data / Intelligence"],"security":[],"x-payment-info":{"intent":"charge","method":"tempo","amount":null,"currency":"0x20c000000000000000000000b9537d11c60e8b50","description":"$0.03 ($0.12 with refresh)"},"parameters":[{"name":"x-locus-request-id","in":"header","required":false,"description":"UUID returned by the initial 402. Echo it on the paid retry and later recovery attempts.","schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string","description":"Entity type: Person or Organization"},"name":{"anyOf":[{"type":"string"},{"type":"array","items":{"type":"string"}}],"description":"Entity name(s)"},"url":{"anyOf":[{"type":"string"},{"type":"array","items":{"type":"string"}}],"description":"Website URL(s) for the entity"},"email":{"anyOf":[{"type":"string"},{"type":"array","items":{"type":"string"}}],"description":"Email address(es) (Person only)"},"phone":{"type":"string","description":"Phone number"},"employer":{"type":"string","description":"Employer name (Person only)"},"title":{"type":"string","description":"Job title (Person only)"},"location":{"type":"string","description":"Location of the entity"},"refresh":{"type":"boolean","description":"Re-crawl the entity (costs 100 credits instead of 25)"},"size":{"type":"number","description":"Number of matches to return (default 1)"},"threshold":{"type":"number","description":"Match confidence threshold (0-1)"}},"required":["type"],"additionalProperties":true},"example":{"type":"Person","name":["Bill Gates"],"url":["https://www.gatesnotes.com"],"size":1}}}},"responses":{"200":{"description":"Successful response with PAYMENT-RESPONSE and durable request receipt"},"202":{"description":"The supplied request ID is already in progress"},"400":{"description":"Invalid request"},"402":{"description":"Payment Required"},"409":{"description":"Request ID conflict or terminal failed request"}}}}}}