Enhance your contact records with numerous demographic and lifestyle metrics to help boost the effectiveness of your marketing campaigns, and more precisely target your prospects.
| Time | Status | User Agent | |
|---|---|---|---|
Retrieving recent requests… | |||
HTTP HeaderThe "content-type" in the HTTP header must be set to "application/json", otherwise an HTTP 400 Bad Request response will be returned.
Making a Request
This endpoint combines our most popular options, settings, and data sources for appending demographic information into a single, streamlined developer experience. If you’ve been using the Demographic Append endpoint with all sources, this is an ideal solution to reduce the complexity of the API calls you are making.
The Demographic Append function closely mimics the logic and data sources used in our batch append service except it allows the user to programmatically make single calls using an API. Pass contact information such as first name, last name, city, state and physical address to look-up the demographics of your customer such as estimated income, ethnicity and duration of residence.
Response Definitions
PARTY DEMOGRAPHICS
All values will have the indicated response data if the datapoint is populated, otherwise, the attribute is not returned.
| Field name | Type | Description |
|---|---|---|
| Age | int | Age as calculated from Date of Birth. |
| AgeRange | string | Age range calculated from Age 18-24, 25-34, 35-44, 45-44, 55-64, 65-74, 75+ |
| HoH | string | Head of household rank. 0-9 |
| Gender | string | Gender. M / F / U |
| Marital | string | Inferred marital status. Single / Married |
| ChildPresent | string | Indicates presence of children in the household. |
| HomeownerType | string | Home Owner / Renter |
| LengthOfResidence | string | Length of residence (in yrs) |
| MedHomeValue | string | Median home value in area |
| Ethnicity | string | Ethnicity |
| MedianYrsInSchool | string | Inferred years of education (non-numeric description) High school, Some College, Completed College |
| EstIncome | string | Estimated household annual income |
| EstWealth | string | Estimated household wealth |
| Language | string | Primary language spoken in household |
| Occupation | string | Industry of occupation |
| Occupation - Detailed | string | Details of occupation |
| Religion | string | Religious affiliation |
DONOR DEMOGRAPHICS
All values returned will be "Y" if the attribute is true, otherwise, the attribute is not returned.
| Field name | Type | Description |
|---|---|---|
| DonationsContributions | string | Donates to generic causes. |
| DonationsMailOrder | string | Donates to solicitations received via postal mail. |
| DonatestoCharitableCauses | string | Donates to charitable causes. |
| DonatestoAnimalWelfare | string | Donates to animal welfare causes. |
| DonatestoArtsCultural | string | Donates to the arts and cultural causes. |
| DonatestoChildrens | string | Donates to children's causes. |
| DonatestoEnvironmentWildlife | string | Donates to environmental and wildlife causes. |
| DonatestoEnvironmentalIssues | string | Donates to environmental issues and legislative efforts. |
| DonatestoHealth | string | Donates to medical and health causes. |
| DonatestoInternationalAid | string | Donates to international causes. |
| DonatestoPolitical | string | Donates to political causes. |
| DonatestoPoliticalConservative | string | Donates to conservative political causes. |
| DonatestoPoliticalLiberal | string | Donates to liberal political causes. |
| DonatestoReligious | string | Donates to religious causes. |
| DonatestoVeterans | string | Donates to veteran causes. |
| DonatestoOther | string | Donates to other causes. |
| DonatestoCommunityCharities | string | Donates to community charities. |
INVESTING DEMOGRAPHICS
All values returned will be "Y" if the attribute is true, otherwise, the attribute is not returned.
| Field Name | Type | Description |
|---|---|---|
| InvestingActive | string | |
| InvestmentsPersonal | string | |
| InvestmentsRealEstate | string | |
| InvestmentsStocksBonds | string | |
| CreditRating | string |
INTEREST DEMOGRAPHICS
All values returned will be "Y" if the attribute is true, otherwise, the attribute is not returned.
| Field Name | Type | Description |
|---|---|---|
| ArtsAntiquesAntiques | string | Interested in art, antiques and collectibles. |
| ArtsAntiquesArt | string | Interested in art, antiques and collectibles. |
| CollectiblesArts | string | Interested in collectible art. |
| CollectiblesAntiques | string | Interested in collectible antiques. |
| Aviation | string | Interested in aviation. |
| TravelGeneral | string | Interested in general travel. |
| TravelDomestic | string | Interested in domestic travel. |
| TravelInternational | string | Interested in international travel. |
| TravelCruiseVacations | string | Interested in cruises. |
| Golf | string | Interested in Golf. |
| BoatingSailing | string | Interested in boating and sailing. |
| Hunting | string | Interested in hunting. |
| Fishing | string | Interested in fishing. |
| HealthMedical | string | Interested in bio-hacking, health and medical. |
HTTP Error Messages
Click to see a complete listing of error messages and codes.