v1

latestOpenAPI 3.0.02026-07-263039205.4 KB
Combine
Enhance

Combine

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

get/kg/v3/enhance/combine

Query parameters

type'Person' enum

Diffbot entity type

namestring[]

Name of the entity to enhance. Parameter can be used with types Person and Organization

urlstring[]

Origin or homepage URI of entity to enhance. Parameter can be used with types Person and Organization

phonestring

Phone of the entity to enhance. Parameter can be used with types Person and Organization

emailstring

Email of the entity to enhance. Parameter can be used only with type Person

employerstring

Employer of the entity to enhance. Parameter can be used only with type Person

titlestring

Title of the entity to enhance. Parameter can be used only with type Person

schoolstring

School of the entity to enhance. Parameter can be used only with type Person

locationstring

Location of the entity to enhance. Parameter can be used with types Person and Organization

ipstring

IP address of the entity to enhance. Parameter can be used with types Person and Organization

customIdstring

User defined ID for correlation

thresholdnumber double

Enhance similarity threshold

refreshboolean

refresh=true indicates that Diffbot will attempt to recrawl all the origins of the identified entity and reconstruct the returned entity from this refreshed data.

searchboolean

search=true indicates that Diffbot will attempt to search the web for origins for the search query and merge relevant results with whats found in the KG.

nonCanonicalFactsboolean

nonCanonicalFacts=true returns non-canonical facts.

jsonmode' ' | 'extended'

jsonmode=extended returns origin information for facts.

filterstring

Semi-colon separated path filter to filter response json. You can use a simple dot notation skills.name or a JsonPath expression such as such as $.name;$.locations.country.name. For more advanced options, see JsonPath Filtering for syntax.

filterExcludestring

Semi-colon separated path filter to filter and exclude data from response json. You can use a simple dot notation skills.name or a JsonPath expression such as such as $.name;$.locations.country.name. For more advanced options, see JsonPath Filtering for syntax.

Response

Enhanced entity

versioninteger

Response version

hitsinteger

Number of matches returned

kgversionstring

Version of KG that was queried

errorsstring[]
searchInfoobject

Search info for debug