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