Log In

Person Insights Bundles

Person Insights Bundles are a feature within Enrich that enable you to customize the Person Enrichment response, further enriching a contact with data such as online identifiers, Employment History, and more provided we have a match to that individual.

A "match" can be defined in various ways across industries so we’re here to help breakdown our logic for a more meaningful match.

A match starts with the notion of an identity - do we know enough about an individual with a high enough confidence to build a more robust picture? If so, we can match to a persistent FullContact Person ID (PID). Once that happens, FullContact has the capability to share more about an individual within each Enrichment Insights Bundle. From here, we match to and enrich with more information about an individual to help propel your business initiatives and further your relationship.

To configure the Insights Bundles for your plan, visit the Plan & Billing section within the FullContact Platform. From here you can see and manage the Insights Bundles that are enabled for your account, along with the associated cost for each. Customers with custom plans will need to contact their sales representative to have Insights Bundles configured for their account.

Below are a list of the currently available Insights Bundles, along with example objects that would be returned in a response. Insights Bundles available will be returned as a key inside of the details property of a Person Summary object.

Individual Plus

The Individual Plus Insights Bundle contains the entire suite of information for a profile, including age, gender, known locations, household composition, financial characteristics, purchase and shopping habits, along with known hashed emails for the profile. This Insights Bundles will be returned in the demographics, locations, households, finances, shopping habits, purchases, education and email hash keys in the details object of a Person Summary object. This pack is a combination of the Individual, Demographic, Locations, Finances, Household, Email Hash, Lifestyle, Purchases and Shopping Habits Insights Bundles.

Individual

The Individual Insights Bundle contains a range of information for a profile, including age, gender and name details, along with any known locations for the profile. This Insights Bundle will be returned in the name, age, gender, locations and education keys in the details object of a Person Summary object.

{
"details": {
"name": {
"given": "Angus",
"family": "de Vaca",
"full": "Angus de Vaca"
},
"age": {
"range": "25-34",
"value": 27
},
"gender": "Male",
"demographics": {
"gender": "Male",
"age": {
"range": "35-44",
"value": 40
}
},
"emails": [],
"phones": [],
"profiles": {
"twitter": {
"url": "https://twitter.com/hspangus",
"service": "twitter"
},
"linkedin": {
"url": "https://www.linkedin.com/in/hspangus",
"bio": "Connect with me on LinkedIn",
"service": "linkedin"
}
},
"locations": [
{
"city": "Denver",
"region": "Colorado",
"regionCode": "CO",
"country": "United States",
"formatted": "Denver, Colorado, United States"
}
],
"employment": [
{
"name": "Self-employed",
"current": true,
"title": "Independent Consultant"
}
],
"photos": [
{
"label": "Avatar",
"value": "https://img.fullcontact.com/static/b3d621eec2c09cafb35e3575b4946719_95fa934eff5e1713d8ce53e2301d3f3ac304570a34418c443d3e9ef69f1a1d7e"
}
],
"education": [
{
"name": "CSU",
"degree": "PhD, Marketing and Communications",
"end": {
"year": 2001,
"month": 5,
"day": 25
}
}
],
"urls": [
{
"value": "https://angusdeva.ca/blog"
}
],
"interests": []
},
}

Properties
name.given string The given name (first name) of the individual.
name.family string The family name (last name) of the individual.
name.full.name string The full name (first and last) of the individual.
age.range string An age range of the individual.
age.value integer The age in years of the individual.
age.birthday string The date of birth of the individual.
gender string The gender of the individual.
demographics.age.range string An age range of the individual.
demographics.age.range.value integer The age in years of the individual.
emails object Object representing additional known email addresses.
phones object Object representing additional known phone numbers.
profiles.{platform}.url string URL to the profile on the social platform.
profiles.{platform}.bio string Bio of the profile from the social platform.
profiles.{platform}.service string Name of the social platform.
locations[n].city string The "city" portion of the location address.
locations[n].region string The region portion of the location address, typically a state or province.
locations[n].regionCode string An abbreviated or code-based representation of the region.
locations[n].country string The country portion of the location address.
locations[n].formatted string The formatted address.
employment.name string The name of the organization/place of employment.
employment.current boolean Indicator of whether or not this is the current place of employment.
employment.title string Job or position title.
photos[n].label string The type of photo.
photos[n].value string The URL to the photo.
education[n].name string The name of the school/university attended.
education[n].degree string The degree or focus of study.
education[n].end.year object Object representing the last year, month and day attended.
urls[n].value string The URL of the website.
interests object Object representing known interests of the profile.

Automotive

