{
  "service": "statista",
  "displayName": "Statista",
  "categories": [
    "Data"
  ],
  "authTypes": [
    "api_key"
  ],
  "auth": [
    {
      "type": "api_key",
      "label": "API Key",
      "placeholder": "STATISTA_API_KEY",
      "description": "Statista API key sent with the x-api-key header. Request or obtain access through the Statista API key page: https://docs.platform.statista.ai/start/request-api-key."
    }
  ],
  "homepageUrl": "https://www.statista.com",
  "actions": [
    {
      "id": "statista.get_statistic",
      "service": "statista",
      "name": "get_statistic",
      "description": "Retrieve chart data and metadata for a Statista statistic identifier.",
      "requiredScopes": [],
      "providerPermissions": [],
      "inputSchema": {
        "type": "object",
        "properties": {
          "id": {
            "type": "integer",
            "minimum": 1,
            "description": "The Statista statistic identifier to retrieve."
          }
        },
        "additionalProperties": false,
        "description": "Input parameters for reading Statista statistic data."
      },
      "outputSchema": {
        "type": "object",
        "properties": {
          "statistic": {
            "type": "object",
            "properties": {
              "identifier": {
                "type": "integer",
                "description": "The Statista statistic identifier."
              },
              "title": {
                "type": "string",
                "description": "The statistic title returned by Statista."
              },
              "subject": {
                "type": "string",
                "description": "The statistic subject summary."
              },
              "isPremium": {
                "type": "boolean",
                "description": "Whether Statista marks the statistic as premium content."
              },
              "description": {
                "anyOf": [
                  {
                    "type": "string",
                    "description": "The optional statistic description."
                  },
                  {
                    "type": "null"
                  }
                ]
              },
              "link": {
                "type": "string",
                "description": "The Statista web URL for the statistic."
              },
              "date": {
                "anyOf": [
                  {
                    "type": "string",
                    "description": "The statistic publication date when returned."
                  },
                  {
                    "type": "null"
                  }
                ]
              },
              "platform": {
                "type": "string",
                "description": "The Statista platform or locale value returned for the statistic."
              },
              "teaserImageUrls": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "width": {
                      "type": "integer",
                      "description": "The image width in pixels."
                    },
                    "src": {
                      "type": "string",
                      "minLength": 1,
                      "description": "The image URL returned by Statista."
                    }
                  },
                  "additionalProperties": false,
                  "description": "A Statista teaser image link."
                },
                "description": "The statistic teaser image URLs."
              },
              "chart": {
                "type": "object",
                "properties": {},
                "additionalProperties": true,
                "description": "The Statista chart object including graph type and data points."
              },
              "raw": {
                "type": "object",
                "properties": {},
                "additionalProperties": true,
                "description": "The raw statistic data response returned by Statista."
              }
            },
            "additionalProperties": false,
            "description": "A normalized Statista statistic data response."
          }
        },
        "additionalProperties": false,
        "description": "The response returned when reading statistic data."
      }
    },
    {
      "id": "statista.search_consumer_insights",
      "service": "statista",
      "name": "search_consumer_insights",
      "description": "Search Statista Consumer Insights survey questions and answer options.",
      "requiredScopes": [],
      "providerPermissions": [],
      "inputSchema": {
        "type": "object",
        "properties": {
          "q": {
            "type": "string",
            "minLength": 1,
            "maxLength": 1000,
            "description": "The natural language or keyword query sent to Statista."
          },
          "size": {
            "type": "integer",
            "minimum": 1,
            "maximum": 25,
            "description": "The maximum number of search results returned by Statista."
          }
        },
        "additionalProperties": false,
        "required": [
          "q"
        ],
        "description": "Input parameters for searching a Statista data family."
      },
      "outputSchema": {
        "type": "object",
        "properties": {
          "results": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "questionId": {
                  "type": "string",
                  "description": "The Statista question identifier."
                },
                "indicator": {
                  "type": "string",
                  "description": "The short question indicator."
                },
                "label": {
                  "type": "string",
                  "description": "The question text shown to survey respondents."
                },
                "questionType": {
                  "type": "string",
                  "description": "The Statista question type."
                },
                "metadata": {
                  "type": "object",
                  "properties": {},
                  "additionalProperties": true,
                  "description": "The Statista metadata object for the question."
                },
                "answersSubset": {
                  "type": "array",
                  "items": {
                    "type": "object",
                    "properties": {
                      "answerId": {
                        "type": "string",
                        "description": "The Statista answer identifier."
                      },
                      "label": {
                        "type": "string",
                        "description": "The answer label."
                      },
                      "order": {
                        "type": "integer",
                        "description": "The answer order returned by Statista."
                      },
                      "code": {
                        "type": "integer",
                        "description": "The numeric answer code returned by Statista."
                      },
                      "raw": {
                        "type": "object",
                        "properties": {},
                        "additionalProperties": true,
                        "description": "The raw answer object returned by Statista."
                      }
                    },
                    "additionalProperties": false,
                    "description": "A normalized Consumer Insights answer option."
                  },
                  "description": "The answer options returned in the search result."
                },
                "totalAnswers": {
                  "type": "integer",
                  "description": "The number of available answer options."
                },
                "raw": {
                  "type": "object",
                  "properties": {},
                  "additionalProperties": true,
                  "description": "The raw Consumer Insights result returned by Statista."
                }
              },
              "additionalProperties": false,
              "description": "A normalized Statista Consumer Insights search result."
            },
            "description": "The Consumer Insights question results."
          },
          "raw": {
            "type": "object",
            "properties": {},
            "additionalProperties": true,
            "description": "The raw Statista search response."
          }
        },
        "additionalProperties": false,
        "description": "A normalized Statista Consumer Insights search response."
      }
    },
    {
      "id": "statista.search_market_insights_indicators",
      "service": "statista",
      "name": "search_market_insights_indicators",
      "description": "Search Statista Market Insights indicators using natural language or keywords.",
      "requiredScopes": [],
      "providerPermissions": [],
      "inputSchema": {
        "type": "object",
        "properties": {
          "q": {
            "type": "string",
            "minLength": 1,
            "maxLength": 1000,
            "description": "The natural language or keyword query sent to Statista."
          },
          "size": {
            "type": "integer",
            "minimum": 1,
            "maximum": 25,
            "description": "The maximum number of search results returned by Statista."
          }
        },
        "additionalProperties": false,
        "required": [
          "q"
        ],
        "description": "Input parameters for searching a Statista data family."
      },
      "outputSchema": {
        "type": "object",
        "properties": {
          "items": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "identifier": {
                  "type": "string",
                  "description": "The Market Insights indicator identifier."
                },
                "title": {
                  "type": "string",
                  "description": "The indicator title returned by Statista."
                },
                "subject": {
                  "type": "string",
                  "description": "The indicator subject summary."
                },
                "description": {
                  "anyOf": [
                    {
                      "type": "string",
                      "description": "The indicator description when returned."
                    },
                    {
                      "type": "null"
                    }
                  ]
                },
                "link": {
                  "type": "string",
                  "description": "The Statista web URL for the indicator."
                },
                "updatedAt": {
                  "anyOf": [
                    {
                      "type": "string",
                      "description": "The indicator update date when returned."
                    },
                    {
                      "type": "null"
                    }
                  ]
                },
                "industries": {
                  "type": "array",
                  "items": {
                    "type": "object",
                    "properties": {},
                    "additionalProperties": true,
                    "description": "A Statista Market Insights industry object."
                  },
                  "description": "The industries covered by this indicator."
                },
                "coveredTimeframe": {
                  "anyOf": [
                    {
                      "type": "object",
                      "properties": {},
                      "additionalProperties": true,
                      "description": "The timeframe covered by this indicator when returned."
                    },
                    {
                      "type": "null"
                    }
                  ]
                },
                "coveredGeos": {
                  "anyOf": [
                    {
                      "type": "object",
                      "additionalProperties": {
                        "type": "string",
                        "description": "Geo name."
                      },
                      "description": "The geographic coverage map keyed by Statista geo code."
                    },
                    {
                      "type": "null"
                    }
                  ]
                },
                "marketType": {
                  "anyOf": [
                    {
                      "type": "string",
                      "description": "The indicator market type when returned."
                    },
                    {
                      "type": "null"
                    }
                  ]
                },
                "marketTypeDescription": {
                  "anyOf": [
                    {
                      "type": "string",
                      "description": "The indicator market type description when returned."
                    },
                    {
                      "type": "null"
                    }
                  ]
                },
                "raw": {
                  "type": "object",
                  "properties": {},
                  "additionalProperties": true,
                  "description": "The raw Market Insights indicator returned by Statista."
                }
              },
              "additionalProperties": false,
              "description": "A normalized Statista Market Insights indicator search result."
            },
            "description": "The Market Insights indicator results."
          },
          "totalCount": {
            "type": "integer",
            "description": "The total number of matching indicators."
          },
          "raw": {
            "type": "object",
            "properties": {},
            "additionalProperties": true,
            "description": "The raw Statista search response."
          }
        },
        "additionalProperties": false,
        "description": "A normalized Statista Market Insights indicator search response."
      }
    },
    {
      "id": "statista.search_statistics",
      "service": "statista",
      "name": "search_statistics",
      "description": "Search Statista statistics using natural language or keywords.",
      "requiredScopes": [],
      "providerPermissions": [],
      "inputSchema": {
        "type": "object",
        "properties": {
          "q": {
            "type": "string",
            "minLength": 1,
            "maxLength": 1000,
            "description": "The natural language or keyword query sent to Statista."
          },
          "offset": {
            "type": "integer",
            "minimum": 0,
            "description": "The number of results to skip before returning items."
          },
          "size": {
            "type": "integer",
            "minimum": 0,
            "description": "The maximum number of statistic search results returned by Statista."
          },
          "date_from": {
            "type": "string",
            "minLength": 1,
            "description": "A Statista-supported date filter such as YYYY-MM-DD or an ISO 8601 datetime."
          },
          "date_to": {
            "type": "string",
            "minLength": 1,
            "description": "A Statista-supported date filter such as YYYY-MM-DD or an ISO 8601 datetime."
          },
          "premium": {
            "type": "boolean",
            "description": "Whether to restrict statistic results to premium or free content."
          }
        },
        "additionalProperties": false,
        "description": "Input parameters for searching Statista statistics."
      },
      "outputSchema": {
        "type": "object",
        "properties": {
          "items": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "identifier": {
                  "type": "integer",
                  "description": "The Statista statistic identifier."
                },
                "title": {
                  "type": "string",
                  "description": "The statistic title returned by Statista."
                },
                "subject": {
                  "type": "string",
                  "description": "The statistic subject summary."
                },
                "isPremium": {
                  "type": "boolean",
                  "description": "Whether Statista marks the statistic as premium content."
                },
                "description": {
                  "anyOf": [
                    {
                      "type": "string",
                      "description": "The optional statistic description."
                    },
                    {
                      "type": "null"
                    }
                  ]
                },
                "link": {
                  "type": "string",
                  "description": "The Statista web URL for the statistic."
                },
                "date": {
                  "anyOf": [
                    {
                      "type": "string",
                      "description": "The statistic publication date when returned."
                    },
                    {
                      "type": "null"
                    }
                  ]
                },
                "platform": {
                  "type": "string",
                  "description": "The Statista platform or locale value returned for the statistic."
                },
                "teaserImageUrls": {
                  "type": "array",
                  "items": {
                    "type": "object",
                    "properties": {
                      "width": {
                        "type": "integer",
                        "description": "The image width in pixels."
                      },
                      "src": {
                        "type": "string",
                        "minLength": 1,
                        "description": "The image URL returned by Statista."
                      }
                    },
                    "additionalProperties": false,
                    "description": "A Statista teaser image link."
                  },
                  "description": "The statistic teaser image URLs."
                },
                "rankingScore": {
                  "anyOf": [
                    {
                      "type": "number",
                      "description": "The optional ranking score returned by Statista."
                    },
                    {
                      "type": "null"
                    }
                  ]
                },
                "raw": {
                  "type": "object",
                  "properties": {},
                  "additionalProperties": true,
                  "description": "The raw statistic search result returned by Statista."
                }
              },
              "additionalProperties": false,
              "description": "A normalized Statista statistic search result."
            },
            "description": "The statistic search results."
          },
          "totalCount": {
            "type": "integer",
            "description": "The total number of matching statistic results."
          },
          "took": {
            "anyOf": [
              {
                "type": "object",
                "properties": {},
                "additionalProperties": true,
                "description": "The optional Statista timing breakdown."
              },
              {
                "type": "null"
              }
            ]
          },
          "raw": {
            "type": "object",
            "properties": {},
            "additionalProperties": true,
            "description": "The raw Statista search response."
          }
        },
        "additionalProperties": false,
        "description": "A normalized Statista statistic search response."
      }
    }
  ]
}
