跳转到主要内容
GET
Get YouTube video retention curve

请求规范

  • 方法与路径: GET /apis/v1/social/analytics/youtube/video-retention
  • 可用状态: enabled
  • 请求 URL 模板: https://api.aisa.one/apis/v1/social/analytics/youtube/video-retention
  • videoId: query; 必填
  • accountId: query; 必填
  • fromDate: query; 可选
  • toDate: query; 可选
  • startDate: query; 可选
  • endDate: query; 可选
  • Runtime 事实版本: 99acb5bddbedc8d3352e7c4fef86c3e6d8852c14772bcd18dbcf415237a642bd
完整 OpenAPI 定义 有效请求与价格声明(包括认证和引用的 schema):

费用与请求规则

当前未提供请求参考价格;请使用接口支持的报价功能确认费用。 最终费用以账户适用价格及实际结算为准。 公开参考值不是你的账户报价或最终扣费。对于支持 X-AISA-Cost-Mode: quote 的接口,执行前请针对完整请求获取免费报价;执行后通过响应费用元数据和 Usage Logs 核对结算费用。1 USD 等于 1,000,000 个整数 micro-USD。

授权

Authorization
string
header
必填

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

查询参数

videoId
string
必填

The YouTube video ID (e.g., "dQw4w9WgXcQ")

accountId
string
必填

One of your social accounts (acc_...).

Pattern: ^acc_[0-9A-Za-z]{22}$
fromDate
string<date>

Start date (YYYY-MM-DD). Defaults to the video's publish date (lifetime curve).

toDate
string<date>

End date (YYYY-MM-DD). Defaults to 3 days ago, the newest fully finalized day (YouTube finalizes analytics with a ~3-day delay). An explicit toDate is honored up to today: days inside the delay window are provisional and may still be revised by YouTube (see provisionalSince in the response).

startDate
string<date>

Alias of fromDate, kept for existing callers

endDate
string<date>

Alias of toDate, kept for existing callers

响应

Audience retention curve

accountId
string

One of your social accounts (acc_...).

Pattern: ^acc_[0-9A-Za-z]{22}$
dateRange
object
durationSeconds
integer | null

Video length in seconds (from YouTube contentDetails.duration)

note
string

Present only when the curve is empty, explaining why

provisionalSince
string<date>

Present only when the range reaches into YouTube's ~3-day processing window: the first date whose numbers are provisional and may still be revised by YouTube.

publishedAt
string<date-time> | null

When the video was published on YouTube

retentionCurve
object[]

Up to 100 points covering the video timeline, aggregated over the date range. Can be empty when YouTube has no retention data for the video in the given range.

scopeStatus
object
success
boolean
title
string | null

Video title

videoId
string

The YouTube video ID