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:

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

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

json
{
  "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 Corp"
        ]
      }
    }
  ]
}

Endpoints ​

  • Enhance (GET) — look up a single person or organization with partial data via a GET request.
  • Enhance (POST) — the same enrichment as a POST request with a JSON body.
  • Bulk Enhance — match many records at once with an asynchronous job.
  • Combine — enrich a person and return both the person and their current employer.

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.