The Automotive Insights Bundle contains information about the vehicle(s) (up to three (3)) an individual/household owns such as, make, model, body style and purchase date. This Insights Bundle will be returned within the automotive key in the details object of a Person Summary object.

"automotive": {
"ownership": {
"numVehicles": "3",
"vehicles": [ {
"bodyStyle": "car",
"fuelType": "hybrid engine",
"make": "gmc",
"model": "outlook",
"purchaseDate": "201011",
"purchaseType": "used",
"year": "2010"
},{
"bodyStyle": "truck",
"fuelType": "diesel",
"make": "ford",
"model": "f150",
"purchaseDate": "201807",
"purchaseType": "new",
"year": "2018"
},{
"bodyStyle": "van",
"fuelType": "gasoline",
"make": "honda",
"model": "odyssey",
"purchaseDate": "201303",
"purchaseType": "unknown",
"year": "2013"
},
],
},
}

Properties: details.automotive.ownership
number.vehicles string The number of vehicles an individual/household owns up to 3 vehicles total.
vehicles.body.style string The body style specific to the car an individual/household owns and could be a SUV, Car, Truck or Van.
vehicles.fuel.type string The type of fuel a car typically uses such as, Compressed Natural Gas, Diesel, Electric/Lithium-Ion Battery, Flexible Fuel, Gasoline, Hybrid Engine or Unknown.
vehicle.make string The make of the car an individual/household owns.
vehicle.model string The model of the car an individual/household owns.
vehicle.purchase.date integer The year and month the individual/household purchased the vehicle.
vehicle.purchase.type string The type of purchase of the owned vehicle whether it was a new or used purchase.
vehicle.year integer The year the vehicle was manufactured.

Demographic

The Demographic Insights Bundle contains a range of information for a profile, including age, gender, name, location and income estimate details. This Insights Bundles will be returned in the name, age, gender, household, finance, census, profiles, locations, employment, photos, education, interests and demographics keys in the details object of a Person Summary object.

{
"details": {
"name": {
"given": "Angus",
"family": "de Vaca",
"full": "Angus de Vaca"
},
"age": {
"range": "25-34",
"value": 27
},
"gender": "Male",
"household": {
"homeInfo": {
"homeValueEstimate": 27,
"loanToValueEstimate": 27
},
"presence": {
"children": "PROBABLE"
},
"finance": {
"cashValueBalanceHouseholdEstimate": "Less than $5,000",
"discretionaryIncomeEstimate": 27,
"financialDebtRangeEstimate": "$0",
"householdIncomeEstimate": "Less than $15,000",
"netWorthRange": "$0 or Less"
}
},
"demographics": {
"gender": "Male",
"age": {
"range": "25-34",
"value": 27
},
"maritalStatus": "MARRIED",
"occupation": "Business Owner - Accountant"
},
"finance": {
"bankCard": "Single Bank Card",
"bankruptcy": true,
"activeLineOfCredit": true,
"retailCard": "Single Retail Card"
},
"census": {
"year2010": {
"percent": {
"homeowner": 27
}
}
},
"emails": [],
"phones": [],
"profiles": {
"twitter": {
"url": "https://twitter.com/hspangus",
"service": "twitter"
},
"linkedin": {
"url": "https://www.linkedin.com/in/hspangus",
"bio": "Connect with me on LinkedIn",
"service": "linkedin"
}
},
"locations": [
{
"city": "Denver",
"region": "Colorado",
"regionCode": "CO",
"country": "United States",
"formatted": "Denver, Colorado, United States"
}
],
"employment": [
{
"name": "Self-employed",
"current": true,
"title": "Independent Consultant"
}
],
"photos": [
{
"label": "Avatar",
"value": "https://img.fullcontact.com/static/b3d621eec2c09cafb35e3575b4946719_95fa934eff5e1713d8ce53e2301d3f3ac304570a34418c443d3e9ef69f1a1d7e"
}
],
"education": [
{
"name": "CSU",
"degree": "PhD, Marketing and Communications",
"end": {
"year": 2001,
"month": 5,
"day": 25
}
}
],
"urls": [
{
"value": "https://angusdeva.ca/blog"
}
],
"interests": []
},
}

