Source
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.
Read more about working with the sources layer here .
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 | Name[] | Array of names |
| emails | Email[] | Array of emails |
| usernames | Username[] | Array of usernames |
| phones | Phones[] | Array of phones |
| gender | Gender | A gender object |
| dob | DOB | A date of birth object |
| languages | Language[] | Array of languages |
| ethnicities | Ethinicity[] | Array of ethinicities |
| origin_countries | OriginCountry[] | Array of origin countries |
| addresses | Address[] | Array of addresses |
| jobs | Job[] | Array of jobs |
| educations | Educations[] | Array of educations |
| vehicles | Vehicle[] | Array of vehicles |
| relationships | Relationships[] | Array of relationships |
| user_ids | UserID[] | Array of user ids |
| images | Image[] | Array of images |
| urls | Url[] | Array of urls |
| tags | Tag[] | 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": [],
"vechicles": [],
"relationships": [],
"user_ids": [],
"images": [],
"tags": []
}