get_shorts_analytics
Retrieve YouTube Analytics data filtered to Shorts content for your authenticated channel. Specify date range and metrics to analyze Shorts performance.
Instructions
Query YouTube Analytics restricted to Shorts for the authenticated channel. Applies filters=creatorContentType==SHORTS on top of the usual start_date/end_date/metrics/dimensions knobs.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| start_date | Yes | YYYY-MM-DD start date (inclusive). | |
| end_date | Yes | YYYY-MM-DD end date (inclusive). | |
| metrics | No | Comma-separated YouTube Analytics metrics. | views,estimatedMinutesWatched,averageViewDuration,subscribersGained |
| dimensions | No | Optional dimensions, e.g. 'day' for a time series. | |
| sort | No | ||
| max_results | No |
Implementation Reference
- src/youtube/client.ts:298-317 (helper)analyticsQuery() method on YouTubeClient that builds and sends the YouTube Analytics API request.
async analyticsQuery(params: { startDate: string; endDate: string; metrics: string; dimensions?: string; filters?: string; sort?: string; maxResults?: number; }): Promise<AnalyticsResponse> { return this.analyticsGet<AnalyticsResponse>("/reports", { ids: "channel==MINE", "start-date": params.startDate, "end-date": params.endDate, metrics: params.metrics, dimensions: params.dimensions, filters: params.filters, sort: params.sort, maxResults: params.maxResults ? String(params.maxResults) : undefined, }); }