Properties
full.name string The full name (first and last) of the individual.
gender string The gender of the individual.
details.name.given string The given name (first name) of the individual.
details.name.family string The family name (last name) of the individual.
details.age.range string An age range of the individual.
details.age.value integer The age in years of the individual.
details.gender string The gender of the individual.
Properties: details.household
home.info.home.value.estimate integer The estimated value of an individual's home.
home.info.loan.to.value.estimate integer The loan-to-value estimate of an individual's home.
presence.children string The likelihood of a household with a presence of children.
Properties: details.household.finance
cash.value.balance.household.estimate string The estimate of the cash value balance of a household.
discretionary.income.estimate integer The estimate of a household's discretionary income.
financial.debt.range.estimate string An estimate of the range of debt of a household.
household.income.estimate string An estimate of a household's total income.
net.worth.range string The estimated net worth of a household.
<>
Properties: details.demographics
gender string The gender of the individual.
age.range string An age range of the individual.
age.range.value integer The age in years of the individual.
marital.status string The marital status of an individual.
occupation string The occupation of an individual.
Properties: details.finance
bank.card string An indication if an individual holds one or more bank cards.
bankruptcy string An indicator of whether or not an individual has experienced bankruptcy.
active.line.of.credit string An indicator of whether or not an individual has an active line of credit.
retail.card string An indicator if an individual holds one or more retail cards.
census.year.2010.percent.homeowner integer An indicator of the percentage of individuals who own a home.
Properties
census.year.2010.percent.homeowner integer An indicator of the percentage of individuals who own a home.
emails object Object representing additional known email addresses.
phones object Object representing additional known phone numbers.
profiles.{platform}.url string URL to the profile on the social platform.
profiles.{platform}.bio string Bio of the profile form the social platform.
profiles.{platform}.service string Name of the social platform.
locations[n].city string The "city" portion of the location address.
locations[n].region string The region portion of the location address, typically a state or province.
locations[n].regionCode string An abbreviated or code-based representation of the region.
locations[n].country string The country portion of the location address.
locations[n].formatted string The formatted address.
employment.name string The name of the organization/place of employment.
employment.current boolean Indicator of whether or not this is the current place of employment.
employment.title string Job or position title.
photos[n].label string The type of photo.
photos[n].value string The URL to the photo.
education[n].name string The name of the school/university attended.
education[n].degree string The degree or focus of study.
education[n].end.year object Object representing the last year, month and day attended.
urls[n].value string The URL of the website.
interests object Object representing known interests of the profile.

Email Hash

The Email Hash Insights Bundle will return hashed versions of known email addresses associated with the profile. The returned hashed email addresses, available in both MD5 and SHA-256 variations, can then be used to help link our profiles with your data. This Insights Bundle will be returned within the emails key in the details object of a Person Summary object.

"emails": [
{
"label": "provided",
"value": "bob@bobtests.com"
},
{
"label": "hash",
"md5": "0e75c688a5e3cb2a3027ae4d5a90af8b"
},
{
"label": "hash",
"sha256": "f4a73f4a5b069fed3e8ff8f7d9784e012db1fd5d63cfd3ad5582c86588defcd3"
},
...
]

Properties
label string An indicator of the source or type of email. If provided in the Person request, the value will be provided, otherwise, hash.
value string Used only when email address has been provided and is being returned.
md5 string The MD5 hash representation for a given email address.
sha256 string The SHA-256 hash representation for a given email address.

Employment History

The Employment History Insights Bundle returns current and historical employment history for a given contact. This data includes the organization and title during employment and approximate start and end dates. This Insights Bundle will be returned within the employment key in the details object of a Person Summary object.

"employment": [
{
"name": "ACME, Inc",
"domain": "acme.com",
"current": false,
"title": "Widget Maker",
"start": {
"year": 2010,
"month": 6,
"day": 1
},
"end": {
"year": 2015,
"month": 10,
"day": 15
}
},
...
]

Properties
name string The name of the organization/place of employment.
domain string The website domain of the place of employment.
current boolean Indicator of whether or not this is the current place of employment.
title string Job or position title.
start object Object representing start date, with properties for year, month and day returned as integers.
end object Object representing end date, with properties for year, month and day returned as integers.

Finances

The Finances Insights Bundle will return insights into an individual’s financial status. Gain insights about their income, debt levels, active credit lines, investments and more. This Insights Bundle is a premium option and will be returned within the finances key in the details object of a Person Summary object.

{
"details": {
"household": {
"homeInfo": {
"homeValueEstimate": 27,
"loanToValueEstimate": 27
},
"finance": {
"cashValueBalanceHouseholdEstimate": "Less than $5,000",
"discretionaryIncomeEstimate": 27,
"financialDebtRangeEstimate": "$0",
"householdIncomeEstimate": "Less than $15,000",
"netWorthRange": "$0 or Less"
}
},
"finance": {
"bankCard": "Single Bank Card",
"bankruptcy": true,
"activeLineOfCredit": true,
"retailCard": "Single Retail Card"
},
"census": {
"year2010": {
"percent": {
"homeowner": 27
}
}
}
}
}

