Skip to main content
GET
/
v1
/
search
/
statistics
cURL
curl --request GET \
  --url https://api.statista.ai/v1/search/statistics \
  --header 'x-api-key: <api-key>'
{
  "items": [
    {
      "identifier": 123,
      "title": "<string>",
      "link": "<string>",
      "date": "2023-11-07T05:31:56Z",
      "platform": "de",
      "subject": "<string>",
      "is_premium": true,
      "teaser_image_urls": [
        {
          "width": 123,
          "src": "<string>"
        }
      ],
      "description": "<string>",
      "industries": [
        {
          "name": "<string>",
          "id": 123
        }
      ],
      "geolocations": [
        {
          "name": "<string>",
          "code": "<string>",
          "id": 123
        }
      ]
    }
  ],
  "total_count": 123,
  "total_pages": 123
}
Semantically search Statistics using natural language or keywords.

Authorizations

​
x-api-key
string
header
required

Query Parameters

​
q
string
required

The query string to search for content. This parameter is multi-lingual.

Minimum string length: 1
​
offset
integer<uint32>
default:0

The number of items will be skipped before the first result. The default value for offset is 0. This is useful for pagination. Could be used in combination with size.

Required range: x >= 0
​
size
integer<uint32>
default:10

The max. value depends on which API Package you are using. The default value for size is 10. See API-Packages for more information.

An alias for size is limit

Required range: x >= 0
​
date_from
string<date-time>

The start date to search for content. The maximum search depth is limited to 20 years from today while the default is 3 months from today. Supported formats are

  • RFC 33939 (%Y-%m-%dT%H:%M:%S like in ISO 8601)
  • %Y-%m-%d %H:%M:%S - example 2024-03-07 12:45:38
  • %d.%m.%Y %H:%M:%S - example 03.07.2024 12:45:38
  • %Y/%m/%d %H:%M:%S - example 2024/03/07 12:45:38
  • %Y-%m-%d - example 2024-03-07 (in this case we assume 00:00:00 as time for Start and 23:59:59 for End)
  • %d.%m.%Y - example 03.07.2024 (in this case we assume 00:00:00 as time for Start and 23:59:59 for End)
  • %Y/%m/%d - example 2024/03/07 (in this case we assume 00:00:00 as time for Start and 23:59:59 for End)
​
date_to
string<date-time>

The end date to search for content. If not set, the current date is used. Supported formats are

  • RFC 33939 (%Y-%m-%dT%H:%M:%S like in ISO 8601)
  • %Y-%m-%d %H:%M:%S - example 2024-03-07 12:45:38
  • %d.%m.%Y %H:%M:%S - example 03.07.2024 12:45:38
  • %Y/%m/%d %H:%M:%S - example 2024/03/07 12:45:38
  • %Y-%m-%d - example 2024-03-07 (in this case we assume 00:00:00 as time for Start and 23:59:59 for End)
  • %d.%m.%Y - example 03.07.2024 (in this case we assume 00:00:00 as time for Start and 23:59:59 for End)
  • %Y/%m/%d - example 2024/03/07 (in this case we assume 00:00:00 as time for Start and 23:59:59 for End)
​
geolocation
object

Filters content based on a specific geographic location. Defaults to Worldwide which means all content. Use geolocation codes provided by the API documentation. For example, 1 for Worldwide, 2 for Africa, etc. Note: only one geolocation can be used at a time.

​
premium
boolean | null

Filters content based on its premium status. If set to true, only premium content is returned. If set to false, only free content is returned. If not set, both free and premium content is returned.

Response

The request has succeeded.

​
items
object[]
required

A list of results returned for the current request.

​
total_count
integer<uint32>
required

The total number of available items matching the request.

​
total_pages
integer<uint32>

The total number of pages available, based on the selected size parameter