跳转到主要内容
GET
Get a YouTube video transcript

请求规范

  • 方法与路径: GET /apis/v1/social/accounts/{accountId}/youtube-captions
  • 可用状态: enabled
  • 请求 URL 模板: https://api.aisa.one/apis/v1/social/accounts/{accountId}/youtube-captions
  • accountId: path; 必填
  • videoId: query; 必填
  • language: query; 可选
  • format: query; 可选
  • refresh: 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.

路径参数

accountId
string
必填

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

Pattern: ^acc_[0-9A-Za-z]{22}$

查询参数

videoId
string
必填

The YouTube video id (the platformPostId on a synced external post).

language
string

BCP-47 language tag as YouTube labels the track. en also matches an en-GB track. Omit to take the best available track.

format
enum<string>
默认值:json

json returns timed cues; srt returns the raw SubRip body instead. text is present either way.

可用选项:
json,
srt
refresh
boolean
默认值:false

Re-download from YouTube instead of serving the stored copy. Spends 200 quota units.

响应

The transcript.

accountId
string

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

Pattern: ^acc_[0-9A-Za-z]{22}$
availableTracks
object[]

Every track on the video, so you can re-request another language. On a cached read this is the listing as it stood when we downloaded, so a language added to the video since then appears only after a refresh=true or when you request that language directly.

cues
object[]

Timed cues. Present when format is json. Auto-generated cues overlap in time by design (captions roll), so start can precede the previous cue's end.

fetchedAt
string<date-time>

When the stored copy was downloaded from YouTube.

language
string

The language of the returned track.

source
enum<string>

cache when served from our stored copy, youtube when this call spent the quota units.

可用选项:
cache,
youtube
srt
string

Raw SubRip body. Present when format is srt.

text
string

The whole transcript as one paragraph, no timings.

trackId
string

YouTube's own caption track id.

trackKind
enum<string>

asr is YouTube's auto-generated track; standard was uploaded by the channel.

可用选项:
asr,
standard
videoId
string