Properties: details.household.home.info
home.value.estimate integer An indicator of the estimated percentage of the mortgage amount borrowed to the appraised home value.
loan.to.value.estimate integer An indicator of the estimated assessed value of an individual's property.
Properties: details.household.finance
cash.value.balance.household.estimate string The estimated value range of the cash value balance of a household.
discretionary.income.estimate integer An estimated household discretionary income percentage indicator based on the estimated annual income.
financial.debt.range.estimate string The estimated value range of the financial debt of a household.
household.income.estimate string The estimated value range of the total annual income of a household.
net.worth.range string The estimated value range of a household’s net worth.
Properties: details.finance
bank.card string An indicator if an individual has a single or multiple bank cards.
bankruptcy boolean An indicator of whether or not an individual has undergone bankruptcy.
active.line.of.credit boolean An indicator of whether or not an individual has an active line of credit.
retail.card string An indicator if an individual has a single or multiple retail cards.
Properties: details.census.year2010
percent.homeowner integer An indicator of the percentage of the geographic area where an individual owns a home.

Household

The Household Insights Bundle will return details about an individual’s household composition, value, home type, homeowner status and other individuals and pets that reside in the household. This Insights Bundle is a premium option and will be returned within the household, demographics and survey keys in the details object of a Person Summary object.

{
"details": {
"household": {
"familyInfo": {
"totalAdults": 27,
"totalChildren": 27,
"totalPeopleInHousehold": 27
},
"homeInfo": {
"dwellingType": "Multi Family Dwelling/Apartment",
"yearsInHome": 27
},
"locationInfo": {
"seasonalAddress": true
},
"presence": {
"multigenerationalResident": "PRESENT"
}
},
"demographics": {
"livingStatus": "Probable Homeowner"
},
"survey": {
"own": {
"ownCat": true,
"ownDog": true
}
}
}
}

Properties: details.household
family.info.total.adults integer The total number of adults 18 years and older that reside in the household.
family.info.total.children integer The total number of individuals under the age of 18 that reside in the household.
family.info.total.people.in.household integer The total number of individuals that reside in the household.
home.info.dwelling.type string An indicator of the type of dwelling.
home.info.years.in.home integer The number of years an individual has lived in the current household.
location.info.seasonal.address boolean Indicator of whether or not this residence is a seasonal address.
presence.multigenerational.resident string Indicator of whether or not there is a presence of an elderly parent in the household.
Properties: details.demographics
living.status string An indicator of whether or not an individual owns a home or renting a dwelling unit.
Properties: details.survey.own
own.cat boolean Indicator of whether or not this individual owns a cat.
own.dog boolean Indicator of whether or not this individual owns a dog.

Interests - New

The Interests Insights Bundle enables API consumers to better understand the interests of a contact. The data returned includes a list of interests that have been attributed to the contact, along with the level of interest (low, medium or high). This Insights Bundle will be returned within the interests key in the details object of a Person Summary object.

Download our Interest data taxonomy here with the category, affinity name and propensity.

"interests": [
{
"name": "Auto and Truck Parts",
"id": "FCA0224",
"affinity": "LOW",
"parentIds": [
"FCA2040"
],
"category": "Auto Parts"
},
...
]

Properties
name string The name of the topic of interest.
id string The ID of the topic of interest. This can be used to identify parent->child relationships in topics.
affinity string The level of affinity between the contact and this topic. Values are HIGH, MED, or LOW.
parentIds array The Parent ID of the topic of interest.
category string The category of this topic of interest.

Lifestyle

The Lifestyle Insights Bundle enables API consumers to better understand the activities and behavioral interests of a contact. The data returned includes a list of lifestyle interests that have been attributed to the contact. This Insights Bundle will be returned within the survey key in the details object of a Person Summary object.

