---
title: "YouTube に上げた動画の実績を動画ごとに取得する（再生回数の多い順。消費なし）"
method: GET
path: "/api/v1/channels/{channelId}/analytics/videos"
tags: ["channels"]
---

# YouTube に上げた動画の実績を動画ごとに取得する（再生回数の多い順。消費なし）

`GET /api/v1/channels/{channelId}/analytics/videos`

## Request

- Base URL: `https://app.yukkurigen.com`
- URL: `https://app.yukkurigen.com/api/v1/channels/{channelId}/analytics/videos`
- Auth: one of:
  - HTTP bearer
  - HTTP bearer

## Path parameters

- `channelId` string, required

## Query parameters

- `days` integer
- `limit` integer

## Response `200`

動画ごとの実績

- object
  - `channelId` string
  - `range` object
    - `startDate` string
    - `endDate` string
  - `videos` object[]
    - `videoId` string
    - `title` string, nullable
    - `publishedAt` string, nullable
    - `durationSec` integer, nullable
    - `views` number
    - `watchTimeMinutes` number
    - `averageViewDurationSec` number
    - `averageViewPercentage` number
    - `likes` number
    - `comments` number
    - `shares` number
    - `subscribersGained` number
    - `projectId` string, nullable: この動画を作った YukkuriGen のプロジェクト
  - `note` string

## Other responses

- `400`: チャンネルが YouTube と連携されていない（code: youtube_not_connected）
- `401`: 未認証（code: unauthenticated）。YouTube 側の連携切れは code: invalid_grant / youtube_unauthorized
- `403`: 権限不足（projects:read / code: insufficient_scope）、または YouTube のアナリティクス権限が無い（code: insufficient_permissions。連携し直す）
- `404`: チャンネルが見つからない（code: not_found）
- `429`: YouTube API の上限（code: quota_exceeded）

---

[API](https://skmtc.dev/yukkurigen/apis/yukkurigen-ai-operated-api.md) · [All operations](https://skmtc.dev/yukkurigen/apis/yukkurigen-ai-operated-api/llms.txt) · [OpenAPI document](https://skmtc.dev/yukkurigen/apis/yukkurigen-ai-operated-api/revisions/ba5f36b016da?raw)