Create a Bulkjob

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"
}]

Example Request

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

var headers = new Headers();
headers.append("Content-Type", "application/json");

var raw = JSON.stringify([
  {
    "type": "Organization",
    "name": "Optimizely"
  },
  {
    "type": "Organization",
    "name": "Diffbot"
  },
  {
    "type": "Organization",
    "name": "Whizzimo"
  }
]);

var requestOptions = {
  method: 'POST',
  headers: headers,
  body: raw
};

fetch("https://kg.diffbot.com/kg/v3/enhance_endpoint/bulk?token=YOURTOKEN", requestOptions)
  .then(response => response.text())
  .then(result => console.log(result))
  .catch(error => console.log('error', error));

import requests
import json

url = "https://kg.diffbot.com/kg/v3/enhance_endpoint/bulk?token=YOURTOKEN"

payload = json.dumps([
  {
    "type": "Organization",
    "name": "Optimizely"
  },
  {
    "type": "Organization",
    "name": "Diffbot"
  },
  {
    "type": "Organization",
    "name": "Whizzimo"
  }
])
headers = {
  'Content-Type': 'application/json'
}

response = requests.request("POST", url, headers=headers, data=payload)

print(response.text)

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"
}]