{
"details": {
"survey": {
"own": {
"ownDigitalCamera": true,
"ownHorse": true,
"ownMotorcycle": true,
"ownSwimmingPool": true,
"ownAtv": true,
"ownRv": true
},
"collectibles": {
"general": true,
"coins": true,
"dolls": true,
"figurines": true,
"other": true,
"plates": true,
"sportsMemorabilia": true,
"stamps": true,
"fineArts": true
},
"creditCards": {
"premium": {
"amex": true,
"discover": true,
"other": true,
"store": true,
"visaOrMasterCard": true
},
"regular": {
"amex": true,
"discover": true,
"other": true,
"store": true,
"visaOrMasterCard": true
},
"debit": true
},
"dietConcerns": {
"general": true,
"loseWeight": true,
"eatNatural": true,
"vitaminSupplements": true,
"healthy": true
},
"grandchildren": true,
"hobby": {
"general": true,
"baking": true,
"birdWatching": true,
"cars": true,
"cigarSmoking": true,
"gourmetCooking": true,
"cooking": true,
"crafts": true,
"casinoGambling": true,
"gardening": {
"general": true,
"flowers": true,
"organic": true,
"vegetables": true
},
"homeImprovement": true,
"homeStudyCourses": true,
"knitting": true,
"lotteries": true,
"quilting": true,
"selfImprovementCourses": true,
"sewing": true,
"theater": true,
"woodworking": true,
"wineAppreciation": true,
"photography": true,
"exercise3xPerWeek": true,
"scrapBooking": true,
"lowFatCooking": true,
"careerAdvancementCourses": true,
"jewelryMaking": true,
"diy": true,
"green": true,
"socialNetworking": true,
"spirituality": true
},
"onlinePurchaser": true,
"investments": true,
"music": {
"general": true,
"christianOrGospel": true,
"classical": true,
"country": true,
"jazz": true,
"other": true,
"rhythmAndBlues": true,
"rock": true,
"softRock": true,
"swing": true,
"alternative": true
},
"reading": {
"likesToRead": true,
"astrology": true,
"bibleOrDevotional": true,
"bestSellingFiction": true,
"audiobooks": true,
"childrens": true,
"cooking": true,
"computer": true,
"countryLifestyle": true,
"fashion": true,
"history": true,
"interiorDecorating": true,
"health": true,
"military": true,
"mystery": true,
"naturalHealthRemedies": true,
"entertainment": true,
"romance": true,
"scienceFiction": true,
"technology": true,
"sports": true,
"worldNewsOrPolitics": true,
"suspense": true,
"bestSellers": true,
"bookClub": true,
"comics": true,
"financial": true,
"homeAndGarden": true,
"selfImprovement": true,
"travel": true,
"magazines": true
},
"sporting": {
"other": true,
"campingOrHiking": true,
"baseball": true,
"boating": true,
"basketball": true,
"fishing": true,
"americanFootball": true,
"fitness": true,
"golf": true,
"hockey": true,
"hunting": true,
"nascar": true,
"snowSkiing": true,
"walking": true,
"running": true,
"scuba": true,
"tennis": true,
"weightLifting": true,
"biking": true,
"extremeSports": true,
"motocross": true,
"skateboarding": true,
"snowboarding": true,
"rollerblading": true,
"interests": true
},
"travel": {
"general": true,
"usBusiness": true,
"internationalBusiness": true,
"usPersonal": true,
"internationalPersonal": true,
"casinoVacations": true,
"familyVacations": true,
"frequentFlyer": true,
"timeshare": true,
"vacationCruises": true,
"attractionsOrThemeParks": true,
"rv": true
},
"religious": true,
"electronics": {
"appleDevice": true,
"cableTv": true,
"highSpeedInternet": true,
"dvr": true,
"dvdPlayer": true,
"hdtv": true,
"homeTheater": true,
"satelliteRadio": true,
"satelliteTv": true,
"videoGameSystems": true,
"other": true
},
"purchase": {
"homeDecorating": true,
"beautyProducts": true,
"clubStores": true,
"fastFoods": true,
"specialtyBeautyProducts": true,
"usesCoupons": true
}
}
}
}

Properties: details.survey
own object Object representing indicators of whether or not an individual owns a camera, horse, motorcycle, pool, ATV or RV.
collectibles object Object representing indicators of whether or not an individaul is collector of coins, dolls, figurines, plates, sports memorbilia, stamps, fine arts or other categories.
credit.cards.premium object Object representing indicators of whether or not an individual has a credit card that is considered of premium status.
credit.cards.regular object Object representing indicators of whether or not an individual has a credit card that is considered of standard status.
credit.cards.debit boolean An indicator of whether or not an individual has a debit card.
diet.concerns object Object representing indicators of whether or not an individual has diet concerns about losing weight, eating naturally, taking vitamin supplements, staying healthy or general diet concerns.
grandchildren boolean An indicator of whether or not an individual has grandchildren.
hobby object Object representing indicators of whether or not an individual participates in hobbies such as, baking, bird watching, cars, cigars, cooking, crafts, gambling, gardening, home improvement, home studying, knitting, quilting, sewing, theater, wine appreciation, wood working, photography, exercising, jewelry, DIY home projects and/or green initiatives.
online.purchaser boolean An indicator of whether or not an individual makes purchases online.
investments boolean An indicator of whether or not an individual has made investments.
music object Object representing indicators of whether or not an individual enjoys music of the following genres: Gospel, Classical, Country, Jazz, Blues, Rock, Soft Rock, Swing, Alternative and/or Other/General.
reading object Object representing indicators of whether or not an individual likes to read or reads any of the following genres: astrology, devotional, fiction, audio books, children, cooking, computers, country lifestyle, fashion, history, interior decorating, health, military, mystery, natural health remedies, entertainment, romance, SciFi, tech, sports, politics, suspense, best sellers, comics, finance, home & garden, self-improvement, travel and/or magazines.
sporting object Object representing indicators of whether or not an individual enjoys any of the following sporting activities: camping, hiking, baseball, boating, basketball, fishing, football, fitness, golf, hockey, hunting, nascar, skiing, walking, running, scuba diving, tennis, weight lifting, biking, extreme sports, motocross, skateboarding, snowboarding, rollerblading or has a general interest in sports.
travel object Object representing indicators of whether or not an individual likes to travel for any of the following types: business, international business, personal, international personal trips, casinos, family vacations, is a frequent flyer, has a timeshare, cruises and/or amusement parks.
religious boolean An indicator of whether or not an individual has identified as being religious.
electronics object Object representing indicators of whether or not an individual enjoys electronics such as, Apple devices, cable TV, high speed internet, DVR, DVDs, HDTV, home theaters, satellite radio/TV, video games or other electronics.
purchase object Object representing indicators of whether or not an individual enjoys purchasing any of the following: home decoration, beauty, from larger big box stores, fast food restaurants, specialty beauty products and/or uses coupons when transacting.

