YouTube Video Subtitles SERP POST

YouTube Subtitles SERP API provides data on all subtitles in the video you specify in the POST request. You will get data from the watching page containing subtitled text, its language, and duration in the video. This is the Standard method of data retrieval. It requires making separate POST and GET requests. Using this method, you can retrieve the results after our system collects them.

curl --location --request POST 'https://api.dataforseo.com/v3/serp/youtube/video_subtitles/task_post' \ --header 'Content-Type: application/json' \ --header 'Authorization: Basic Og==' \ --data-raw '[ { "language_name": "english", "location_name": "united states", "video_id": "q9kgv_nBkqU" } ]'

{ "version": "0.1.20241227", "status_code": 20000, "status_message": "Ok.", "time": "0.1446 sec.", "cost": 0.0018, "tasks_count": 1, "tasks_error": 0, "tasks": [ { "id": "04030945-8029-0066-0000-658764acd845", "status_code": 20100, "status_message": "Task Created.", "time": "0.0074 sec.", "cost": 0.0018, "result_count": 0, "path": [ "v3", "serp", "youtube", "video_subtitles", "task_post" ], "data": { "api": "serp", "function": "task_post", "se": "youtube", "se_type": "video_subtitles", "language_name": "english", "location_name": "united states", "video_id": "q9kgv_nBkqU", "device": "desktop", "os": "windows" }, "result": null } ] }

Request

Authorization

Send your HTTP requests with an

Authorization

header that contains the word Basic followed by a space and a base64-encoded string username:password

Example:

Authorization: Basic *****************

Body Params application/json

array of:

video_id

string

required

ID of the video. You can find video ID in the URL or ‘youtube_video’ item of YouTube Organic result

location_name

string

required

Full name of search engine location. You can find the supported locations in the DataForSEO documentation.

language_name

string

required

Full name of search engine language. You can find the supported languages in the DataForSEO documentation.

priority

enum<integer>

optional

Task priority.

Allowed values:

subtitles_language

string

optional

Language code of original text. you can get the language code from YouTube Video Info result.

subtitles_translate_language

enum<string>

optional

Language code of translated text.

Allowed values:

azayaksqamenarhyasafeubebnmybgbsbhocyhuvihawhtgllgelkagngugddafyzuiwigyiidgaisesityokkkncaqurwkyzh-Hantzh-Hanskocoxhkukmlolalvlnltlbmkmgmsmldvmtmimrmnunddenenlnonyorompafaplptpsrorusmsacebnsosrsisdskslsoswsutgthtatttetitstrtkuzugukurfilfifrhahihmnhrcssvsneeeoetstjvjakri

device

enum<string>

optional

Device type.

Allowed values:

desktopmobile

Default:

desktop

enum<string>

optional

Device operating system.

Allowed values:

windowsmacosandroidios

tag

string

optional

User-defined task identifier. You can use this parameter to identify the task and match it with the result.

postback_url

string

optional

Return URL for sending task results.

postback_data

enum<string>

optional

Postback_url datatype. Required field if you specify postback_url.

Allowed value:

advanced

pingback_url

string

optional

Notification URL of a completed task. When a task is completed we will notify you by GET request sent to the URL you have specified.

Examples

YouTube Video Subtitles SERP POST

Request

Responses