Person Insights Bundles

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 stringThe given name (first name) of the individual.
name.family stringThe family name (last name) of the individual.
name.full.name stringThe full name (first and last) of the individual.
age.range stringAn age range of the individual.
age.value integerThe age in years of the individual.
age.birthday stringThe date of birth of the individual.
gender stringThe gender of the individual.
demographics.age.range stringAn age range of the individual.
demographics.age.range.value integerThe age in years of the individual.
emails objectObject representing additional known email addresses.
phones objectObject representing additional known phone numbers.
profiles.{platform}.url stringURL to the profile on the social platform.
profiles.{platform}.bio stringBio of the profile from the social platform.
profiles.{platform}.service stringName of the social platform.
locations[n].city stringThe "city" portion of the location address.
locations[n].region stringThe region portion of the location address, typically a state or province.
locations[n].regionCode stringAn abbreviated or code-based representation of the region.
locations[n].country stringThe country portion of the location address.
locations[n].formatted stringThe formatted address.
employment.name stringThe name of the organization/place of employment.
employment.current booleanIndicator of whether or not this is the current place of employment.
employment.title stringJob or position title.
photos[n].label stringThe type of photo.
photos[n].value stringThe URL to the photo.
education[n].name stringThe name of the school/university attended.
education[n].degree stringThe degree or focus of study.
education[n].end.year objectObject representing the last year, month and day attended.
urls[n].value stringThe URL of the website.
interests objectObject 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 stringThe 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 stringThe full name (first and last) of the individual.
gender stringThe gender of the individual.
details.name.given stringThe given name (first name) of the individual.
details.name.family stringThe family name (last name) of the individual.
details.age.range stringAn age range of the individual.
details.age.value integerThe age in years of the individual.
details.gender stringThe gender of the individual.
Properties: details.household
home.info.home.value.estimate integerThe estimated value of an individual's home.
home.info.loan.to.value.estimate integerThe loan-to-value estimate of an individual's home.
presence.children stringThe likelihood of a household with a presence of children.
Properties: details.household.finance
cash.value.balance.household.estimate stringThe estimate of the cash value balance of a household.
discretionary.income.estimate integerThe estimate of a household's discretionary income.
financial.debt.range.estimate stringAn estimate of the range of debt of a household.
household.income.estimate stringAn estimate of a household's total income.
net.worth.range stringThe estimated net worth of a household.
Properties: details.demographics
gender stringThe gender of the individual.
age.range stringAn age range of the individual.
age.range.value integerThe age in years of the individual.
marital.status stringThe marital status of an individual.
occupation stringThe occupation of an individual.
Properties: details.finance
bank.card stringAn indication if an individual holds one or more bank cards.
bankruptcy stringAn indicator of whether or not an individual has experienced bankruptcy.
active.line.of.credit stringAn indicator of whether or not an individual has an active line of credit.
retail.card stringAn indicator if an individual holds one or more retail cards.
census.year.2010.percent.homeowner integerAn indicator of the percentage of individuals who own a home.
Additional Properties
census.year.2010.percent.homeowner integerAn indicator of the percentage of individuals who own a home.
emails objectObject representing additional known email addresses.
phones objectObject representing additional known phone numbers.
profiles.{platform}.url stringURL to the profile on the social platform.
profiles.{platform}.bio stringBio of the profile form the social platform.
profiles.{platform}.service stringName of the social platform.
locations[n].city stringThe "city" portion of the location address.
locations[n].region stringThe region portion of the location address, typically a state or province.
locations[n].regionCode stringAn abbreviated or code-based representation of the region.
locations[n].country stringThe country portion of the location address.
locations[n].formatted stringThe formatted address.
employment.name stringThe name of the organization/place of employment.
employment.current booleanIndicator of whether or not this is the current place of employment.
employment.title stringJob or position title.
photos[n].label stringThe type of photo.
photos[n].value stringThe URL to the photo.
education[n].name stringThe name of the school/university attended.
education[n].degree stringThe degree or focus of study.
education[n].end.year objectObject representing the last year, month and day attended.
urls[n].value stringThe URL of the website.
interests objectObject 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. The max number of hashed email addresses that can be returned are 20.
This Insights Bundle will be returned within the emails key in the details object of a Person Summary object.

