Sensor TowerInstall

Summary

Retrieve historical category data for specified apps filtered by category, chart type, countries, date range, and granularity.

Inputs

• OS (required) — Select the operating system platform: iOS or Android.
• App IDs (comma-separated) (required) — Comma-separated list of application IDs to query.
• Category (required) — Category name to filter the category history data.
• Chart Type IDs (comma-separated) (required) — Comma-separated list of chart type IDs specifying which charts to include.
• Countries (comma-separated) (required) — Comma-separated list of country codes to filter the data geographically.
• Start Date (YYYY-MM-DD) — Optional start date to specify the beginning of the data range.
• End Date (YYYY-MM-DD) — Optional end date to specify the end of the data range.
• Is Hourly — Boolean flag to return data at hourly intervals; defaults to false if omitted.

Output shape

a single JSON object containing the retrieved category history data for the specified parameters

The output JSON structure depends on the Sensor Tower API's response format for the category history endpoint. Date parameters are optional; omitting them retrieves the default data range. The 'Is Hourly' input controls data granularity and defaults to daily if false or omitted.

Examples

Example 1: Fetch daily iOS category history for multiple apps in specified countries and chart types over a defined date range.

OS set to iOS; App IDs provided as a comma-separated string; Category specified; Chart Type IDs and Countries provided as comma-separated strings; Start and End Dates included; Is Hourly set to false or omitted.