v0.2.0-beta

OpenAPI 3.1.0

YouTube 字幕实时（高级）

Felo API Support

MIT

服务器

https://openapi.felo.ai

客户端库

Shell Curl

DataForSEO

SEO, search-engine results, keyword research, backlinks and AI visibility data.

DataForSEO 操作

post/v1/beta/dataforseo/serp/youtube/video_subtitles/live/advanced

YouTube 字幕实时（高级）

同步返回一个 YouTube 视频在 YouTube 上的字幕轨道。返回 keyword、type、se_domain、location_code、language_code、check_url、datetime、spell、refinement_chips、item_types、items_count 和 items。advanced 是默认选项；如果只关心排名列表，请使用 regular；如果只想检查解析器丢弃了什么，请使用 html。采用 DataForSEO 的信封结构：数据位于 tasks[0].result，结果状态位于 tasks[0].status_code——被拒绝的请求仍会返回 HTTP 200。

计费参考

计量方式：按上报的响应成本计量。
参考请求估算：0.02 美元。
参考客户倍率：1.0。不得对已结算的客户金额再次应用。

仅供参考的元数据，不是账户报价、保证价格或消费上限。资源额度不同于 Felo 额度。最终扣费以 Felo 计费记录为准。

请求体

application/json

类型: array (object | null)[]
- device
  类型: string | null
  
  设备类型可选字段唯一值：desktop
- language_code
  类型: string | null
  
  搜索引擎语言代码未指定 language_name 时为必填字段如果使用此字段，则无需指定 language_name 可单独向 https://api.dataforseo.com/v3/serp/youtube/languages 发起请求，获取搜索引擎支持的语言及其 language_code 列表示例： en
- language_name
  类型: string | null
  
  搜索引擎语言全名未指定 language_code 时为必填字段如果使用此字段，则无需指定 language_code 可单独向 https://api.dataforseo.com/v3/serp/youtube/languages 发起请求，获取搜索引擎支持的语言及其 language_name 列表示例： English
- location_code
  类型: integer | null
  
  搜索引擎地点代码未指定 location_name 时为必填字段如果使用此字段，则无需指定 location_name 可单独向 https://api.dataforseo.com/v3/serp/youtube/locations 发起请求，获取搜索引擎支持的地点及其 location_code 列表示例： 2840
- location_name
  类型: string | null
  
  搜索引擎地点全名未指定 location_code 时为必填字段如果使用此字段，则无需指定 location_code 可单独向 https://api.dataforseo.com/v3/serp/youtube/locations 发起请求，获取搜索引擎支持的地点及其 location_name 列表示例： United States
- os
  类型: string | null
  
  设备操作系统可选字段请从以下值中选择：windows、macos 默认值：windows
- subtitles_language
  类型: string | null
  
  原始文本的语言代码你可以从 YouTube Video Info 结果中获取语言代码
- subtitles_translate_language
  类型: string | null
  
  译文语言代码可能的值： "az", "ay", "ak", "sq", "am", "en", "ar", "hy", "as", "af", "eu", "be", "bn", "my", "bg", "bs", "bho", "cy", "hu", "vi", "haw", "ht", "gl", "lg", "el", "ka", "gn", "gu", "gd", "da", "fy", "zu", "iw", "ig", "yi", "id", "ga", "is", "es", "it", "yo", "kk", "kn", "ca", "qu", "rw", "ky", "zh-Hant", "zh-Hans", "ko", "co", "xh", "ku", "km", "lo", "la", "lv", "ln", "lt", "lb", "mk", "mg", "ms", "ml", "dv", "mt", "mi", "mr", "mn", "und", "de", "ne", "nl", "no", "ny", "or", "om", "pa", "fa", "pl", "pt", "ps", "ro", "ru", "sm", "sa", "ceb", "nso", "sr", "si", "sd", "sk", "sl", "so", "sw", "su", "tg", "th", "ta", "tt", "te", "ti", "ts", "tr", "tk", "uz", "ug", "uk", "ur", "fil", "fi", "fr", "ha", "hi", "hmn", "hr", "cs", "sv", "sn", "ee", "eo", "et", "st", "jv", "ja", "kri"
- tag
  类型: string | null
  
  用户自定义任务标识符可选字段字符数上限为 255 可使用此参数标识任务，并将其与结果对应可在响应的 data 对象中找到指定的 tag 值
- video_id
  类型: string
  
  视频 ID 必填字段可在 URL 或 YouTube Organic 结果的 'youtube_video' 项中找到视频 ID 示例： Y8Wu4rSNJms

响应

200
类型: object | null · Response36Afe1097B20_SerpYoutubeVideoSubtitlesLiveAdvancedResponseInfo
cost
类型: number | null 格式: double

任务总费用，美元

status_code
类型: integer | null

通用状态码完整响应码列表见此处

status_message
类型: string | null

通用信息性消息完整的一般信息性消息列表见此处

tasks
类型: array (object | null)[] | null

任务数组

类型: object | null · Response36Afe1097B20_SerpYoutubeVideoSubtitlesLiveAdvancedTaskInfo
cost
类型: number | null 格式: double

任务总费用，美元

data
类型: object | null

包含你在 POST 请求中指定的相同参数

propertyName
类型: object | null
id
类型: string | null

