MPPtempoquality 0.55

Search Diffbot's 10B+ entity Knowledge Graph using DQL queries, paid per call via MPP/Tempo.

Price
per_call
Protocol
mpp
Verified
no
Endpoint
https://diffbot-kg.mpp.paywithlocus.com/diffbot-kg/search

What it does

This endpoint exposes Diffbot's Knowledge Graph search capability through the Locus MPP (Micropayment Protocol). It accepts DQL (Diffbot Query Language) queries and returns matching entities from a graph of over 10 billion entities covering organizations, people, products, articles, and more. The endpoint is POST-only and settles payments via the Tempo method on the MPP protocol.

The search endpoint supports structured DQL queries (e.g. `type:Organization locations.city.name:"San Francisco"`), free-text search, and a hybrid queryTextFallback mode. Results can be paginated with `from`/`size` parameters, filtered to specific fields via JsonPath expressions, and returned in extended or ID-only format. Pricing is described as $0.03–$1.50 per call at 25 credits per entity, settled in pathUSD on Tempo L2.

Note: The probe only tested HEAD and GET methods, both of which returned 404. Since the OpenAPI spec defines this as a POST endpoint, the 404s are expected and do not indicate the endpoint is down. The companion `/diffbot-kg/enhance` endpoint on the same host provides entity enrichment (person/company record augmentation) as a separate call. Documentation is available at Diffbot's official API reference and the Locus-hosted llms.txt file.

Capabilities

knowledge-graph-searchdql-queryentity-searchpaginationjsonpath-filteringorganization-lookupperson-lookupmpp-tempo-settlementpost-only

Use cases

  • —Search for organizations by location, industry, revenue, or other structured attributes
  • —Find person entities by name, employer, or title across 10B+ records
  • —Build lead-generation or market-intelligence pipelines with structured entity data
  • —Enrich CRM records by querying the Knowledge Graph for matching companies or people
  • —Power AI agents that need real-time access to structured web entity data

Fit

Best for

  • —AI agents needing structured entity data on companies and people
  • —Lead generation and sales intelligence workflows
  • —Market research requiring large-scale entity queries
  • —Data enrichment pipelines that need pay-per-call pricing without subscriptions

Not for

  • —Free-text web search or general-purpose search engine replacement
  • —Use cases requiring bulk data export at flat-rate pricing
  • —Real-time web crawling or scraping of arbitrary URLs

Quick start

curl -X POST https://diffbot-kg.mpp.paywithlocus.com/diffbot-kg/search \
  -H "Content-Type: application/json" \
  -H "X-Payment: <tempo-payment-token>" \
  -d '{"query": "type:Organization locations.city.name:\"San Francisco\"", "size": 5}'

Example

Request

{
  "from": 0,
  "size": 5,
  "type": "query",
  "query": "type:Organization locations.city.name:\"San Francisco\"",
  "jsonmode": "extended"
}

Endpoint

URLhttps://diffbot-kg.mpp.paywithlocus.com/diffbot-kg/search
Transporthttp
Protocolmpp
CurrencypathUSD

Quality

0.55/ 1.00

The OpenAPI spec provides a clear request schema, pricing description, and endpoint structure. However, the probe only tested HEAD/GET (both 404) on a POST-only endpoint, so liveness via 402 challenge was not confirmed. No response schema or example response is available, and crawled pages all returned generic 404 JSON. Documentation links exist but were not crawled.

Warnings

  • —Endpoint liveness not confirmed: probe used HEAD/GET but endpoint is POST-only; 404 is expected behavior, not proof of failure
  • —No response schema provided in the OpenAPI spec — response structure must be inferred from Diffbot documentation
  • —Pricing is described textually ($0.03–$1.50) but no structured amount/decimals were captured in the payment challenge
  • —The currency field is a hex address (0x20c…b50) — assumed to be pathUSD on Tempo L2 but not independently verified

Citations

Provenance

Indexed frommpp_dev
Enriched2026-04-19 17:24:57Z · anthropic/claude-opus-4.6 · v2
First seen2026-04-18
Last seen2026-04-22

Agent access

JSONhttps://clawmart.sh/api/listings/W5mP76