get_analytics
Retrieve structured analytics data in table format to generate reports, compare metrics, rank content, and analyze performance. Supports 60+ report types, including video performance and user engagement. Use for exporting insights and filtering by date, category, or dimension.
Instructions
Get detailed analytics in TABLE format for reporting. USE WHEN: Creating reports, comparing metrics, ranking content, analyzing performance, exporting data. RETURNS: Structured data with headers/rows. EXAMPLES: 'Show top 10 videos by views', 'Compare user engagement by category', 'Export monthly performance report'. Use list_analytics_capabilities to see all 60+ report types. For charts/graphs, use get_analytics_timeseries instead.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| categories | No | Optional category filter | |
| dimension | No | Optional dimension for grouping (e.g., 'device', 'country') | |
| entry_id | No | Optional: Filter analytics for specific video (e.g., '1_abc123'). Leave empty for all content. | |
| from_date | Yes | Start date in YYYY-MM-DD format (e.g., '2024-01-01') | |
| limit | No | Max results per page (default: 50) | |
| report_type | No | Type of analytics report (default: 'content'). Common options: 'content' (video performance), 'user_engagement' (viewer behavior), 'geographic' (location data), 'platforms' (device/OS breakdown). Run list_analytics_capabilities for all 60+ types. | |
| to_date | Yes | End date in YYYY-MM-DD format (e.g., '2024-01-31') | |
| user_id | No | Optional user ID for user-specific reports |