DataForSEO
SEO, search-engine results, keyword research, backlinks and AI visibility data.
ライブ 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.004 USD。
- 参照用の顧客乗数:1.0。確定済みの顧客金額に再適用しないでください。
参照用のメタデータのみであり、アカウントへの見積もり、保証された価格、支出上限ではありません。リソースクレジットは Felo クレジットではありません。最終的な請求は Felo の請求記録に従います。
- 型: array (object | null)[]
- depth型: integer | null
解析深度
任意フィールド
SERP 内の結果数
デフォルト値:20
最大値:200
注意: アカウントには、最大 20 件の結果を含む SERP ごとに課金されます。
そのため、検索エンジンが 20 件を超える結果を返した場合、深度を20より大きく設定すると追加料金がかかる可能性があります。
指定した深度がレスポンス内の結果数より大きい場合、その差額はアカウント残高に自動的に返金されます - device型: string | null
デバイスタイプ
任意フィールド
唯一の値:desktop - language型: string
_code 検索エンジンの言語コード
指定しない場合は必須フィールドlanguage_name
このフィールドを使用する場合、language_nameを指定する必要はありません
検索エンジンがサポートする言語とそのlanguage_code_by の一覧は、https://api.dataforseo.com/v3/serp/youtube/languagesに別途リクエストを送信して取得できます
例:enn - language型: string
_name 検索エンジンの言語の完全名
指定しない場合は必須フィールドlanguage_code
このフィールドを使用する場合、language_codeを指定する必要はありません
検索エンジンがサポートする言語とそのlanguage_nameの一覧は、https://api.dataforseo.com/v3/serp/youtube/languagesに別途リクエストを送信して取得できます
例:English - location型: integer
_code 検索エンジンのロケーションコード
指定しない場合は必須フィールドlocation_name_
このフィールドを使用する場合、location_nameを指定する必要はありません
検索エンジンがサポートするロケーションとそのlocation_codeの一覧は、https://api.dataforseo.com/v3/serp/youtube/locationsに別途リクエストを送信して取得できます
例:2840n - location型: string
_name 検索エンジンのロケーションの完全名
指定しない場合は必須フィールドlocation_code
このフィールドを使用する場合、location_codeを指定する必要はありません
検索エンジンがサポートするロケーションとそのlocation_nameの一覧は、https://api.dataforseo.com/v3/serp/youtube/locationsに別途リクエストを送信して取得できます
例:United States - os型: string | null
- tag型: string | null
ユーザー定義のタスク識別子
任意フィールド
文字数上限は 255 です
このパラメーターを使ってタスクを識別し、結果と照合できます
指定したtagの値は、レスポンスのdataオブジェクトに含まれます - video型: string
_id
- 型: object | null · Response36Afe1097B20_SerpYoutubeVideoCommentsLiveAdvancedResponseInfo200
- 型: number | null 形式: doublecost
タスクの総コスト(USD)
- 型: integer | nullstatus
_code 一般的なステータスコード レスポンスコードの完全な一覧はこちらです
- 型: string | nullstatus
_message 一般的な情報メッセージ 一般的な情報メッセージの完全な一覧はこちらです
- 型: array (object | null)[] | nulltasks
タスクの配列
- 型: object | null · Response36Afe1097B20_SerpYoutubeVideoCommentsLiveAdvancedTaskInfo
- cost型: number | null 形式: double
タスクの総コスト(USD)
- data型: object | null
POST リクエストで指定したものと同じパラメーターを含みます
- property型: object | null
Name
- id型: string | null
タスク識別子 当社システム内で UUID 形式の一意のタスク識別子
- path型: array (string | null)[] | null
URL パス
- result型: array (object | null)[] | null
結果の配列
- check型: string | null
_url 検索エンジン結果への直接 URL
正確な結果が提供されたことを確認するために使用できます - comments型: integer | null 形式: int64
_count 動画のコメント数
- datetime型: string | null
結果を受信した日時
UTC 形式:“yyyy-mm-dd hh-mm-ss +00:00”
例:2019-11-15 12:57:46 +00:00 - item型: array (string | null)[] | null
_types SERP の検索結果タイプ
SERP で見つかった検索結果のタイプ(items)を含みます。
指定可能なアイテム:youtube_comment - items型: array (object | null)[] | null
SERP で見つかった検索結果の要素
- author型: string | null
_name コメント作成者の名前
- author型: string | null
_thumbnail 作成者のチャンネルロゴがホストされているページの URL
- author型: string | null
_url 作成者のチャンネルの URL
- likes型: integer | null 形式: int64
_count コメントのいいね数
- publication型: string | null
_date 表示される公開日
- rank型: integer | null
_absolute ターゲットドメインの SERP における絶対ランク
SERP 内のすべての要素の中での絶対位置 - rank型: integer | null
_group SERP のグループ順位
同じtype値を持つ要素のグループ内での位置type値が異なる要素の位置はrank_groupから除外されます - reply型: integer | null 形式: int64
_count コメントへの返信数
- text型: string | null
コメントのテキスト
- timestamp型: string | null
結果が公開された日時
UTC 形式:“yyyy-mm-dd hh-mm-ss +00:00”
例:2022-11-15 12:57:46 +00:00 - type型: string | null
要素の種類
- items型: integer | null 形式: int64
_count items配列で返された結果数 - language型: string | null
_code POST 配列内の言語コード
- location型: integer | null
_code POST 配列内のロケーションコード
- se型: string | null
_domain 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
- title型: string | null
動画のタイトル
- video型: string | null
_id POST 配列で受信した動画の ID
- 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_comments/live/advanced \
--request POST \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
--data '[
{
"language_code": "en",
"location_code": 2840,
"video_id": "vQXvyV0zIP4"
}
]'
{
"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
],
"title": null,
"comments_count": null,
"items_count": null,
"items": [
{
"type": null,
"rank_group": null,
"rank_absolute": null,
"author_name": null,
"author_thumbnail": null,
"author_url": null,
"text": null,
"publication_date": null,
"timestamp": null,
"likes_count": null,
"reply_count": null
}
]
}
]
}
]
}