Qualification and Condition Codes
You may now utilize the Buy API to retrieve PureSpectrum qualification and condition codes by localization code & question class.
Attributes API
https://api.spectrumsurveys.com/buyers/v3/Attributes?localization=[%%localization%%]&class=[%%class%%]&page=[%%page%%]&format=true
Header Parameters
Parameter | Type | Required | Description |
---|---|---|---|
access-token | string | Yes | Token used to identify the authenticity of the user. |
Â
Query String Parameters
Parameter | Type | Â Required | Description |
---|---|---|---|
localization | string | Yes | This is the country/language combination of the respondent. Please refer to the table here: Codes & Units |
class | integer - options: 1-Core Library 2-Extended Library 3-Custom Library | If this parameter is omitted, all classes are returned. | Questions in the PureSpectrum library are broken into 3 categories:
|
page | integer | Yes - if more than one page is returned in the response, you must use this to access the additional attributes. | Page information will be returned in the Response Header parameter "total_pages" |
Â
Quick Reference
Qualification | Qualification Code | Condition Label (Generic) | Conditions Code | en_US | en_USÂ Label (Same as generic) | en_USÂ Sort Order | en_CA | en_CAÂ Label (Same as generic) | en_CAÂ Sort Order | en_GB | en_GBÂ Label (Same as generic) | en_GB Sort Order | en_AU | en_AUÂ Label (Same as generic) | en_AU Sort Order |
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
gender | 211 | Â | Â | y | Â | Â | y | Â | Â | y | Â | Â | y | Â | Â |
 |  | Male | 111 | y | y |  | y | y | 1 | y | y | 1 | y | y | 1 |
 |  | Female | 112 | y | y |  | y | y | 2 | y | y | 2 | y | y | 2 |
 |  | Prefer not to say | 113 |  |  |  |  |  |  |  |  |  |  |  | |
age | 212 | Age | Â | y | Â | Â | y | Age | Â | y | Age | Â | y | Age | Â |
houseHoldIncome | 213 | Income | Â | y | Â | Â | y | Income | Â | y | Income | Â | y | Income | Â |
race | 214 | Â | Â | y | Â | Â | y | Race | Â | Â | Â | Â | Â | Â | Â |
 |  | White | 111 | y |  |  | y | White | 1 |  |  |  |  |  |  |
 |  | Hispanic | 112 | y |  |  |  |  |  |  |  |  |  |  |  |
 |  | African American | 113 | y |  |  | y | Black | 2 |  |  |  |  |  |  |
 |  | Asian | 114 | y |  |  | y | Asian | 3 |  |  |  |  |  |  |
 |  | American Indian | 115 | y |  |  |  |  |  |  |  |  |  |  |  |
 |  | Middle Eastern | 116 | y |  |  |  |  |  |  |  |  |  |  |  |
 |  | Other ethnicity | 117 | y |  |  | y | Other | 6 |  |  |  |  |  |  |
 |  | Native American, Inuit or Aleut | 118 |  |  |  | y | Native American, Inuit or Aleut | 4 |  |  |  |  |  |  |
 |  | Native Hawaiian / Pacific Islander | 119 |  |  |  | y | Pacific Islander | 5 |  |  |  |  |  |  |
 |  | Prefer not to answer | 120 |  |  |  |  |  |  |  |  |  |  |  |  |
Race/Ethnicity | 244 | Â | Â | Â | Â | Â | Â | Â | Â | Â | Â | Â | Â | Â | Â |
 |  | White | 111 | y |  |  | y |  |  |  |  |  |  |  |  |
 |  | Black or African American | 112 | y |  |  | y |  |  |  |  |  |  |  |  |
 |  | Asian | 113 | y |  |  | y |  |  |  |  |  |  |  |  |
 |  | Native Hawaiian or Other Pacific Islander | 114 | y |  |  | y |  |  |  |  |  |  |  |  |
 |  | American Indian or Alaska Native | 115 | y |  |  | y |  |  |  |  |  |  |  |  |
 |  | Other Race | 116 | y |  |  | y |  |  |  |  |  |  |  |  |
Hispanic Origin | 245 | Â | Â | Â | Â | Â | Â | Â | Â | Â | Â | Â | Â | Â | Â |
 |  | Yes | 111 |  |  |  | y |  |  |  |  |  |  |  |  |
 |  | No | 112 |  |  |  | y |  |  |  |  |  |  |  |  |