Location

The Location Insights Bundle contains a range of geographic indicators for a profile, including carrier route, market areas and household location details. This Insights Bundle will be returned in the household and census keys in the details object of a Person Summary object.

{
"details": {
"household": {
"locationInfo": {
"carrierRoute": "B - PO Box",
"designatedMarketArea": "0500 - Portland-Auburn",
"coreBasedStatisticalArea": "10100 - Aberdeen, SD Micropolitan Statistical Area",
"nielsenCountySize": "A - All counties in the largest metropolitan areas which together account for 40% of U.S. households according to the 2000 Census.",
"congressionalDistrict": 53,
"numericCountyCode": 27
}
},
"census": {
"basicTractNumber": 27,
"basicBlockGroup": 27,
"year2010": {
"educationLevel": "Less than 9th grade",
"average": {
"numberOfCarsInHousehold": 2.7
},
"percent": {
"abovePovertyLevel": 27,
"belowPovertyLevel": 27,
"blueCollarEmployed": 27,
"divorcedOrSeparated": 27,
"homesBuiltSince2000": 27,
"homeowner": 27,
"householdsWithChildren": 27,
"married": 27,
"mobileHome": 27,
"movedToAreaSince2000": 27,
"salariedProfessional": 27,
"singleFamilyHome": 27,
"vehicleOwnership": 27
},
"median": {
"ageOfHouseholder": 27,
"effectiveBuyingIncome": 27,
"homeValue": 27,
"householdIncome": 27,
"householdIncomeByState": 27
},
"populationDensity": {
"centileInState": 27,
"centileInUs": 27
},
"socioEconomicScore": 27
}
}
}
}

Properties: details.household.location.info
carrier.route string The designated carrier route for an individual's household.
designated.market.area string The market area that an individual resides.
core.based.statistical.area string The core based statistical locaiton of where an individual resides.
nielsen.county.size string The county size code and description for an individual.
congressional.district string The congressional district where an individual resides.
numeric.county.code integer The county code of where an individual lives.
Properties: details.census
basic.tract.number integer An indicator of the census tract group of an individual.
basic.block.group integer An indicator of the block group that an individual resides.
year.2010.education.level string The highest level of education an individaul has completed.
year.2010.average.number.of.cars.in.household string The average number of cars an individual has within a household.
Properties: details.census.percent
above.poverty.level integer An indicator of the percentage of individuals above poverty level.
below.poverty.level integer An indicator of the percentage of individuals below poverty level.
blue.collar.employed integer An indicator of the percentage of individuals who are employed in a blue collar industry.
divorced.or.separated integer An indicator of the percentage of individuals who are divorced or separated.
homes.built.since.2000 integer An indicator of the percentage of homes and/or structures built since 2000.
homeowner integer An indicator of the percentage of individuals who own a house.
household.with.children integer An indicator of the percentage of households who have children present.
married integer An indicator of the percentage of married individuals.
mobile.home integer An indicator of the percentage of individuals who are living in a mobile home.
moved.to.area.since.2000 integer An indicator of the percentage of households that moved into a new geographcial area 2000 and later.
salaried.professional integer An indicator of the percentage of individuals who are employed and earning an annual salary.
single.family.home integer An indicator of the percentage of individuals who are living in a single family home dwelling type.
vehicle.ownership integer An indicator of the percentage of individuals who own a vehicle.
Properties: details.census.median
age.of.householder integer The median age of individuals who own a home 18 years and older.
effective.buying.income integer The median disposable household income of individuals.
home.value integer The median home value of all individuals across the US.
household.income integer The median household income of all individuals across the US.
household.income.by.state integer The median household income of all individuals across the US by state.
Properties: details.census.population.density
centile.in.state integer An indicator of the state population density by block group with a value of 1 signifying most dense.
centile.in.us integer An indicator of the US population density by block group with a value of 1 signifying most dense.
Properties: details.census
socioeconomic.score integer An indicator of how a block group compares in terms of socioeconomic status against the US baseline.

