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/v2/psAttributes?localization=[%%localization%%]&class=[%%class%%]&page=[%%page%%]&format=true

Header Parameters

Parameter

Type

Required

Description

Parameter

Type

Required

Description

access-token

string

Yes

Token used to identify the authenticity of the user.

 

Query String Parameters

Parameter

Type

 Required

Description

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:

  • Core: Should be mapped for all suppliers

  • Extended: Frequently used advanced targeting questions that may be mapped by suppliers

  • Custom: Buyer Specific questions that are unlikely to be mapped by suppliers

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

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

Doc Link

 

 

 

 

 

 

 

 

 

 

 

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: