A Source is all information on the person gathered from a single data source.
Source visibility
In order to get source objects in response, set the show_sources request parameter to “all” or “matching”.
If using show_sources="all", sources with a person_id are those sources used to build the response person.
Metadata
Attribute | Type | Description |
|---|---|---|
@id | String | Unique identifier of this source in our systems. Useful for debugging. |
@name | String | Data Source name |
@category | String | Data Source category |
@domain | String | Data Source domain |
@person_id | GUID | The id of the person this source belongs to. |
@sponsored | Boolean | Indicating whether additional data from this source is available behind a website paywall. Omitted if false. |
@origin_url | String | The url of the web page holding this information. Only shown if the data is available online. |
@match | Float | 0-1. The match score of the person this source belongs to. |
@premium | Boolean | Whether this is a premium data source. Omitted if false. |
Source Categories
Sources are categorized into nine categories.
Category | Examples |
|---|---|
personal_profiles | facebook.com, pinterest.com, last.fm |
media | picasa.com, flickr.com, youtube.com |
professional_and_business | linkedin.com, spoke.com, zoominfo.com |
public_records | bop.gov, archives.com, ancestry.com |
publications | uspto.gov, portal.acm.org, scirus.com |
school_and_classmates | classmates.com, reunion.com, schoolbank.nl |
email_address | intelius.com, spokeo.com |
background_reports | peoplefinders.com intelius.com peoplesmart.com |
contact_details | whitepages.com, addresses.com, anywho.com |
web_pages | Default category for sources that don’t match any of the above categories. |
Data
Member | Type | Description |
|---|---|---|
names | Array of names | |
emails | Array of emails | |
usernames | Array of usernames | |
phones | Array of phones | |
gender | A gender object | |
dob | A date of birth object | |
languages | Array of languages | |
ethnicities | Array of ethinicities | |
origin_countries | Array of origin countries | |
addresses | Array of addresses | |
jobs | Array of jobs | |
educations | Array of educations | |
relationships | Array of relationships | |
user_ids | Array of user ids | |
images | Array of images | |
urls | Array of urls | |
tags | Array of tags |
Example Source Object
{
"@id": "string",
"@name": "string",
"@category": "string",
"@domain": "string",
"@person_id": "GUID",
"@sponsored": false,
"@origin_url": "string",
"@match": float,
"names": [],
"emails": [],
"usernames": [],
"phones": [],
"gender": {},
"dob": {},
"languages": [],
"ethnicities": [],
"origin_countries": [],
"addresses": [],
"jobs": [],
"educations": [],
"relationships": [],
"user_ids": [],
"images": [],
"tags": []
}