{"id":15905,"date":"2022-11-21T16:52:35","date_gmt":"2022-11-21T16:52:35","guid":{"rendered":"https:\/\/docs_v3.dataforseo.com\/v3\/?page_id=15905"},"modified":"2025-03-19T16:18:46","modified_gmt":"2025-03-19T16:18:46","slug":"serp-youtube-video_subtitles-overview","status":"publish","type":"page","link":"https:\/\/docs.dataforseo.com\/v3\/serp-youtube-video_subtitles-overview\/","title":{"rendered":"serp\/youtube\/video_subtitles\/overview"},"content":{"rendered":"<div class=\"wpb-content-wrapper\"><p>[vc_row][vc_column][vc_column_text]<\/p>\n<h1 id=\"introduction\">YouTube Video Subtitles API: Overview<\/h1>\n    <div class=\"endpoint\">\n        <img decoding=\"async\" class=\"endpoint__icon\" src=\"https:\/\/docs.dataforseo.com\/v3\/wp-content\/themes\/dataforseo\/assets\/img\/icons\/checked-circle.svg\" alt=\"checked\">\n\n                    This API provides data on subtitles in the specified YouTube video            <\/div>\n    \n<p>YouTube Video Subtitles API provides data based on the <a href=\"\/v3\/serp\/youtube\/video_subtitles\/task_post\/\" rel=\"noopener noreferrer\" target=\"_blank\">YouTube Video Subtitles<\/a> search engine. We collect detailed information from the watching page about a subtitled text, its language, and duration in the video.<\/p>\n<p>The returned results are specific to the indicated video id parameter. You can always check the returned results accessing the <code>check_url<\/code> in the Incognito mode to make sure the received data is entirely relevant. <\/p>\n<p><strong>Note:<\/strong> YouTube SERP API provides results for <code>desktop<\/code> only. You can indicate the following OS that you would like to receive SERP results for when setting a task: Windows, macOS.<br \/>\n&nbsp;<br \/>\nSERP API makes use of <code>rank_group<\/code> and <code>rank_absolute<\/code> parameters that show search engine result\u2019s position among the group of elements or across all the elements in SERP respectively. Learn more about the difference between rank absolute and rank group <a href=\"https:\/\/dataforseo.com\/help-center\/rank-absolute-vs-rank-group\" target=\"_blank\" rel=\"noopener noreferrer\">in our help article.<\/a><\/p>\n<h3>Youtube Video Subtitles functions<\/h3>\n<p>&nbsp;<br \/>\n<a href=\"https:\/\/docs.dataforseo.com\/v3\/serp\/youtube\/video_subtitles\/live\/advanced\/\" rel=\"noopener noreferrer\" target=\"_blank\">Youtube Video Subtitles Advanced endpoint<\/a> provides data on the specified YouTube video, subtitles, and language.<\/p>\n<h3>Methods<\/h3>\n<p>&nbsp;<br \/>\nThe cost of using YouTube Video Subtitles endpoints depends on the selected method and priority of task execution. Available methods and priorities are described below.<\/p>\n<p>DataForSEO has two main methods to deliver SERP results: Standard and Live.<\/p>\n<p>If your system requires delivering instant results, <a href=\"https:\/\/docs.dataforseo.com\/v3\/serp\/youtube\/video_subtitles\/live\/advanced\/\" rel=\"noopener noreferrer\" target=\"_blank\">the Live method<\/a> is the best solution for you. Unlike the Standard method, this method doesn\u2019t require making separate <a href=\"https:\/\/docs.dataforseo.com\/v3\/serp\/youtube\/video_subtitles\/task_post\/\" rel=\"noopener noreferrer\" target=\"_blank\">POST<\/a> and <a href=\"\/v3\/serp\/youtube\/video_subtitles\/task_get\/advanced\/\" rel=\"noopener noreferrer\" target=\"_blank\">GET<\/a> requests to the corresponding endpoints.<\/p>\n<p>If you don\u2019t need to receive data in real-time, you can use <a href=\"\/v3\/serp\/youtube\/video_subtitles\/task_post\/\" rel=\"noopener noreferrer\" target=\"_blank\">the Standard method<\/a> of data retrieval. This method requires making separate POST and GET requests, but it\u2019s more affordable. Using this method, you can retrieve the results after our system collects them.<\/p>\n<p>Alternatively, you can specify <code>pingback_url<\/code> or <code>postback_url<\/code> when setting a task, and we will notify you on completion of tasks or send the results to you respectively. Note that if you use the <code>postback_url<\/code> field, the only function that will be applied for data retrieval is <code>advanced<\/code>.<\/p>\n<p>If you need to set several tasks, you can receive the list of <code>id<\/code> for all completed tasks using <a href=\"\/v3\/serp\/youtube\/video_subtitles\/tasks_ready\/\" rel=\"noopener noreferrer\" target=\"_blank\">&#8216;Tasks Ready&#8217; endpoint,<\/a> and then collect the results of each separate task using <a href=\"\/v3\/serp\/youtube\/video_subtitles\/task_get\/advanced\/\" rel=\"noopener noreferrer\" target=\"_blank\">&#8216;Task GET&#8217; endpoint.<\/a><\/p>\n<p>Learn more about task completion and obtaining a list of completed tasks in <a href=\"https:\/\/dataforseo.com\/help-center\/completed-tasks\" rel=\"noopener noreferrer\" target=\"_blank\">this help center article.<\/a> <\/p>\n<p>You can send up to 2000 POST and GET API calls per minute in total, with each POST call containing no more than 100 tasks. Contact us if you would like to raise the limit. <\/p>\n<h3>Priorities and cost<\/h3>\n<p>&nbsp;<br \/>\nThe Live method delivers results in real-time, and accordingly, the cost of requests made using this method will be the highest.<\/p>\n<p>The Standard method has two different priorities that stand for the relative speed of task execution and have different prices:<\/p>\n<p>1. Normal priority;<br \/>\n2. High priority.<\/p>\n<p>The cost can be calculated on the <a title=\"Pricing\" href=\"https:\/\/dataforseo.com\/pricing\/serp\/youtube-serp-api\" target=\"_blank\" rel=\"noopener noreferrer\">Pricing<\/a> page. To learn more about the cost of all SERP API methods, priorities, and additional parameters, please refer to <a href=\"https:\/\/dataforseo.com\/help-center\/serp-api-cost-explained\" target=\"_blank\" rel=\"noopener noreferrer\">this help article<\/a>.<\/p>\n<p>You can test YouTube Video Subtitles API for free using DataForSEO <a href=\"\/v3\/appendix\/sandbox\/\">Sandbox.<\/a><\/p>\n<p>[\/vc_column_text][\/vc_column][\/vc_row]<\/p>\n<\/div>","protected":false},"excerpt":{"rendered":"<p>[vc_row][vc_column][vc_column_text] YouTube Video Subtitles API: Overview This API provides data on subtitles in the specified YouTube video YouTube Video Subtitles API provides data based on the YouTube Video Subtitles search engine. We collect detailed information from the watching page about a subtitled text, its language, and duration in the video. The returned results are specific [&hellip;]<\/p>\n","protected":false},"author":11,"featured_media":0,"parent":0,"menu_order":0,"comment_status":"closed","ping_status":"closed","template":"template.php","meta":{"apibase_doc_request_yaml":"","apibase_doc_request_additional_yaml":"","apibase_doc_response_yaml":"","footnotes":""},"class_list":["post-15905","page","type-page","status-publish","hentry"],"_links":{"self":[{"href":"https:\/\/docs.dataforseo.com\/v3\/wp-json\/wp\/v2\/pages\/15905","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/docs.dataforseo.com\/v3\/wp-json\/wp\/v2\/pages"}],"about":[{"href":"https:\/\/docs.dataforseo.com\/v3\/wp-json\/wp\/v2\/types\/page"}],"author":[{"embeddable":true,"href":"https:\/\/docs.dataforseo.com\/v3\/wp-json\/wp\/v2\/users\/11"}],"replies":[{"embeddable":true,"href":"https:\/\/docs.dataforseo.com\/v3\/wp-json\/wp\/v2\/comments?post=15905"}],"version-history":[{"count":8,"href":"https:\/\/docs.dataforseo.com\/v3\/wp-json\/wp\/v2\/pages\/15905\/revisions"}],"predecessor-version":[{"id":21256,"href":"https:\/\/docs.dataforseo.com\/v3\/wp-json\/wp\/v2\/pages\/15905\/revisions\/21256"}],"wp:attachment":[{"href":"https:\/\/docs.dataforseo.com\/v3\/wp-json\/wp\/v2\/media?parent=15905"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}