Lookup

Get Questions

Deprecated. This endpoint will be sunset on January 15, 2027. Use the /data_sources/{data_source_id}/countries/{country_code}/questions resource API for updated question discovery. Search questions. The ID field of each returned question can be used in the /surveys/syndicated/timeseries endpoint as the question of interest or in the audience parameter to filter responses.

get/surveys/syndicated/questions

Request

Query parameters

country_codestring

Two letter ISO 3166-1 alpha-2 country code. This can be used in the country_code query parameter of multiple endpoints to limit results to the specific country.

Example:us

The two-letter ISO 3166-1 alpha-2 country code used to filter results. The available countries can be retrieved from the /surveys/syndicated/countries endpoint.

category_idstring
Example:brand

A category ID to filter results. Available categories can be retrieved from the /surveys/syndicated/categories endpoint.

entity_idstring
Example:morning_consult

An entity ID to filter results. Available entities can be retrieved from the /surveys/syndicated/entities endpoint.

querystring
Example:Morning Consult

Terms to search. This parameter supports partial matching, normalization, and other common search features.

page_sizeinteger
Example:50

The number of results to return per request. Additional results past the page size can be retrieved using a pagination token, if one is returned in the response.

pagination_tokenstring base64

A pagination token to use to get paginated results. For more details, see the section on Pagination.

Example:eyJxdWVyeSI6ImRvZ3MifQ==

Pagination token returned from previous calls to an endpoint. When provided, no other query parameters can be specified. For more details, please see the Pagination section.

Response

Questions

pagination_tokenstring base64

A pagination token to use to get paginated results. For more details, see the section on Pagination.

Example response

{
  "pagination_token": "eyJxdWVyeSI6ImRvZ3MifQ==",
  "questions": [
    {
      "id": "cbaad021-12b7-5cd2-9a0f-3ed556946d0d",
      "label": "Avon Usage Frequency",
      "text": "How often do you use or purchase something from the following? --- Avon",
      "country": {
        "code": "fr",
        "label": "France"
      },
      "category": {
        "id": "brand",
        "label": "Brand"
      },
      "responses": [
        {
          "id": "1",
          "label": "Several times a day"
        },
        {
          "id": "2",
          "label": "About once a day"
        },
        {
          "id": "3",
          "label": "A few times a week"
        },
        {
          "id": "4",
          "label": "About once a week"
        },
        {
          "id": "5",
          "label": "About once a month or less often"
        },
        {
          "id": "6",
          "label": "I do not have an account or do not use"
        }
      ],
      "entity": {
        "id": "avon",
        "label": "Avon"
      }
    }
  ]
}

Changes

No recorded changes to this operation across all 1 revision of this API.