Mobile Advertising IDs (MAIDs)

The Mobile Advertising IDs (MAIDs) Insights Bundle allows you to connect your customers’ online/mobile contact elements and combines them with offline identity information. This Insights Bundle will be returned in the identifiers key in the details object of the Person Summary object.

"identifiers": {
"maids": [{
"id": "ape2ch30-pifn-cbvi-30yy-nia-zex7aw5u",
"type": "aaid"
}]
}

Properties: details.identifiers.maids
id string The mobile advertising id of the individual.
type string The MAID type (e.g. IDFA or AAID).

Professional

The Professional Insights Bundle returns current professional contact details. This data will include the company address for the current place of employment, professional email address, business phone and additional industry details associated to the profile. This Insights Bundle will be returned in the employment, emails and phones keys in the details object of a Person Summary object.

"emails": [
{
"label": "work",
"value": "trevor@zeroconfusion.net"
}
],
"phones": [
{
"label": "work",
"value": "+16783335367"
}
],
"employment": [
{
"name": "Zero Confusion, LLC",
"domain": "zeroconfusion.net",
"current": true,
"title": "Chief Executive Officer",
"start": {
"year": 2010,
"month": 6,
"day": 1
},
"locations": [
{
"city": "Denver",
"region": "Colorado",
"regionCode": "CO",
"formatted": "Denver, Colorado, United States"
}
]
}
]

Properties: details.email
label string The classification of the email.
value string The professional email address of an individual.

Properties: details.phone
details.phones[n].label string The classification of the phone.
details.phones[n].value string A phone number associated with the individual's company.

Properties: details.employment
name string The name of the organization/place of current employment.
domain string The website domain of the current place of employment.
current boolean Indicator of whether or not this is the current place of employment.
title string Job or position title.
start object Object representing start date, with properties for year, month and day returned as integers.
end object Object representing end date, with properties for year, month and day returned as integers.
locations[n].city string The "city" portion of the location address.
locations[n].region string The region portion of the location address, typically a state or province.
locations[n].regionCode string An abbreviated or code-based representation of the region.
locations[n].country string The country portion of the location address.
locations[n].formatted string The formatted address.

Purchases

The Purchases Insights Bundle will furnish you with all the information regarding what your customers are buying and how much they are spending on it across dozens of major categories. This Insights Bundle is a premium option and will be returned within the buyer key in the details object of a Person Summary object.

{
"details": {
"buyer": {
"catalog": {
"apparel": {
"general": true,
"children": true,
"men": true,
"mensBigTall": true,
"nonGenderSpecific": true,
"teenagers": true,
"women": true,
"womenPetiteSize": true,
"womenPlusSize": true
},
"artsAntiques": true,
"automotive": true,
"beauty": true,
"books": true,
"childrenProducts": true,
"collectibles": true,
"homeOffice": true,
"crafts": true,
"electronics": true,
"foodBeverages": true,
"furniture": true,
"garden": true,
"generalMerchandise": true,
"gift": true,
"health": true,
"holiday": true,
"homeCare": true,
"homeFurnishings": true,
"housewares": true,
"jewelry": true,
"linens": true,
"music": true,
"novelty": true,
"otherMerchServices": true,
"personalCare": true,
"pets": true,
"photoVideoEquipment": true,
"specialtyFood": true,
"specialtyGifts": true,
"sportsLeisure": true,
"stationery": true,
"travel": true,
"videoEntertainment": true,
"spendingPatterns": "sporadic spending"
},
"retail": {
"apparel": {
"general": true,
"children": true,
"men": true,
"mensBigTall": true,
"nonGenderSpecific": true,
"teenagers": true,
"women": true,
"womenPetiteSize": true,
"womenPlusSize": true
},
"artsAntiques": true,
"automotive": true,
"beauty": true,
"books": true,
"childrenProducts": true,
"collectibles": true,
"homeOffice": true,
"crafts": true,
"electronics": true,
"foodBeverages": true,
"furniture": true,
"garden": true,
"generalMerchandise": true,
"gift": true,
"health": true,
"holiday": true,
"homeCare": true,
"homeFurnishings": true,
"housewares": true,
"jewelry": true,
"linens": true,
"music": true,
"novelty": true,
"otherMerchServices": true,
"personalCare": true,
"pets": true,
"photoVideoEquipment": true,
"specialtyFood": true,
"specialtyGifts": true,
"sportsLeisure": true,
"stationery": true,
"travel": true,
"videoEntertainment": true
}
}
}
}

