get_analytics_timeseries
Fetch time-series analytics data for charts and dashboards. Analyze trends, monitor metrics like plays and views, and track video performance over customizable date ranges and intervals.
Instructions
Get time-series analytics data optimized for charts and visualizations. Use this when creating graphs, dashboards, or tracking trends over time.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| entry_id | No | Optional: Track single video's performance over time (e.g., '1_abc123'). Leave empty for platform-wide trends. | |
| from_date | Yes | Start date in YYYY-MM-DD format (e.g., '2024-01-01') | |
| interval | No | Time grouping for data points (default: 'days'). Use 'hours' for <7 day ranges, 'days' for monthly, 'weeks' for quarterly, 'months' for yearly views. Affects data granularity. | |
| metrics | No | Metrics to include (e.g., ['plays', 'views']) | |
| report_type | No | Report type (default: 'content') | |
| to_date | Yes | End date in YYYY-MM-DD format (e.g., '2024-01-31') |
Input Schema (JSON Schema)
{
"properties": {
"entry_id": {
"description": "Optional: Track single video's performance over time (e.g., '1_abc123'). Leave empty for platform-wide trends.",
"type": "string"
},
"from_date": {
"description": "Start date in YYYY-MM-DD format (e.g., '2024-01-01')",
"type": "string"
},
"interval": {
"description": "Time grouping for data points (default: 'days'). Use 'hours' for <7 day ranges, 'days' for monthly, 'weeks' for quarterly, 'months' for yearly views. Affects data granularity.",
"enum": [
"hours",
"days",
"weeks",
"months"
],
"type": "string"
},
"metrics": {
"description": "Metrics to include (e.g., ['plays', 'views'])",
"items": {
"type": "string"
},
"type": "array"
},
"report_type": {
"description": "Report type (default: 'content')",
"type": "string"
},
"to_date": {
"description": "End date in YYYY-MM-DD format (e.g., '2024-01-31')",
"type": "string"
}
},
"required": [
"from_date",
"to_date"
],
"type": "object"
}