DataForSEO
SEO, search-engine results, keyword research, backlinks and AI visibility data.
Get Video Subtitles SERP Completed Tasks
Lists finished YouTube video subtitles tasks awaiting collection. Free. Wrapped in DataForSEO's envelope: data in tasks[0].result, outcome in tasks[0].status_code - a rejected request still returns HTTP 200. ⚠️ Rarely needed: a caller holds the id its own submit returned and can fetch directly. This answers what is ready across the whole account.
Pricing reference
- Metering: Reported response cost.
- Reference request estimate: USD 0.012.
- 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_SerpYoutubeVideoSubtitlesTasksReadyResponseInfo200
- 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_SerpYoutubeVideoSubtitlesTasksReadyTaskInfo
- 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
- dateType: string | null
_posted date when the task was posted (in the UTC format)
- endpointType: string | null
_advanced URL for collecting the results of the SERP Advanced task
if SERP Advanced is not supported in the specified endpoint, the value will benull - endpointType: string | null
_html URL for collecting the results of the SERP HTML task
if SERP HTML is not supported in the specified endpoint, the value will benull - endpointType: string | null
_regular URL for collecting the results of the SERP Regular task
if SERP Regular is not supported in the specified endpoint, the value will benull - idType: string | null
- seType: string | null
search engine specified when setting the task
- seType: string | null
_type type of search engine
example:{{low_se_type_under}} - tagType: string | null
user-defined task identifier
- 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/tasks_ready \
--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": [
{
"id": null,
"se": null,
"se_type": null,
"date_posted": null,
"tag": null,
"endpoint_regular": null,
"endpoint_advanced": null,
"endpoint_html": null
}
]
}
]
}