DataForSEO
SEO, search-engine results, keyword research, backlinks and AI visibility data.
Get YouTube Subtitles Results by id
Retrieves a queued YouTube video subtitles 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_SerpYoutubeVideoSubtitlesTaskGetAdvancedResponseInfo200
- 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_SerpYoutubeVideoSubtitlesTaskGetAdvancedTaskInfo
- 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
- categoryType: string | null
the category the video belongs to
Note: this field is deprecated and always returnsnull - 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_subtitles - itemsType: array (object | null)[] | null
elements of search results found in SERP
- durationType: number | null
_time duration of subtitles in seconds
- endType: number | null
_time the second subtitled text ends
- 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 - startType: number | null
_time the second subtitled text starts
- textType: string | null
text translated in subtitles
- typeType: string | null
type of element
- 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
- originType: string | null
_language language code of original text
- 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
- subtitlesType: integer | null Format: int64
_count number of subtitles in the video
- titleType: string | null
title of the video
- translateType: string | null
_language language code of translated text
- unsupportedType: boolean | null
_language indicates whether the language is unsupported by the system
- 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_subtitles/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
],
"unsupported_language": null,
"translate_language": null,
"origin_language": null,
"category": null,
"subtitles_count": null,
"title": null,
"items_count": null,
"items": [
{
"type": null,
"rank_group": null,
"rank_absolute": null,
"text": null,
"start_time": null,
"end_time": null,
"duration_time": null
}
]
}
]
}
]
}