Combine

GEThttps://kg.diffbot.com/kg/v3/enhance/combine

Enrich a person record and return both person and current employer data.

Combine is part of the Enhance API. It enriches a person and returns both the matched person record and their current employer in a single call, accepting the same person-identifying parameters as Enhance. The size parameter is not supported for combine requests.

Example

REQUEST

curl --request GET \
  --url 'https://kg.diffbot.com/kg/v3/enhance/combine?token=<DIFFBOT_TOKEN>&type=Person&name=Mike%20Tung&employer=Diffbot&filter=%24.name%3B%24.type%3B%24.diffbotUri%3B%24.homepageUri' \
  --header 'Accept: application/json'

RESPONSE

{
  "version": 3,
  "hits": 2,
  "kgversion": "477",
  "request_ctx": {
    "query": {
      "type": "Person",
      "name": ["Mike Tung"],
      "employer": "Diffbot"
    },
    "query_ctx": {
      "search": "OFF"
    }
  },
  "data": [
    {
      "score": 0.997490554896945,
      "esscore": 126062.4296875,
      "entity": {
        "name": "Mike Tung",
        "diffbotUri": "http://diffbot.com/entity/ESGMaGV9uP0SuTmfPTtNEoA",
        "homepageUri": "miketung.com",
        "type": "Person"
      },
      "errors": [],
      "entity_ctx": {
        "inner_hits": {
          "employments": [0]
        }
      }
    },
    {
      "score": 1.0,
      "esscore": 1.0,
      "entity": {
        "name": "Diffbot",
        "diffbotUri": "http://diffbot.com/entity/EYX1i02YVPsuT7fPLUYgRhQ",
        "homepageUri": "diffbot.com",
        "type": "Organization"
      },
      "errors": []
    }
  ],
  "errors": []
}