API Reference

Introduction to Enhance API

Enrich a person or organization with data from the public web.

The Enhance API takes an input of just a few identifiers about a person or organization and returns all the knowledge the public web has on that entity.

A simple Enhance call looking up an organization by name looks like this:

curl --request GET \
     --url 'https://kg.diffbot.com/kg/v3/enhance?token=YOURTOKEN&type=Organization&name=Diffbot' \
     --header 'Accept: application/json'

The response will include some metadata on the call, including a confidence score for a correct match, and the complete entity record.

{
  "version": 3,
  "hits": 1,
  "kgversion": "253",
  "request_ctx": {
    "query": {
      "type": "Organization",
      "name": "Diffbot"
    },
    "query_ctx": {
      "search": "OFF"
    }
  },
  "data": [
    {
      "score": 0.7844459192915973,
      "esscore": 25.871509552001953,
      "entity": {
        "twitterUri": "twitter.com/diffbot",
        "nbActiveEmployeeEdges": 39,
        "type": "Organization",
        "allNames": [
          "Diffbot",
          "DIFFBOT CORP.",
          "DIFFBOT TECHNOLOGIES CORP.",
          "DIFFBOT TECHNOLOGIES CORP",
          "Xplore Technologies Corp",
          "Diffbot Technologies Corp.",
          "DIFFBOT",
          "DIFFBOT CORP",
          "Diffbot Corp"
        ],
        ...
    }
 ]
}

Next Steps

Start enhancing right away with the Enhance API Reference.

Looking up a person with Enhance? You might like to use the Combine endpoint instead to return both data on the person and their current employer.

Need to enhance several hundred (or even thousands of) records? Try Bulk Enhance.