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

Authorizations

​
x-api-key
string
header
required

Query Parameters

​
q
string
default:*

The query string to search for content. Defaults to '*' which means all content.

​
platform
enum<string>

The platform to search for content. Defaults to en which means English.

Available options:
de,
en,
fr,
es
​
offset
integer
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
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
​
page
integer
default:1

The page number to return. The default value for page is 1. This is useful for pagination. Could be used in combination with size.

Required range: x >= 1
​
date_from
string

The start date to search for content.

​
date_to
string

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

​
industry
enum<string>

Filters content related to a specific industry. The value is a number that can be found in the URL.

Available options:
https://www.statista.com/api/v2/industries_de.json,
https://www.statista.com/api/v2/industries_en.json,
https://www.statista.com/api/v2/industries_es.json,
https://www.statista.com/api/v2/industries_fr.json
​
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.

​
sort
enum<number>

Choose how you want the results to be ordered: 0 – Best match first (sorted by relevance) 1 – Most recent first (sorted by publication date) Defaults to 0.

Available options:
0,
1

Response

200
application/json

The request has succeeded.