employments | 215 | Â | Â | y | Â | Â | y | Â | Â | y | Â | Â | y | Â | Â |
 |  | Unemployed | 111 | y | y | 1 | y | y | 1 | y | y | 1 | y | Unemployed | 1 |
 |  | Student | 112 | y | y | 2 | y | y | 2 | y | y | 2 | y | Student | 2 |
 |  | Part Time | 113 | y | y | 3 | y | y | 3 | y | y | 3 | y | Part Time | 3 |
 |  | Full Time | 114 | y | y | 4 | y | y | 4 | y | y | 4 | y | Full Time | 4 |
 |  | Retired | 115 | y | y | 5 | y | y | 5 | y | y | 5 | y | Retired | 5 |
 |  | Contract, Freelance or Temporary Employee | 116 |  |  |  | y | y | 6 |  |  |  |  |  |  |
 |  | Prefer not to answer | 117 |  |  |  | y | y | 7 |  |  |  |  |  |  |
educations | 216 | Â | Â | y | Â | Â | y | Â | Â | Â | Â | Â | Â | Â | Â |
 |  | Some high school | 111 | y | y | 1 | y | y | 1 |  |  |  |  |  |  |
 |  | High School Graduate | 112 | y | y | 2 | y | y | 2 |  |  |  |  |  |  |
 |  | Some College | 113 | y | y | 3 | y | y | 3 |  |  |  |  |  |  |
 |  | Bachelor's Degree | 114 | y | y | 4 | y | y | 4 |  |  |  |  |  |  |
 |  | Master's Degree | 115 | y | y | 5 | y | y | 5 |  |  |  |  |  |  |
 |  | Some Postgraduate | 117 |  |  |  |  |  |  |  |  |  |  |  |  |
 |  | Graduate/Post Graduate Degree | 118 |  |  |  |  |  |  |  |  |  |  |  |  |
 |  | Doctorate Degree | 116 | y | y | 6 | y | y | 6 |  |  |  |  |  |  |
 |  | Prefer not to answer | 119 |  |  |  |  |  |  |  |  |  |  |  |  |
relationships | 217 | Â | Â | y | Â | Â | Â | Â | Â | Â | Â | Â | Â | Â | Â |
 |  | Single | 111 | y | y | 1 | y | y | 1 |  |  |  |  |  |  |
 |  | Engaged | 112 | y | y | 2 | y | y | 2 |  |  |  |  |  |  |
 |  | Living with a Partner | 113 | y | y | 3 | y | y | 3 |  |  |  |  |  |  |
 |  | Married | 114 | y | y | 4 | y | y | 4 |  |  |  |  |  |  |
 |  | Divorced | 115 | y | y | 5 | y | y | 5 |  |  |  |  |  |  |
 |  | Widowed | 116 | y | y | 6 | y | y | 6 |  |  |  |  |  |  |
 |  | Prefer not to answer | 117 |  |  |  | y | y | 7 |  |  |  |  |  |  |
Children | 218 | Â | Â | y | Â | Â | y | Â | Â | y | Â | Â | y | Â | Â |
 |  | No Children | 111 | y | y | 1 | y | y | 1 | y | y | 1 | y | y | 1 |
 |  | Have Children | 112 | y | y | 2 | y | y | 2 | y | y | 2 | y | y | 2 |
device | 219 | Â | Â | y | Â | Â | y | Â | Â | Â | Â | Â | y | Â | Â |
 |  | Desktop | 111 | y |  |  | y | Desktop | 1 | y | Desktop | 1 | y | Desktop | 1 |
 |  | Mobile | 112 | y |  |  | y | Mobile | 2 | y | Mobile | 2 | y | Mobile | 2 |
 |  | Tablet | 113 | y |  |  | y | Tablet | 3 | y | Tablet | 3 | y | Tablet | 3 |
kids | 220 | Â | Â | y | Â | Â | y | Â | Â | y | Â | Â | Â | Â | Â |
 |  | Boy | 111 | y |  |  | y | Boy | 1 | y | Boy | 1 | y | Boy | 1 |
 |  | Girl | 112 | y |  |  | y | Girl | 2 | y | Girl | 2 | y | Girl | 2 |
Kids Birthday Unit //Pending Review | 221 | Â | Â | y | Â | Â | y | Â | Â | y | Â | Â | Â | Â | Â |
 |  | Months | 111 | y |  |  | y | Months | 1 | y | Months | 1 | y | Months | 1 |
 |  | Years | 112 | y |  |  | y | Years | 2 | y | Years | 2 | y | Years | 2 |
