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": [
        123
      ],
      "geolocations": [
        123
      ],
      "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:*
​
platform
enum<string>
Available options:
de,
en,
fr,
es
​
offset
integer
default:0
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
Required range: x >= 1
​
date_from
string

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

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)
​
industry
enum<string>
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
​
premium
boolean | null
​
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)

Available options:
0,
1

Response

200
application/json

The request has succeeded.