Properties
buyer.catalog.apparel object Object representing indicators of an individual’s catalog purchasing behavior across major apparel categories.
buyer.catalog object Object representing indicators of an individual’s catalog purchasing behavior across over a dozen major categories.
buyer.retail.apparel object Object representing indicators of an individual’s retail purchasing behavior across major apparel categories.
buyer.retail object Object representing indicators of an individual’s retail purchasing behavior across over a dozen major categories.

Resolve

The Resolve Insights Bundle takes customer contact fragments and allows for the ability to connect the disparate data for each consumer and provide back a persistent, unique person ID. This Insights Bundle will be returned within the identifiers key in the details object of a Person Summary object. If you want to learn more on how Resolve can help your business please contact our Sales team or learn more by checking out Resolve.

Shopping Habits

Often purchased alongside the Purchases Insights Bundle, the Shopping Habits Insights Bundle adds additional insights about which channels your customers are shopping and how they are paying for their purchases. This Insights Bundle is a premium option and will be returned within the buyer key in the details object of a Person Summary object.

{
"details": {
"buyer": {
"catalog": {
"payment": {
"amx": true,
"creditCard": true,
"discover": true,
"houseCharge": true,
"masterCard": true,
"retailCard": true,
"visa": true
},
"continuityShopper": true,
"onlineShopper": true
}
},
}
}

Properties
buyer.catalog.payment.amx boolean An indicator of whether or not an individual purchases with or has a American Express payment card.
buyer.catalog.payment.credit.card boolean An indicator of whether or not an individual purchases with or has a Credit payment card.
buyer.catalog.payment.discover boolean An indicator of whether or not an individual purchases with or has a Discover payment card.
buyer.catalog.payment.house.charge boolean An indicator of whether or not an individual purchases with or has a House Charge payment card.
buyer.catalog.payment.mastercard boolean An indicator of whether or not an individual purchases with or has a MasterCard payment card.
buyer.catalog.payment.retail.card boolean An indicator of whether or not an individual purchases with or has a Retail payment card.
buyer.catalog.payment.visa boolean An indicator of whether or not an individual purchases with or has a Visa payment card.
buyer.catalog.continuity.shopper boolean An indicator of whether or not an individual is a continuity shopper.
buyer.catalog.online.shopper boolean An indicator of whether or not an individual is an online shopper.

Social

The Social Insights Bundle enables API consumers to retrieve a list of all known social profiles of a given contact, returning data for each social platform such as any applicable usernames/handles, the URL of the platform, any bio that the user supplied, and more. Additionally, any profile pictures and URLs to other websites associated with the contact will be returned. This Insights Bundle will be returned within the profiles, photos, and urls keys in the details object of a Person Summary object.

"profiles": {
"twitter": {
"username": "bartlorang",
"userid": "5998422",
"url": "https://twitter.com/bartlorang",
"bio": "CEO & Co-Founder of @FullContact, Managing Director @v1vc_. Tech Entrepreneur, Investor. Husband to @parkerbenson and Father to Greyson Lorang",
"service": "twitter",
"followers": 5454,
"following": 741
},
...
},
"photos": [
{
"label": "avatar",
"value": "https://d2ojpxxtu63wzl.cloudfront.net/static/a7e6a5aba590d4933e35eaadabd97fd2_44e00e968ac57725a15b32f9ca714827aff8e4818d290cb0c611f2e2585253b3"
}
],
"urls": [
{
"label": "blog",
"value": "http://sample.blog.com"
}
]

Properties
profiles.{platform}.username string Displayable username of the profile.
profiles.{platform}.userid string User ID associated with the profile.
profiles.{platform}.url string URL to the profile on the social platform.
profiles.{platform}.bio string Bio of the profile form the social platform.
profiles.{platform}.service string Name of the social platform.
profiles.{platform}.followers integer Number of follows of the profile, if applicable.
profiles.{platform}.following integer Number of profiles or topics the user is following, if applicable.
photos[n].label string The type of photo.
photos[n].value string The URL to the photo.
urls[n].label string The type of URL/website.
urls[n].value string The URL of the website.