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

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