You may now utilize the Buy API to retrieve PureSpectrum qualification and condition codes by localization code & question class. |
https://api.spectrumsurveys.com/buyers/v2/psAttributes?localization=[%%localization%%]&class=[%%class%%]&page=[%%page%%]&format=true
Parameter | Type | Required | Description |
---|---|---|---|
access-token | string | Yes | Token used to identify the authenticity of the user. |
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" |
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
Child Age & Gender Table: