DataForSEO
SEO, search-engine results, keyword research, backlinks and AI visibility data.
YouTube 字幕タスクの設定
YouTube 上の 1 本の動画の字幕トラックをキューに追加し、tasks[0].id でタスク id を返します。DataForSEO のエンベロープに包まれます。データは tasks[0].result、結果は tasks[0].status_code にあり、拒否されたリクエストでも HTTP 200 が返ります。ライブ版は即座に応答し、単一のクエリではより簡単です。バッチがツール呼び出しより長引く場合にキューを使ってください。
料金の参考情報
- 計量方式：報告されたレスポンスコスト。
- 参考リクエスト見積もり：USD 0.02。
- 参照用の顧客乗数：1.0。確定済みの顧客金額には再適用しないでください。
参考情報のメタデータであり、アカウントへの見積もり、保証された価格、支出上限ではありません。リソースクレジットは Felo クレジットではありません。最終的な請求は Felo の請求記録に従います。
- 型: array (object | null)[]
- device型: string | null
デバイスタイプ 任意フィールド 唯一の値: desktop
- language型: string | null
_code 検索エンジンの言語コード language_name を指定しない場合は必須フィールド このフィールドを使用する場合、language_name を指定する必要はありません 検索エンジンがサポートする言語とその language_code の一覧は、https://api.dataforseo.com/v3/serp/youtube/languages に別途リクエストを送信して取得できます 例: en
- language型: string | null
_name 検索エンジンの言語の完全名 language_code を指定しない場合は必須フィールド このフィールドを使用する場合、language_code を指定する必要はありません 検索エンジンがサポートする言語とその language_name の一覧は、https://api.dataforseo.com/v3/serp/youtube/languages に別途リクエストを送信して取得できます 例: English
- location型: integer | null
_code 検索エンジンのロケーションコード location_name を指定しない場合は必須フィールド このフィールドを使用する場合、location_name を指定する必要はありません 検索エンジンがサポートするロケーションとその location_code の一覧は、https://api.dataforseo.com/v3/serp/youtube/locations に別途リクエストを送信して取得できます 例: 2840
- location型: string | null
_name 検索エンジンのロケーションの完全名 location_code を指定しない場合は必須フィールド このフィールドを使用する場合、location_code を指定する必要はありません 検索エンジンがサポートするロケーションとその location_name の一覧は、https://api.dataforseo.com/v3/serp/youtube/locations に別途リクエストを送信して取得できます 例: United States
- os型: string | null
デバイスのオペレーティングシステム 任意フィールド 次の値から選択します: windows、macos デフォルト値: windows
- pingback型: string | null
_url 完了したタスクの通知 URL 任意フィールド タスクが完了すると、指定した URL に GET リクエストを送信して通知します ‘$id’ 文字列を $id 変数として、‘$tag’ を URL エンコードされた $tag 変数として使用できます。リクエストを送信する前に必要な値を設定します。 例: http://your-server.com/pingscript?id=$id http://your-server.com/pingscript?id=$id&tag=$tag 注意: pingback_url 内の特殊文字は URL エンコードされます。 たとえば、# 文字は %23 にエンコードされます。 詳細については、ヘルプセンターを参照してください
- postback型: string | null
_data postback_url のデータ型 postback_url を指定する場合は必須フィールド サーバーに送信されるデータ型に対応します 可能な値: advanced
- postback型: string | null
_url タスク結果送信用の返却 URL 任意フィールド タスクが完了すると、結果を gzip 形式で圧縮し、指定した postback_url に POST リクエストを送信します ‘$id’ 文字列を $id 変数として、‘$tag’ を URL エンコードされた $tag 変数として使用できます。リクエストを送信する前に必要な値を設定します。 例: http://your-server.com/postbackscript?id=$id http://your-server.com/postbackscript?id=$id&tag=$tag 注意: postback_url 内の特殊文字は URL エンコードされます。 たとえば、# 文字は %23 にエンコードされます。 詳細については、ヘルプセンターを参照してください
- priority型: integer | null
タスクの優先度 任意フィールド 次の値を指定できます: 1 – 通常の実行優先度（デフォルトで設定） 2 – 高い実行優先度 実行優先度の高いタスクには追加料金がかかります。 コストは料金ページで計算できます。
- subtitles型: string | null
_language 元のテキストの言語コード 言語コードは YouTube Video Info の結果から取得できます
- subtitles型: string | null
_translate _language 翻訳されたテキストの言語コード 可能な値: "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 です このパラメーターを使ってタスクを識別し、結果と照合できます 指定した tag の値は、レスポンスの data オブジェクトに含まれます
- video型: string
_id 動画の ID 必須フィールド 動画 ID は、URL または YouTube Organic 結果の 'youtube_video' 項目で確認できます 例: Y8Wu4rSNJms
- 型: object | null · Response36Afe1097B20_SerpYoutubeVideoSubtitlesTaskPostResponseInfo200
- 型: number | null 形式: doublecost
タスクの総コスト（USD）
- 型: integer | nullstatus
_code 一般的なステータスコード レスポンスコードの完全な一覧はこちらです
- 型: string | nullstatus
_message 一般的な情報メッセージ 一般的な情報メッセージの完全な一覧はこちらです
- 型: array (object | null)[] | nulltasks
タスクの配列
- 型: object | null · Response36Afe1097B20_SerpYoutubeVideoSubtitlesTaskPostTaskInfo
- cost型: number | null 形式: double
タスクの総コスト（USD）
- data型: object | null
POST リクエストで指定したものと同じパラメーターを含みます
- property型: object | null
Name
- id型: string | null
タスク識別子 当社システム内で UUID 形式の一意のタスク識別子
- path型: array (string | null)[] | null
URL パス
- result型: object | null
結果の配列。この場合、値は null になります
- result型: integer | null 形式: int64
_count result 配列内の要素数
- status型: integer | null
_code タスクのステータスコード DataForSEO によって生成され、次の範囲の値になります: 10000-60000 レスポンスコードの完全な一覧はこちらです
- status型: string | null
_message タスクの情報メッセージ 一般的な情報メッセージの完全な一覧はこちらです
- time型: string | null
実行時間（秒）
- 型: integer | null 形式: int64tasks
_count tasks 配列内のタスク数
- 型: integer | null 形式: int64tasks
_error エラーで返された tasks 配列内のタスク数
- 型: string | nulltime
合計実行時間（秒）
- 型: string | nullversion
API の現在のバージョン
application/json - 400
リクエストを処理できませんでした。リクエストパラメータを確認してください。
- 401
有効な Felo API キーが必要です。
- 402
請求要件が満たされていないため、リクエストを続行できません。
- 403
このアカウントにはこの操作を行う権限がありません。
- 429
リクエストまたは支出の上限に達しました。
- 502
サービスがリクエストを完了できませんでした。
- 503
API または請求サービスが一時的に利用できません。
- 504
リクエストの処理中にサービスがタイムアウトしました。
- default
エラーレスポンス。上流のパススルーレスポンスはプロバイダーの形式を使用する場合があります
application/json
curl https://openapi.felo.ai/v1/beta/dataforseo/serp/youtube/video_subtitles/task_post \
--request POST \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
--data '[
{
"language_code": "en",
"location_code": 2840,
"video_id": "Y8Wu4rSNJms"
}
]'
{
"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": null
}
]
}