Create a Bulkjob

POSThttps://kg.diffbot.com/kg/v3/enhance/bulk

Enhance multiple records in bulk asynchronously.

Accepts a JSON array of input data on organizations or persons and returns a status response.

An input JSON array is constructed with a type declaration and one or more accepted inputs for Enhance.

[{
    "type": "Organization",
    "name": "IBM",
    "location": "Austin, Texas"
},
{
    "type": "Organization",
    "name": "Diffbot",
    "url": "www.diffbot.com"
}]

You can also specify alternative name and url parameters for an entity. Those parameters can also be specified as an array. For example:

[{
    "type": "Organization",
    "name": ["Twitter", "X"],
    "url": ["twitter.com", "x.com"],
    "location": "San Francisco, CA"
}]

Example

REQUEST

curl --location --request POST 'https://kg.diffbot.com/kg/v3/enhance/bulk?token=<DIFFBOT_TOKEN>' \
  --header 'Content-Type: application/json' \
  --data-raw '[{
    "type": "Organization",
    "name": "Optimizely"
},
{
    "type": "Organization",
    "name": "Diffbot"
},
{
    "type": "Organization",
    "name": "Whizzimo"
}]'

RESPONSE

{
  "job_id": "abc123"
}