Data API / DataForSEO / SERP

Setting YouTube Video Info Tasks

Queues one YouTube video's metadata on YouTube, returning a task id in tasks[0].id. Wrapped in DataForSEO's envelope: data in tasks[0].result, outcome in tasks[0].status_code - a rejected request still returns HTTP 200. The live twin answers immediately and is simpler for a single query; queue when the batch would outlast a tool call.

Параметры

Параметров пути, запроса и заголовков нет.

Тело запроса

video_idstringОбязательный
ID of the video
location_namestringНеобязательный
Full name of search engine location
location_codeintegerНеобязательный
Search engine location code
language_namestringНеобязательный
Full name of search engine language
language_codestringНеобязательный
Search engine language code
devicestringНеобязательный
Device type; only desktop is supported
priorityintegerНеобязательный
Task priority
postback_urlstringНеобязательный
URL for sending task results
pingback_urlstringНеобязательный
Notification URL of a completed task
postback_datastringНеобязательный
Postback datatype; possible value: advanced

Пример запроса

curl -X POST "https://openapi.felo.ai/v1/beta/dataforseo/serp/youtube/video_info/task_post" \
  -H "Authorization: Bearer $FELO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "video_id": "<string>",
  "location_name": "<string>",
  "location_code": 0,
  "language_name": "<string>",
  "language_code": "<string>",
  "device": "<string>",
  "priority": 0,
  "postback_url": "<string>"
}'

Ответ

Поля ответа

versionstringНеобязательный
The current version of the API
status_codeintegerНеобязательный
General status code
status_messagestringНеобязательный
General informational message
timestringНеобязательный
Execution time, seconds
costnumberНеобязательный
Total tasks cost, USD
tasks_countintegerНеобязательный
The number of tasks in the tasks array
tasks_errorintegerНеобязательный
The number of tasks in the tasks array returned with an error
tasksstring[]Необязательный
Array of task objects
idstringНеобязательный
Task identifier in UUID format
status_codeintegerНеобязательный
Task status code
status_messagestringНеобязательный
Task status message
costnumberНеобязательный
Cost of the task, USD
result_countintegerНеобязательный
Number of elements in the result array