Skip to main content
GET
/
v1
/
search
/
consumer-insights
cURL
curl --request GET \
  --url https://api.statista.ai/v1/search/consumer-insights \
  --header 'x-api-key: <api-key>'
{
  "results": [
    {
      "question_id": "<string>",
      "indicator": "<string>",
      "label": "<string>",
      "question_type": "<string>",
      "metadata": {
        "min_year": 123,
        "max_year": 123
      },
      "answers_subset": [
        {
          "answer_id": "<string>",
          "label": "<string>",
          "order": 123,
          "code": 123
        }
      ],
      "total_answers": 123
    }
  ]
}
Semantically search in Consumer Insights survey data for questions and answers. The results are grouped by question. If only an answer matches, the corresponding question is added to the result. The search works best with short search terms that cover only one aspect, such as “gen z” or “headphone brands”. Filtering by country can be done when the actual survey cross-table data is fetched, by providing a geo location. Adding a country to the search query degrades result quality.

Authorizations

​
x-api-key
string
header
required

Query Parameters

​
q
string
required

The query string to search for.

Required string length: 1 - 1000
​
size
integer<uint32>
default:10

The maximum number of search results returned.

Required range: 1 <= x <= 25

Response

The request has succeeded.

​
results
object[]
required