Location-Nationally Representative | 222 | Â | Â | y | Â | Â | Â | Â | Â | Â | Â | Â | Â | Â | Â |
regions | 223 | Â | Â | y | Â | Â | Â | Â | Â | Â | Â | Â | Â | Â | Â |
 |  | Northeast | 1 | y |  |  |  |  |  |  |  |  |  |  |  |
 |  | Midwest | 2 | y |  |  |  |  |  |  |  |  |  |  |  |
 |  | South | 3 | y |  |  |  |  |  |  |  |  |  |  |  |
 |  | West | 4 | y |  |  |  |  |  |  |  |  |  |  |  |
divisions | 224 | Â | Â | y | Â | Â | Â | Â | Â | Â | Â | Â | Â | Â | Â |
 |  | New England | 1 | y |  |  |  |  |  |  |  |  |  |  |  |
 |  | Middle Atlantic | 2 | y |  |  |  |  |  |  |  |  |  |  |  |
 |  | East North Central | 3 | y |  |  |  |  |  |  |  |  |  |  |  |
 |  | West North Central | 4 | y |  |  |  |  |  |  |  |  |  |  |  |
 |  | South Atlantic | 5 | y |  |  |  |  |  |  |  |  |  |  |  |
 |  | East South Central | 6 | y |  |  |  |  |  |  |  |  |  |  |  |
 |  | West South Central | 7 | y |  |  |  |  |  |  |  |  |  |  |  |
 |  | Mountain | 8 | y |  |  |  |  |  |  |  |  |  |  |  |
 |  | Pacific | 9 | y |  |  |  |  |  |  |  |  |  |  |  |
states | 225 | Â | Â | y | Â | Â | Â | Â | Â | Â | Â | Â | Â | Â | Â |
 |  | Use spreadsheet for name and codes  |  | y |  |  |  |  |  |  |  |  |  |  |  |
msa | 226 | Â | Â | y | Â | Â | Â | Â | Â | Â | Â | Â | Â | Â | Â |
 |  | Use spreadsheet for name and codes  |  | y |  |  |  |  |  |  |  |  |  |  |  |
csa | 227 | Â | Â | y | Â | Â | Â | Â | Â | Â | Â | Â | Â | Â | Â |
 |  | Use spreadsheet for name and codes  |  | y |  |  |  |  |  |  |  |  |  |  |  |
county | 228 | Â | Â | y | Â | Â | Â | Â | Â | Â | Â | Â | Â | Â | Â |
 |  | Use spreadsheet for name and codes  |  | y |  |  |  |  |  |  |  |  |  |  |  |
zipcodes | 229 | Â | Â | y | Â | Â | Â | Â | Â | Â | Â | Â | Â | Â | Â |
 |  | Use real zipcodes |  | y |  |  |  |  |  |  |  |  |  |  |  |
Kids Age Count //under review | 230 | (This in conjunction with Kids Age Unit indicates the age of the kid) | Â | y | Â | Â | Â | Â | Â | Â | Â | Â | Â | Â | Â |
dma | 231 | Use spreadsheet for name and codes  |  | y |  |  |  |  |  |  |  |  |  |  |  |
child age and gender | 232 | Use spreadsheet for name and codes - attached below | Â | y | Â | Â | y | Â | Â | y | Â | Â | y | Â | Â |
provinces | 233 | Â | Â | Â | Â | Â | y | Â | Â | Â | Â | Â | Â | Â | Â |
 |  | Alberta | 1 |  |  |  | y |  |  |  |  |  |  |  |  |
 |  | British Columbia | 2 |  |  |  | y |  |  |  |  |  |  |  |  |
 |  | Manitoba | 3 |  |  |  | y |  |  |  |  |  |  |  |  |
 |  | New Brunswick | 4 |  |  |  | y |  |  |  |  |  |  |  |  |
 |  | Newfoundland and Labrador | 5 |  |  |  | y |  |  |  |  |  |  |  |  |
 |  | Nova Scotia | 7 |  |  |  | y |  |  |  |  |  |  |  |  |
 |  | Northwest Territory | 6 |  |  |  | y |  |  |  |  |  |  |  |  |
 |  | Ontario | 9 |  |  |  | y |  |  |  |  |  |  |  |  |
 |  | Prince Edward Island | 10 |  |  |  | y |  |  |  |  |  |  |  |  |
 |  | Quebec | 11 |  |  |  | y |  |  |  |  |  |  |  |  |
 |  | Saskatchewan | 12 |  |  |  | y |  |  |  |  |  |  |  |  |
 |  | Yukon | 13 |  |  |  | y |  |  |  |  |  |  |  |  |
Â
US, Location tables attached:
UK, Australia Location tables attached:Â English_Expansion_Core_Datav4.xlsx
Â