Improve your ability to personalize your marketing campaigns by adding valuable demographic insights to your customer lists with consumer insights from the Demographic API. With a consumer's name, country, and one other identifying piece of information, pull rich consumer insights from the Versium database, including:

  • Individual and household demographics, such as age range and marital status.
  • Interests & activities
  • Purchase behavior
  • Finances, such as their household income
  • What type of car they drive.

Format

Here's the format to call the Demographic Append API:

Example:

https://api.versium.com/v2/demographic?output[]=demographic&first=vernoca&last=queck&city=seattle

Output Type

Output type is what the user would like to obtain from the Contact Append API. There are four different types of output type and each have required and optional parameters as described in the below table.

Output TypeRequired Search Param.Optional Search Param.
demographicphone OR email OR Address, city, state, zip OR first, last, city, state OR first, last, zipaddress_2, country
financialphone OR email OR Address, city, state, zip OR first, last, city, state OR first, last, zipaddress_2, country
lifestylephone OR email OR Address, city, state, zip OR first, last, city, state OR first, last, zipaddress_2, country
politicalphone OR email OR Address, city, state, zip OR first, last, city, state OR first, last, zipaddress_2, country
full_demographicphone OR email OR Address, city, state, zip OR first, last, city, state OR first, last, zipaddress_2, country

Here below are the details of available data for the Consumer Demographic Insights.

Consumer Demographic Insights

  • Age Range
  • Gender
  • Ethnic Group
  • Religion
  • Education Level
  • Occupation
  • Language
  • Marital Status
  • Working Woman in Household
  • Senior in Household
  • Single Parent
  • Presence of Children
  • Number of Children
  • Young Adult in Household
  • Small Office or Home Office
  • Online Purchasing Indicator
  • Online Education

Financial, Household and Auto Insights

  • Home Own or Rent
  • Household Income
  • Estimated Net Worth
  • Home Year Built
  • Home Purchase Date
  • Home Purchase Price
  • Dwelling Type
  • Home Value
  • Length of Residence
  • Credit Card Holder Bank
  • Number of Credit Lines
  • Upscale Card Holder
  • Credit Rating
  • Mortgage Purchase Amount
  • Mortgage Purchase Loan Type
  • Mortgage Purchase Interest Rate Type
  • Mortgage Purchase Date
  • 2nd Most Recent Mortgage Amount
  • 2nd Most Recent Mortgage Loan Type
  • 2nd Most Recent Mortgage Interest Rate Type
  • 2nd Most Recent Mortgage Date
  • Loan to Value
  • Refinance Date
  • Refinance Amount
  • Refinance Loan Type
  • Refinance Rate Type
  • Home Pool
  • Auto Year
  • Auto Make
  • Auto Model

Lifestyle and Interests Insights

  • Magazines
  • Reading Current Affairs and Politics
  • Mail Order Buyer
  • Dieting and Weight Loss
  • Travel
  • Music
  • Consumer Electronics
  • Arts Antiques
  • Home Improvement
  • Gardening
  • Cooking
  • Exercise
  • Sports
  • Outdoors
  • Women's Apparel
  • Men's Apparel
  • Pets
  • Investing
  • Health and Beauty
  • Decorating and Furnishing

Political and Donor Insights

  • Party Affiliation
  • Donor Environmental
  • Donor Animal Welfare
  • Donor Arts and Culture
  • Donor Children's Causes
  • Donor Environmental or Wildlife
  • Donor Health
  • Donor International Aid
  • Donor Political
  • Donor Conservative Politics
  • Donor Liberal Politics
  • Donor Religious
  • Donor Veterans
  • Donor Unspecified
  • Donor Community

Full Demographic

  • The full list of attributes returned by the full_demographic output type can be found on the Full Demographic Insights page.

Also please see the Output Sample of the Full Demographic API in JSON format and the Match Credit Conversion Table.

Inputs - what the API uses to search

Search Parameters are used as fields that the Demographic Append API will use to search at the Versium REACH back end.
This API service accepts consumer contact information in Common API Inputs and Options It matches your inputs with consumers in the Versium data and returns consumer information, as available.

valuedescriptionexample
firstA person’s first nameJohn
lastA person’s last nameSmith
addressA house/building number and street123 Main St
address_2The unit number of an addressApt 12 or Unit 510
cityA city nameSeattle
stateA US stateWA
zipA 5 digit US ZIP code98052
countryA 2 digit country code (only US is supported)US
phoneA valid 10 digit North American phone number2061235555
emailA valid email address (consumer or business email)[email protected]

Optional Parameters

Optional Configuration Parameters are used to specify and configure how the Demographic Append API will perform the search.

Optional Config. Param.valuedescriptionusage
cfg_maxrecs1 (default) -> 100number of returned recordsCan be used with all output types.