---
title: "1本の動画の視聴維持率の推移を取得する（消費なし）"
method: GET
path: "/api/v1/channels/{channelId}/analytics/videos/{videoId}/retention"
tags: ["channels"]
---

# 1本の動画の視聴維持率の推移を取得する（消費なし）

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

## Request

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

## Path parameters

- `channelId` string, required
- `videoId` string, required

## Query parameters

- `days` integer

## Response `200`

視聴維持率の推移と要約

- object
  - `channelId` string
  - `videoId` string
  - `title` string, nullable
  - `durationSec` integer, nullable
  - `range` object
    - `startDate` string
    - `endDate` string
  - `summary` object, nullable
    - `at10` number, nullable
    - `at25` number, nullable
    - `at50` number, nullable
    - `at75` number, nullable
    - `atEnd` number, nullable
    - `steepestDrops` object[]
      - `fromRatio` number
      - `toRatio` number
      - `fromSec` integer, nullable
      - `toSec` integer, nullable
      - `drop` number
  - `points` object[]
    - `ratio` number
    - `sec` integer, nullable
    - `audienceWatchRatio` number
    - `relativeRetentionPerformance` number, nullable

## Other responses

- `400`: videoId の形式が正しくない（code: validation_error）、またはチャンネルが 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)