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

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:

  • 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

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

/wiki/spaces/PD/pages/2784591918

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: