Diffbot

Diffbot Bulk Enhance API

Enhance multiple records asynchronously

GitHub OpenAPI

Operations 9

Each operation below carries the questions people ask an LLM about it and the instructions they give an agent to run it. Generated by API Evangelist overlay

POST /kg/v3/enhance/bulk Submit a bulk enhance job for many records · Create a Bulkjob #
Ask an LLM
“How do I enrich a large batch of people or company records at once?”
“Can I get a webhook callback when a bulk enhance job completes?”
Tell an agent
Submit a bulk enhance job named {name}.
Start bulk enhance job {name} and notify {webhookurl} when it finishes.
GET /kg/v3/enhance/bulk/status List all bulk enhance jobs on my token · List Bulkjobs for Token #
Ask an LLM
“Which bulk enhance jobs have I submitted and what state are they in?”
“Can I see every enhance bulkjob on my account in one call?”
Tell an agent
List all my bulk enhance jobs and their statuses.
Show every enhance bulkjob running under my token.
GET /kg/v3/enhance/bulk/{bulkjobId}/status Check the status of one bulk enhance job · Poll bulkjob status #
Ask an LLM
“Is my bulk enhance job finished yet?”
“How can I poll the progress of a single enhance bulkjob by its ID?”
Tell an agent
Check the status of bulk enhance job {bulkjobId}.
Poll bulkjob {bulkjobId} until it reports complete.
GET /kg/v3/enhance/bulk/{bulkjobId} Download bulk enhance results via query string · Download Results of Bulkjob #
Ask an LLM
“How do I download the enriched records from a completed bulk enhance job?”
“Can I get only the records that matched from a bulk enhance result?”
Tell an agent
Download the results of bulk enhance job {bulkjobId}.
Fetch only matched records from bulkjob {bulkjobId} as {format}.
POST /kg/v3/enhance/bulk/{bulkjobId} Download bulk enhance results with a POST body · Download Results of Bulkjob #
Ask an LLM
“Can I send export options in a request body when downloading bulk enhance results?”
“Is there a POST way to pull a bulk enhance export with a long column spec?”
Tell an agent
Post an export request for bulkjob {bulkjobId} with column spec {exportspec}.
Using a POST body, download results {from} through {size} of bulkjob {bulkjobId}.
GET /kg/v3/enhance/bulk/report/{bulkjobId}/{reportId} Download a bulk enhance coverage report · Download Bulkjob Coverage Report #
Ask an LLM
“How do I see how many records in my bulk enhance job had coverage for each field?”
“Where can I download the coverage report for a finished bulk enhance?”
Tell an agent
Download coverage report {reportId} for bulk enhance job {bulkjobId}.
Get the field coverage report {reportId} of bulkjob {bulkjobId}.
GET /kg/v3/enhance/bulk/{bulkjobId}/delete Delete a bulk enhance job · Delete Bulkjob #
Ask an LLM
“Can I permanently remove an old bulk enhance job?”
“What is the way to delete a bulkjob I no longer need?”
Tell an agent destructive · confirm first
Delete bulk enhance job {bulkjobId}.
Remove bulkjob {bulkjobId} from my account.
GET /kg/v3/enhance/bulk/{bulkjobId}/{jobIdx} Get one record's result from a bulk enhance job · Download Single Result of Bulkjob #
Ask an LLM
“Can I fetch just one enriched record out of a bulk enhance job by its position?”
“How do I look up the result for a single input row in a bulkjob?”
Tell an agent
Get result number {jobIdx} from bulk enhance job {bulkjobId}.
Show the enriched record at index {jobIdx} of bulkjob {bulkjobId}.
GET /kg/v3/enhance/bulk/{bulkjobId}/stop Stop a running bulk enhance job · Stop Bulkjob #
Ask an LLM
“Can I halt a bulk enhance job that is still processing?”
“What stops an active enhance bulkjob before it finishes?”
Tell an agent destructive · confirm first
Stop bulk enhance job {bulkjobId}.
Halt the active bulkjob {bulkjobId} now.

Documentation

📖
Documentation
https://www.diffbot.com/docs/bulk/
📖
APIReference
https://www.diffbot.com/docs/bulk/create
📖
Documentation
https://www.diffbot.com/docs/dql/
📖
APIReference
https://www.diffbot.com/docs/dql/get
📖
Documentation
https://www.diffbot.com/docs/enhance/
📖
APIReference
https://www.diffbot.com/docs/enhance/get
📖
Documentation
https://www.diffbot.com/docs/web-search/
📖
APIReference
https://www.diffbot.com/docs/web-search/get
📖
Documentation
https://www.diffbot.com/docs/account
📖
APIReference
https://www.diffbot.com/docs/account

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/diffbot/refs/heads/main/openapi/diffbot-bulk-enhance-api-openapi.yml

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/diffbot:diffbot-bulk-enhance-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

diffbot-bulk-enhance-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: Bulk Enhance API
  description: Enhance is an API to find a person or organization in the Knowledge Graph using partial data
  termsOfService: https://www.diffbot.com/terms/
  contact:
    email: support@diffbot.com
  version: 3.0.0
servers:
- url: https://kg.diffbot.com
  description: Diffbot KG endpoint
tags:


# --- truncated at 32 KB (35 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/diffbot/refs/heads/main/openapi/diffbot-bulk-enhance-api-openapi.yml