Lookup

Get Entities

Deprecated. This endpoint will be sunset on January 15, 2027. Use the /entities resource API for updated entity discovery. Search tracked entities (e.g., brands, products, public figures, issues) for a specific country. Queries are run against the entity.label field of all questions included in our syndicated surveys. Wildcard search is supported.

get/surveys/syndicated/entities

Request

Query parameters

country_codestring required

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_type_idstring
Example:favorability

An entity type ID to filter results.

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.

querystring
Example:Morning Consult

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

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

Entities

pagination_tokenstring base64

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

Example response

{
  "entities": [
    {
      "id": "autotrader",
      "label": "Autotrader"
    }
  ],
  "pagination_token": "eyJxdWVyeSI6ImRvZ3MifQ=="
}

Changes

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