API Response Guide

Successful Personalization API responses are returned in JSON format. Below is a comprehensive list of all possible responses from the Personalization API, separated into conceptual groups for readability. Within each group, there are one or more "fields" which are denoted by quotes.

Demographic Data

"age": "18-20", "21-24", "25-34", "35-44", "45-54", "55-64", "65+"
"gender": "Male", "Female"
"zip": "94105"...

Household Data

"education": "Completed High School", "Attended College", "Completed College", "Completed Graduate School", "Attended Vocational/Technical" 
"household_income": "0-15k", "15k-25k", "25k-35k", "35k-50k", "50k-75k", "75k-100k", "100k-125k", "125k-150k", "150k-175k", "175k-200k", "200k-250k", "250k+"
"home_market_value": "1k-25k", "25k-50k", "50k-75k", "75k-100k", "100k-150k", "150k-200k", "200k-250k", "250k-300k", "300k-350k", "350k-500k", "500k-1mm", "1mm+"
"home_owner_status": "Own", "Rent"
"length_of_residence": "Less than 1 year", "1 Year",  "2 Years",  "3 Years",  "4 Years", "5 Years",  "6 Years",  "7 Years",  "8 Years",  "9 Years",  "10 Years",  "11-15 years", "16-19 years",  "20+ years"
"marital_status": "Single", "Married"
"occupation": "Blue Collar Worker", "Business Owner", "Civil Service", "Executive/Upper Management", "Health Services", "Homemaker", "Middle Management", "Military Personnel", "Nurse", "Part Time", "Professional", "Retired", "Secretary", "Student", "Teacher", "Technology", "White Collar Worker"
"children": "Yes", "No"

Interest & Purchase Data

"interests": {
  "Arts & Crafts":true,
  "Automotive":true,
  "Baby Product Buyer":true,
  "Beauty":true,
  "Blogging":true,
  "Books":true,
  "Business":true,
  "Charitable Donors":true,
  "Cooking":true,
  "Discount Shopper":true,
  "Health & Wellness":true,
  "High-End Brand Buyer":true,
  "Home & Garden":true,
  "Home Improvement":true,
  "Luxury Goods & Jewelry":true,
  "Magazine Buyer":true,
  "News & Current Events":true,
  "Outdoor & Adventure":true,
  "Pets":true,
  "Power Shopper":true,
  "Sports":true,
  "Technology":true,
  "Travel":true,
}
1,000 free age and gender queries. Get Your API Key