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 字幕即時（進階）

計費參考

需要協助嗎？