The Data Group

Demographics Append Tutorial

Overview

Demographics Append is a real-time solution for retrieving demographic information regarding a person. This solution can return a significant amount of information, so this tutorial will only cover some of it. More information regarding each of the fields and what they return can be found in the API Documentation.

Demographics Append URI The Demographics Append URI accepts a person’s name and address and returns demographic information for the person.

Required Information

The Demographics Append URI requires you to have an Authorization Token. If you have not retrieved an Authorization Token yet, follow the Authorization Tutorial before continuing.

The Demographics Append URI, like all of the solution URIs, also requires you to have an API Key. If you do not know your API Key, contact support to retrieve it. The API Key should be provided in the request header with the header attribute: x-api-key

The Demographics Append URI must be used with a POST request, where the request payload contains the name of the person being searched for and their address. Example Request URL The URL for the Demographics Append URI is: https://api.thedatagroup.com/{version}/sync/append/demographics, where {version} is the API Version you wish to use.

Request Headers
Header AttributeHeader Value
x-api-key{your api key}
AuthorizationToken{your authorization token}
Content-Typeapplication/json
Request Payload

The request payload for the Demographics Append URI must contain the first_name, last_name, and address_1 attributes. It must also contain either the zipcode attribute or both the city and state attributes.

{
 "first_name": "Richard",
 "last_name": "Young",
 "address_1": "4689 Lakewood Drive",
 "city": "Fleming Island",
 "state": "FL"
}
cURL Example

To query the Demographics Append URI, you can use one of the provided SDKs, a REST Client, or a simple cURL command. Below is an example of the cURL command for the example input information.

curl -X POST -H "Content-Type: application/json" -H "AuthorizationToken: {your_token}" -H "x-api-key: {your_key}" -H "Cache-Control: no-cache" -d '{
 "first_name": "Richard",
 "last_name": "Young",
 "address_1": "4689 Lakewood Drive",
 "city": "Fleming Island",
 "state": "FL"
}' "https://api.thedatagroup.com/v3/sync/append/demographics"
Response Payload

The response payload for the Demographics Append URI will contain the category match type, the address, the phones listed, the demographics information, and the lifestyle information for the discovered individual, household, or address. An example of some of the data can be found below.

{
 "category_match": "INDIVIDUAL",
 "address": {
 "street_number": "4689",
 "street_name": "Lakewood",
 "street_type": "DR",
 "city": "Fleming Island",
 "zipcode": "32003",
 "state": "FL"
 },
 "phones": [
 {
 "phone": 5558675309
 }
 ],

"demographics": {
 "level": "ZIP_9",
 "person": {
 "date_of_birth": "199201",
 "age": 24,
 "percent_mail_order_respondent": 98,
 "finances": {
 "estimated_income": "F",
 "estimated_net_worth": "F",
 "uses_credit_card": true,
 "is_charity_donar": true
 },
 "education": {
 "level": "HIGH_SCHOOL",
 "median_years_schooling": 12
 },
 "race": {
 "percent_black": 3,
 "percent_white": 93,
 "percent_hispanic": 13,
 "percent_asian": 3
 },
 "language": {
 "percent_english_speaker": 88,
 "percent_spanish_speaker": 8
 },
 "worker_type": {
 "percent_white_collar": 43,
 "percent_blue_collar": 3,
 "percent_other": 53
 }
 },
 "residence": {
 "length_of_residence": 11,
 "homeowner": "OWNER",
 "year_home_built": 2003,
 "has_pool": true,
 "estimated_market_value": "Q",
 "median_house_value": "E",
 "dwelling": {
 "type": "SINGLE_FAMILY",
 "percent_single_family": 98
 }
 },
 "family": {
 "married": "MARRIED",
 "children": {
 "has_children": true,

"children_age": "D",
 "number_children": "B"
 }
 },
 "vehicle": {
 "percent_vehicle_owner": 98
 }
 },
 "life_styles": {
 "apparel": {
 "women": "PURCHASED",
 "child": true
 },
 "book": {
 "reader": true
 },
 "interests": {
 "technology": true,
 "home_and_garden": "PHOTOGRAPHY",
 "home_improvement": "DIY_INTEREST",
 "cooking": "NATURAL_FOODS",
 "fitness": "HEALTH_EXERCISE",
 "self_improvement": "HEALTH_AND_MEDICAL",
 "sports": "GOLF",
 "investing": true
 }
 }
}