Sign in
Serp

Changed on

Live YouTube Video Info provides real-time data on the video you specify in the request. You will get data from the watching page containing key video and content metrics as well as the channel where the video is published. for more info please visit 'https://docs.dataforseo.com/v3/serp/youtube/video_info/live/advanced/?bash'

post/v3/serp/youtube/video_info/live/advanced

Request

  • Base URL: https://api.dataforseo.com
  • URL: https://api.dataforseo.com/v3/serp/youtube/video_info/live/advanced
  • Auth: HTTP basic

Request body

video_idstring

ID of the video required field you can find video ID in the URL or 'youtube_video' item of YouTube Organic result example: vQXvyV0zIP4

location_codeinteger nullable

search engine location code required field if you don't specify location_name  if you use this field, you don't need to specify location_name you can receive the list of available locations of the search engines with their location_code by making a separate request to the https://api.dataforseo.com/v3/serp/youtube/locations example: 2840

language_codestring nullable

search engine language code required field if you don't specify language_name if you use this field, you don't need to specify language_name you can receive the list of available languages of the search engine with their language_code by making a separate request to the https://api.dataforseo.com/v3/serp/youtube/languages example: en

devicestring nullable

device type optional field only value: desktop

location_namestring nullable

full name of search engine location required field if you don't specify location_code if you use this field, you don't need to specify location_code you can receive the list of available locations of the search engine with their location_name by making a separate request to the https://api.dataforseo.com/v3/serp/youtube/locations example: United States

language_namestring nullable

full name of search engine language required field if you don't specify language_code if you use this field, you don't need to specify language_code you can receive the list of available languages of the search engine with their language_name by making a separate request to the https://api.dataforseo.com/v3/serp/youtube/languages example: English

osstring nullable

device operating system optional field choose from the following values: windows, macos default value: windows

tagstring nullable

user-defined task identifier optional field the character limit is 255 you can use this parameter to identify the task and match it with the result you will find the specified tag value in the data object of the response

Example request

[
  {
    "language_code": "en",
    "location_code": 2840,
    "video_id": "vQXvyV0zIP4"
  }
]

Response

Successful operation

versionstring nullable

the current version of the API

status_codeinteger nullable

general status code you can find the full list of the response codes here

status_messagestring nullable

general informational message you can find the full list of general informational messages here

timestring nullable

total execution time, seconds

costnumber double nullable

total tasks cost, USD

tasks_countinteger nullable

the number of tasks in the tasks array

tasks_errorinteger nullable

the number of tasks in the tasks array returned with an error

Changes

  • be20fca9d9ccRevision changes
    • info

      api operation id SerpYoutubeVideoInfoLiveAdvanced removed and replaced with YoutubeVideoInfoLiveAdvanced

  • e73495840d61Revision changes
    • info

      api operation id YoutubeVideoInfoLiveAdvanced removed and replaced with SerpYoutubeVideoInfoLiveAdvanced