# Diffbot Knowledge Graph DQL Search

> Diffbot Knowledge Graph DQL Search is a paid API for AI agents from Diffbot KG at diffbot-kg.mpp.paywithlocus.com, paid per call via MPP, $0.03–$1.50 (25 credits/entity) (dynamic), status unknown (last checked 2026-10-10).

Search Diffbot's Knowledge Graph of 10B+ entities using DQL queries to retrieve structured company, person, and organization data

## Facts

- Endpoint: POST https://diffbot-kg.mpp.paywithlocus.com/diffbot-kg/search?utm_source=zero.xyz
- Price: $0.03–$1.50 (25 credits/entity) (dynamic)
- Payment: MPP
- Status: unknown
- Last checked: 2026-10-10
- 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-search-9eed582c
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_SrKRA1dbdK5W94XwygKok

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-search-9eed582c -d '<json body>'
```

Example prompt: Search the Diffbot Knowledge Graph for all type:Organization entities where locations.city.name is 'San Francisco' and return the first 20 results — use a DQL query format.

## When to prefer this

Use this endpoint when you need to search across Diffbot's 10B+ entity knowledge graph using structured DQL queries — ideal for finding companies, people, or organizations by specific attributes like location, industry, or name. Prefer this over the Enhance endpoint when you are doing broad discovery queries rather than enriching a known entity. Best for business intelligence, lead generation, entity lookup, and knowledge graph exploration tasks.

## Known failure modes

- Invalid DQL query syntax returns a 400 error
- Query returns 0 results if entity type or field names are misspelled
- Pagination offset beyond result set returns empty list
- Unsupported jsonmode value causes a format error
- Missing required 'query' field returns validation error

## How this service works

Search Diffbot Knowledge Graph of 10B+ entities using Diffbot Query Language.

## Output

A paginated list of matched entities (organizations, people, or other types) with structured facts including names, locations, industries, financials, and other canonical attributes from Diffbot's knowledge graph. Supports field filtering via JsonPath and extended JSON modes.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "required": [
  "query"
 ],
 "properties": {
  "from": {
   "type": "number",
   "description": "Pagination offset (default 0)"
  },
  "size": {
   "type": "number",
   "description": "Max entities to return (default 50)"
  },
  "type": {
   "type": "string",
   "description": "Query type: query, text, queryTextFallback (default: query)"
  },
  "query": {
   "type": "string",
   "description": "DQL query string (e.g. type:Organization locations.city.name:\"San Francisco\")"
  },
  "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"
  }
 },
 "additionalProperties": true
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/diffbot-kg-search-9eed582c/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)