---
title: "GET /v1/data/consumer-insights"
method: GET
path: "/v1/data/consumer-insights"
---

# GET /v1/data/consumer-insights

`GET /v1/data/consumer-insights`

## Query parameters

- `rows` string, required
- `columns` string
- `filters` string
- `country` string
- `year` integer

## Response `200`

The request has succeeded.

- ApiResponseDataConsumerInsightsDataResponse
  - `identifier` ApiResponseDataIdentifier, required
    - `rows` string, required — A question or answer ID.
    - `columns` string — A question or answer ID.
    - `filters` string[] — The list of answer IDs used to filter the cross-table.
    - `survey_id` string, required — The survey ID, from which the data was taken to compute the cross-table
  - `title` string, required — What is the data about.
  - `subject` string, required — A short summary of what the data shows.
  - `description` string, required — A more comprehensive text, explaining the most important facts about the data.
  - `link` string, required — The website address (URL) where you can see the full content off the survey.
  - `date` string, required — The year when data was compiled. Format: YYYY.
  - `sources` string[], required — List of sources, from which was the data derived.
  - `interpretation_hint` string, required — Short description to help LLMs interpret the data.
  - `geolocations` ApiResponseDataGeoLocation[], required — The countries the data is covering.
    - `name` string, required — Country name.
    - `code` string, required — 3 letter, ISO 3166-1 alpha-3 country code.
  - `chart` ApiResponseDataChart, required
    - `description` string, required — A short text or headline that explains the the data.
    - `dataFormat` string, required — The name of the data format in the data poinsts, e.g. 'percentage'.
    - `valueUnit` string, required — Provided the unit/symbol of the numeric values, e.g. '%'.
    - `data` object, required — List of the actual numeric values in the cross-tabe.

## Other responses

- `400` — The server could not understand the request due to invalid syntax.
- `401` — Access is unauthorized.
- `403` — Access is forbidden.
- `404` — The server cannot find the requested resource.

---

[API](https://skmtc.net/statista/apis/the-statista-data-api.md) · [All operations](https://skmtc.net/statista/apis/the-statista-data-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/statista/the-statista-data-api/versions/68cf62a0dda1/schema)
