Skip to main content
For applications which have existing country, language, or qualification concepts, an initial mapping exercise must be performed and mapped relationships stored. Integrations which solely leverage the Research Desk concepts and attributes, most typically stateless front-end applications which expose all available parameter values directly to users, do not require mapping.

​
Countries, Languages, and Other Definitions

With a single, customizable Definitions endpoint, the Research Desk Demand API exposes all available parameter values necessary to create and manipulate projects, surveys, and responses. It is recommended to maintain a mapping database table storing Research Desk value associations with all applicable objects or definitions within your application. It is recommended to call the Definitions endpoint at least monthly, identify any available parameter values for which there is no stored mapping, and update your mapping table accordingly.

​
Respondent Qualifications

Qualifications, also often referred to as respondent profiling or screening criteria, are used to target specific audiences in order to achieve your research goals, e.g. Males and Females aged 35+ in the State of Illinois. In order to create and launch a survey, respondent Qualifications must be defined as part of the Survey creation. The Qualifications endpoint exposes all available Qualifications. A monthly assessment and mapping exercise is recommended. The following qualifications are recommended to be initially mapped: All Markets:
  • Age | id=1
  • Gender | id=2
  • Household Income | id=73
  • Employment Status | id=17
US Specific Qualifications:
  • Geography:
    • Postal Code/ZIP | id=3
    • State | id=5
    • US Census Region | id=8
    • DMA | id=6
      • Designated Market Area is most commonly used to target major cities/metro areas.
  • Demographics:
    • Hispanic/Latino Descent | id = 4
    • Ethnicity | id=8
**Other Qualifications: ** Research Desk offers a comprehensive set of qualifications beyond what is listed above. Please keep in mind that layering too many Qualifications onto a single survey, or creating too narrow a target audience may impact feasibility of your Project. A .csv of all Respondent Qualifications available by Country can be downloaded from the Research Desk UI on the Qualifications page.