DataForSEO
SEO, search-engine results, keyword research, backlinks and AI visibility data.
Get YouTube Video Info Results by id
Retrieves a queued YouTube video info result by id. Returns keyword, type, se_domain, location_code, language_code, check_url, datetime, spell, refinement_chips, item_types, items_count and items. Wrapped in DataForSEO's envelope: data in tasks[0].result, outcome in tasks[0].status_code - a rejected request still returns HTTP 200.
Pricing reference
- Metering: Reported response cost.
- Reference request estimate: USD 0.02.
- Reference customer multiplier: 1.0. Do not apply it again to a settled customer amount.
Reference metadata only, not an account quote, a guaranteed price or a spending cap. Resource credits are not Felo credits. Final charges follow Felo billing records.
- Type: object | null · Response36Afe1097B20_SerpYoutubeVideoInfoTaskGetAdvancedResponseInfo200
- Type: number | null Format: doublecost
total tasks cost, USD
- Type: integer | nullstatus
_code general status code you can find the full list of the response codes here
- Type: string | nullstatus
_message general informational message you can find the full list of general informational messages here
- Type: array (object | null)[] | nulltasks
array of tasks
- Type: object | null · Response36Afe1097B20_SerpYoutubeVideoInfoTaskGetAdvancedTaskInfo
- costType: number | null Format: double
total tasks cost, USD
- dataType: object | null
contains the same parameters that you specified in the POST request
- propertyType: object | null
Name
- idType: string | null
task identifier unique task identifier in our system in the UUID format
- pathType: array (string | null)[] | null
URL path
- resultType: array (object | null)[] | null
array of results
- checkType: string | null
_url direct URL to search engine results
you can use it to make sure that we provided accurate results - datetimeType: string | null
date and time when the result was received
in the UTC format: “yyyy-mm-dd hh-mm-ss +00:00”
example:2019-11-15 12:57:46 +00:00 - itemType: array (string | null)[] | null
_types types of search results in SERP
contains types of search results (items) found in SERP.
possible item:youtube_video_info - itemsType: array (object | null)[] | null
elements of search results found in SERP
- categoryType: string | null
the category the video belongs to
- channelType: string | null
_id the ID of the channel where the video is published
- channelType: string | null
_logo the URL of the page where the logo image of the channel is hosted
- channelType: string | null
_name the name of the channel where the video is published
- channelType: object | null · Response36Afe1097B20_ChannelSubscribersCount
_subscribers _count number of subscribers of the channel
- countType: integer | null Format: int64
subscriber count
- displayedType: string | null
_count displayed subscriber count
subscriber count as displayed on YouTube
- channelType: string | null
_url the URL of the channel where the video is published
- commentsType: integer | null Format: int64
_count number of comments on the video
- descriptionType: string | null
description of the video
- durationType: string | null
_time duration of the video
- durationType: integer | null
_time _seconds duration of the video in seconds
- isType: boolean | null
_embeddable indicates whether the video is embeddable
- isType: boolean | null
_live indicates whether the video is on live
- keywordsType: array (string | null)[] | null
keywords relevant to the video
also known as 'YouTube tags' - likesType: integer | null Format: int64
_count number of likes on the video
- publicationType: string | null
_date the date when the video is published
- rankType: integer | null
_absolute absolute rank in SERP for the target domain
absolute position among all the elements in SERP - rankType: integer | null
_group group rank in SERP
position within a group of elements with identicaltypevalues
positions of elements with differenttypevalues are omitted fromrank_group - streamingType: array (object | null)[] | null
_quality array of elements that contain information about all possible streaming qualities of the video
- bitrateType: integer | null
- fpsType: integer | null
- heightType: integer | null
video height in pixels
- labelType: string | null
label of the quality element
- mimeType: string | null
_type - typeType: string | null
type of element
- widthType: integer | null Format: int64
video width in pixels
- subtitlesType: array (object | null)[] | null
array of elements describing properties of subtitles in the video
- isType: boolean | null
_auto _generated defines if subtitles are auto generated
- isType: boolean | null
_translatable defines if subtitles are translatable
- languageType: string | null
language of subtitles
- thumbnailType: string | null
_url the URL of the page where the thumbnail is hosted
- timestampType: string | null
date and time when the result is published
in the UTC format: “yyyy-mm-dd hh-mm-ss +00:00”
example:2022-11-15 12:57:46 +00:00 - titleType: string | null
title of the video
- typeType: string | null
type of element
- urlType: string | null
URL of the video
- videoType: string | null
_id ID of the video received in a POST array
- viewsType: integer | null Format: int64
_count number of views of the video
- itemsType: integer | null Format: int64
_count the number of results returned in the
itemsarray - languageType: string | null
_code language code in a POST array
- locationType: integer | null
_code location code in a POST array
- seType: string | null
_domain search engine domain in a POST array
- spellType: object | null · Response36Afe1097B20_SpellInfo
autocorrection of the search engine
if the search engine provided results for a keyword that was corrected, we will specify the keyword corrected by the search engine and the type of autocorrection- keywordType: string | null
keyword obtained as a result of search engine autocorrection the results will be provided for the corrected keyword
- typeType: string | null
type of autocorrection possible values: did_you_mean, showing_results_for, no_results_found_for, including_results_for note: Yahoo and Yandex support only the following autocorrection type: including_results_for
- videoType: string | null
_id ID of the video received in a POST array
- resultType: integer | null Format: int64
_count number of elements in the result array
- statusType: integer | null
_code status code of the task generated by DataForSEO, can be within the following range: 10000-60000 you can find the full list of the response codes here
- statusType: string | null
_message informational message of the task you can find the full list of general informational messages here
- timeType: string | null
execution time, seconds
- Type: integer | null Format: int64tasks
_count the number of tasks in the tasks array
- Type: integer | null Format: int64tasks
_error the number of tasks in the tasks array returned with an error
- Type: string | nulltime
total execution time, seconds
- Type: string | nullversion
the current version of the API
application/json - 400
The request could not be processed. Check the request parameters.
- 401
A valid Felo API key is required.
- 402
The request cannot proceed because a billing requirement is not met.
- 403
The account is not permitted to perform this operation.
- 429
A request or spending limit has been reached.
- 502
The service could not complete the request.
- 503
The API or billing service is temporarily unavailable.
- 504
The service timed out while processing the request.
- default
Error response; upstream passthrough responses may use provider formats
application/json
curl https://openapi.felo.ai/v1/beta/dataforseo/serp/youtube/video_info/task_get/advanced/00000000-0000-0000-0000-000000000000 \
--header 'Authorization: Bearer YOUR_SECRET_TOKEN'
{
"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
],
"items_count": null,
"items": [
{
"type": null,
"rank_group": null,
"rank_absolute": null,
"video_id": null,
"title": null,
"url": null,
"thumbnail_url": null,
"channel_id": null,
"channel_name": null,
"channel_url": null,
"channel_logo": null,
"description": null,
"views_count": null,
"likes_count": null,
"comments_count": null,
"channel_subscribers_count": "[Max Depth Exceeded]",
"publication_date": null,
"timestamp": null,
"keywords": [
"[Max Depth Exceeded]"
],
"category": null,
"is_live": null,
"is_embeddable": null,
"duration_time": null,
"duration_time_seconds": null,
"subtitles": [
"[Max Depth Exceeded]"
],
"streaming_quality": [
"[Max Depth Exceeded]"
]
}
]
}
]
}
]
}