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 - coming soon	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": [],   //coming soon!
  "relationships": [],
  "user_ids": [],
  "images": [],
  "tags": []
}