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 with single output type:

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

Example with multiple output types:

https://api.versium.com/v2/demographic?output[]=demographic&output[]=financial&output[]=political&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

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.
rcfg_max_timeA whole or decimal numberMaximum allowed API run time (in seconds)Can be used with all output types.