📘

The Email Hash Insights Bundle is a premium option. For more information or to have this enabled for your account, please
contact our sales team.

{"emails": [
  {
    "label": "provided",
    "value": "[email protected]"
  },
  {
    "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 stringThe name of the organization/place of employment.
domain stringThe website domain of the place of employment.
current booleanIndicator of whether or not this is the current place of employment.
title stringJob 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 integerAn indicator of the estimated percentage of the mortgage amount borrowed to the appraised home value.
loan.to.value.estimate integerAn indicator of the estimated assessed value of an individual's property.
Properties: details.household.finance
cash.value.balance.household.estimate stringThe estimated value range of the cash value balance of a household.
discretionary.income.estimate integerAn estimated household discretionary income percentage indicator based on the estimated annual income.
financial.debt.range.estimate stringThe estimated value range of the financial debt of a household.
household.income.estimate stringThe estimated value range of the total annual income of a household.
net.worth.range stringThe estimated value range of a household’s net worth.
Properties: details.finance
bank.card stringAn indicator if an individual has a single or multiple bank cards.
bankruptcy booleanAn indicator of whether or not an individual has undergone bankruptcy.
active.line.of.credit booleanAn indicator of whether or not an individual has an active line of credit.
retail.card stringAn indicator if an individual has a single or multiple retail cards.
Properties: details.census.year2010
percent.homeowner integerAn 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 integerThe total number of adults 18 years and older that reside in the household.
family.info.total.children integerThe total number of individuals under the age of 18 that reside in the household.
family.info.total.people.in.household integerThe total number of individuals that reside in the household.
home.info.dwelling.type stringAn indicator of the type of dwelling.
home.info.years.in.home integerThe number of years an individual has lived in the current household.
location.info.seasonal.address booleanIndicator of whether or not this residence is a seasonal address.
presence.multigenerational.resident stringIndicator of whether or not there is a presence of an elderly parent in the household.
Properties: details.demographics
living.status stringAn indicator of whether or not an individual owns a home or renting a dwelling unit.
Properties: details.survey.own
own.cat booleanIndicator of whether or not this individual owns a cat.
own.dog booleanIndicator of whether or not this individual owns a dog.

Interests

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 Interests 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 stringThe 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 stringThe 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 objectObject representing indicators of whether or not an individual owns a camera, horse, motorcycle, pool, ATV or RV.
collectibles objectObject 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 objectObject representing indicators of whether or not an individual has a credit card that is considered of premium status.
credit.cards.regular objectObject representing indicators of whether or not an individual has a credit card that is considered of standard status.
credit.cards.debit booleanAn indicator of whether or not an individual has a debit card.
diet.concerns objectObject 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 booleanAn indicator of whether or not an individual has grandchildren.
hobby objectObject 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 booleanAn indicator of whether or not an individual makes purchases online.
investments booleanAn indicator of whether or not an individual has made investments.
music objectObject 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 objectObject 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 objectObject 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 objectObject 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 booleanAn indicator of whether or not an individual has identified as being religious.
electronics objectObject 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 objectObject 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 stringThe designated carrier route for an individual's household.
designated.market.area stringThe market area that an individual resides.
core.based.statistical.area stringThe core based statistical locaiton of where an individual resides.
nielsen.county.size stringThe county size code and description for an individual.
congressional.district stringThe congressional district where an individual resides.
numeric.county.code integerThe county code of where an individual lives.
Properties: details.census
basic.tract.number integerAn indicator of the census tract group of an individual.
basic.block.group integerAn indicator of the block group that an individual resides.
year.2010.education.level stringThe highest level of education an individaul has completed.
year.2010.average.number.of.cars.in.household stringThe average number of cars an individual has within a household.
Properties: details.census.percent
above.poverty.level integerAn indicator of the percentage of individuals above poverty level.
below.poverty.level integerAn indicator of the percentage of individuals below poverty level.
blue.collar.employed integerAn indicator of the percentage of individuals who are employed in a blue collar industry.
divorced.or.separated integerAn indicator of the percentage of individuals who are divorced or separated.
homes.built.since.2000 integerAn indicator of the percentage of homes and/or structures built since 2000.
homeowner integerAn indicator of the percentage of individuals who own a house.
household.with.children integerAn indicator of the percentage of households who have children present.
married integerAn indicator of the percentage of married individuals.
mobile.home integerAn indicator of the percentage of individuals who are living in a mobile home.
moved.to.area.since.2000 integerAn indicator of the percentage of households that moved into a new geographcial area 2000 and later.
salaried.professional integerAn indicator of the percentage of individuals who are employed and earning an annual salary.
single.family.home integerAn indicator of the percentage of individuals who are living in a single family home dwelling type.
vehicle.ownership integerAn indicator of the percentage of individuals who own a vehicle.
Properties: details.census.median
age.of.householder integerThe median age of individuals who own a home 18 years and older.
effective.buying.income integerThe median disposable household income of individuals.
home.value integerThe median home value of all individuals across the US.
household.income integerThe median household income of all individuals across the US.
household.income.by.state integerThe median household income of all individuals across the US by state.
Properties: details.census.population.density
centile.in.state integerAn indicator of the state population density by block group with a value of 1 signifying most dense.
centile.in.us integerAn indicator of the US population density by block group with a value of 1 signifying most dense.
Properties: details.census
socioeconomic.score integerAn 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. In the response, you can receive up to the 5 most recent MAIDs. 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": "[email protected]"
  }
],
"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 stringA phone number associated with the individual's company.
Properties: details.employment
name stringThe name of the organization/place of current employment.
domain stringThe website domain of the current place of employment.
current booleanIndicator of whether or not this is the current place of employment.
title stringJob 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 stringThe "city" portion of the location address.
locations[n].region stringThe region portion of the location address, typically a state or province.
locations[n].regionCode stringAn abbreviated or code-based representation of the region.
locations[n].country stringThe country portion of the location address.
locations[n].formatted stringThe 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 objectObject representing indicators of an individual’s catalog purchasing behavior across major apparel categories.
buyer.catalog objectObject representing indicators of an individual’s catalog purchasing behavior across over a dozen major categories.
buyer.retail.apparel objectObject representing indicators of an individual’s retail purchasing behavior across major apparel categories.
buyer.retail objectObject 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 Overview

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 booleanAn indicator of whether or not an individual purchases with or has a American Express payment card.
buyer.catalog.payment.credit.card booleanAn indicator of whether or not an individual purchases with or has a Credit payment card.
buyer.catalog.payment.discover booleanAn indicator of whether or not an individual purchases with or has a Discover payment card.
buyer.catalog.payment.house.charge booleanAn indicator of whether or not an individual purchases with or has a House Charge payment card.
buyer.catalog.payment.mastercard booleanAn indicator of whether or not an individual purchases with or has a MasterCard payment card.
buyer.catalog.payment.retail.card booleanAn indicator of whether or not an individual purchases with or has a Retail payment card.
buyer.catalog.payment.visa booleanAn indicator of whether or not an individual purchases with or has a Visa payment card.
buyer.catalog.continuity.shopper booleanAn indicator of whether or not an individual is a continuity shopper.
buyer.catalog.online.shopper booleanAn 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 stringDisplayable username of the profile.
profiles.{platform}.userid stringUser ID associated with the profile.
profiles.{platform}.url stringURL to the profile on the social platform.
profiles.{platform}.bio stringBio of the profile form the social platform.
profiles.{platform}.service stringName of the social platform.
profiles.{platform}.followers integerNumber of follows of the profile, if applicable.
profiles.{platform}.following integerNumber of profiles or topics the user is following, if applicable.
photos[n].label stringThe type of photo.
photos[n].value stringThe URL to the photo.
urls[n].label stringThe type of URL/website.
urls[n].value stringThe URL of the website.

Did this page help you?