任务标识符我们系统中 UUID 格式的唯一任务标识符

path
类型: array (string | null)[] | null

URL 路径

result
类型: array (object | null)[] | null

结果数组

category
类型: string | null

视频所属类别。注意：此字段已弃用，始终返回 null

check_url
类型: string | null

搜索引擎结果的直接 URL，你可以用它确认我们提供的结果准确无误

datetime
类型: string | null

收到结果时的日期和时间。采用 UTC 格式：“yyyy-mm-dd hh-mm-ss +00:00”。示例：2019-11-15 12:57:46 +00:00

item_types
类型: array (string | null)[] | null

SERP 中的搜索结果类型。包含在 SERP 中找到的搜索结果类型（items）。可能的条目：youtube_subtitles

items
类型: array (object | null)[] | null

在 SERP 中找到的搜索结果元素

duration_time
类型: number | null

字幕时长（秒）

end_time
类型: number | null

字幕文本结束的秒数

rank_absolute
类型: integer | null

目标域名在 SERP 中的绝对排名
SERP 中所有元素中的绝对位置

rank_group
类型: integer | null

SERP 中的组内排名
在具有相同 type 值的元素组内的位置
具有不同 type 值的元素位置不包含在 rank_group 中

start_time
类型: number | null

字幕文本开始的秒数

text
类型: string | null

字幕中翻译的文本

type
类型: string | null

元素类型

items_count
类型: integer | null 格式: int64

items 数组中返回的结果数

language_code
类型: string | null

POST 数组中的语言代码

location_code
类型: integer | null

POST 数组中的地点代码

origin_language
类型: string | null

原文的语言代码

se_domain
类型: string | null

POST 数组中的搜索引擎域名

spell
类型: object | null · Response36Afe1097B20_SpellInfo

搜索引擎的自动更正。如果搜索引擎返回的是更正后关键词的结果，我们会注明搜索引擎更正的关键词以及自动更正的类型

keyword
类型: string | null

搜索引擎自动更正后得到的关键词将为更正后的关键词提供结果

type
类型: string | null

自动更正的类型可能的值： did_you_mean、showing_results_for、no_results_found_for、including_results_for 注意：Yahoo 和 Yandex 仅支持以下自动更正类型： including_results_for

subtitles_count
类型: integer | null 格式: int64

视频的字幕数量

title
类型: string | null

视频标题

translate_language
类型: string | null

译文的语言代码

unsupported_language
类型: boolean | null

指示该语言是否不受系统支持

video_id
类型: string | null

POST 数组中收到的视频 ID

result_count
类型: integer | null 格式: int64

result 数组中的元素数

status_code
类型: integer | null

任务的状态码由 DataForSEO 生成，范围如下：10000-60000 完整响应码列表见此处

status_message
类型: string | null

任务的信息性消息完整的一般信息性消息列表见此处

time
类型: string | null

执行时间，秒

tasks_count
类型: integer | null 格式: int64

tasks 数组中的任务数

tasks_error
类型: integer | null 格式: int64

tasks 数组中返回错误的任务数

time
类型: string | null

总执行时间，秒

version
类型: string | null

API 的当前版本
application/json
400

无法处理该请求。请检查请求参数。
401

需要有效的 Felo API 密钥。
402

由于未满足计费要求，请求无法继续。
403

该账户无权执行此操作。
429

已达到请求或支出限额。
502

服务无法完成该请求。
503

API 或计费服务暂时不可用。
504

服务在处理请求时超时。
default

错误响应；上游透传响应可能采用提供方格式

application/json

post/v1/beta/dataforseo/serp/youtube/video_subtitles/live/advanced

curl https://openapi.felo.ai/v1/beta/dataforseo/serp/youtube/video_subtitles/live/advanced \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '[
  {
    "language_code": "en",
    "location_code": 2840,
    "video_id": "Y8Wu4rSNJms"
  }
]'

显示 Schema

{
  "version": null,
  "status_code": null,
  "status_message": null,
  "time": null,
  "cost": null,
  "tasks_count": null,
  "tasks_error": null,
  "tasks": [
    {
      "id": null,
      "status_code": null,
      "status_message": null,
      "time": null,
      "cost": null,
      "result_count": null,
      "path": [
        null
      ],
      "data": null,
      "result": [
        {
          "video_id": null,
          "se_domain": null,
          "location_code": null,
          "language_code": null,
          "check_url": null,
          "datetime": null,
          "spell": {
            "keyword": null,
            "type": null
          },
          "item_types": [
            null
          ],
          "unsupported_language": null,
          "translate_language": null,
          "origin_language": null,
          "category": null,
          "subtitles_count": null,
          "title": null,
          "items_count": null,
          "items": [
            {
              "type": null,
              "rank_group": null,
              "rank_absolute": null,
              "text": null,
              "start_time": null,
              "end_time": null,
              "duration_time": null
            }
          ]
        }
      ]
    }
  ]
}

操作成功

需要帮助？

API、计费或账号问题，请联系支持。
在 Discord 上与 Felo 开发者交流。
查看我们的更新日志。
需要批量定价或采购支持？联系销售。
正在使用 LLM 构建？阅读 llms.txt。

YouTube 字幕实时（高级）

身份验证Required

DataForSEO

YouTube 字幕实时（高级）

计费参考

需要帮助？