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 Type | Required Search Param. | Optional Search Param. |
|---|---|---|
| demographic | phone OR email OR Address, city, state, zip OR first, last, city, state OR first, last, zip | address_2, country |
| financial | phone OR email OR Address, city, state, zip OR first, last, city, state OR first, last, zip | address_2, country |
| lifestyle | phone OR email OR Address, city, state, zip OR first, last, city, state OR first, last, zip | address_2, country |
| political | phone OR email OR Address, city, state, zip OR first, last, city, state OR first, last, zip | address_2, country |
| full_demographic | phone OR email OR Address, city, state, zip OR first, last, city, state OR first, last, zip | address_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.
| value | description | example |
|---|---|---|
| first | A person’s first name | John |
| last | A person’s last name | Smith |
| address | A house/building number and street | 123 Main St |
| address_2 | The unit number of an address | Apt 12 or Unit 510 |
| city | A city name | Seattle |
| state | A US state | WA |
| zip | A 5 digit US ZIP code | 98052 |
| country | A 2 digit country code (only US is supported) | US |
| phone | A valid 10 digit North American phone number | 2061235555 |
| A 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. | value | description | usage |
|---|---|---|---|
| cfg_maxrecs | 1 (default) -> 100 | number of returned records | Can be used with all output types. |