{"id":15909,"date":"2022-11-21T16:51:29","date_gmt":"2022-11-21T16:51:29","guid":{"rendered":"https:\/\/docs_v3.dataforseo.com\/v3\/?page_id=15909"},"modified":"2025-03-27T13:13:05","modified_gmt":"2025-03-27T13:13:05","slug":"serp-youtube-overview","status":"publish","type":"page","link":"https:\/\/docs.dataforseo.com\/v3\/serp-youtube-overview\/","title":{"rendered":"serp\/youtube\/overview"},"content":{"rendered":"<div class=\"wpb-content-wrapper\"><p>[vc_row][vc_column][vc_column_text]<\/p>\n<h1 id=\"introduction\">YouTube SERP 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                    YouTube SERP API provides search results for the specified keyword or video id, search engine, location, language, and device OS            <\/div>\n    \n<p>YouTube SERP API provides search results based on the selected search engine type. The following is the list of available search engine types:<\/p>\n<div style=\"margin-left: 28px;\">\n<ul>\n<li><a href=\"\/v3\/serp\/youtube\/organic\/overview\/\" target=\"_blank\" rel=\"noopener noreferrer\">YouTube Organic<\/a><\/li>\n<li><a href=\"\/v3\/serp\/youtube\/video_info\/overview\/\" target=\"_blank\" rel=\"noopener noreferrer\">YouTube Video Info<\/a><\/li>\n<li><a href=\"\/v3\/serp\/youtube\/video_subtitles\/overview\/\" target=\"_blank\" rel=\"noopener noreferrer\">YouTube Subtitles<\/a><\/li>\n<li><a href=\"\/v3\/serp\/youtube\/video_comments\/overview\/\" target=\"_blank\" rel=\"noopener noreferrer\">YouTube Comments<\/a><\/li>\n<\/ul>\n<\/div>\n<p>The returned results are specific to the indicated keyword, search engine, <a href=\"\/v3\/serp\/youtube\/languages\/\" target=\"_blank\" rel=\"noopener noreferrer\">language<\/a> and <a href=\"\/v3\/serp\/youtube\/locations\/\" target=\"_blank\" rel=\"noopener noreferrer\">location<\/a> parameters. We emulate set location and search engine with the highest accuracy so that the results you receive will match the actual search results for the specified parameters at the time of task setting. 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. Note that user preferences, search history, and other personalized search factors are ignored by our system and thus would not be reflected in the returned SERP results.<\/p>\n<p><strong>Note:<\/strong> All YouTube SERP API endpoints, except YouTube Organic, provide 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. In YouTube Organic, you can get results for both <code>desktop<\/code> and <code>mobile<\/code>.<\/p>\n<h3>YouTube SERP API functions<\/h3>\n<p><strong>The Advanced function<\/strong> is supported across all YouTube API search engine types and provides a complete overview of search results and video data.<\/p>\n<h3>Methods<\/h3>\n<p>The cost of using YouTube SERP API 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, <strong>the Live method<\/strong> is the best solution for you. Unlike the Standard method, this method doesn\u2019t require making separate POST and GET requests to the corresponding endpoints.<\/p>\n<p>If you don\u2019t need to receive data in real-time, you can use <strong>the Standard method<\/strong> 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>\u200cAlternatively, 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 use the Standard method without specifying <code>pingback_url<\/code> or <code>postback_url<\/code>, you can receive the list of id for all completed tasks using the <strong>&#8216;Tasks Ready&#8217;<\/strong> endpoint. It is designed to provide you with the list of completed tasks, which haven&#8217;t been collected yet. Then, you can retrieve the results using the <strong>\u2018Task GET\u2019<\/strong> endpoint.<\/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. \u200cVisit\u00a0<a class=\"c-link\" href=\"https:\/\/dataforseo.com\/help-center\/best-practices-low-volume-serp-api-payload\" target=\"_blank\" rel=\"noopener noreferrer\" data-stringify-link=\"https:\/\/dataforseo.com\/help-center\/best-practices-low-volume-serp-api-payload\" data-sk=\"tooltip_parent\">DataForSEO Help Center<\/a>\u00a0to get practical tips for request handling depending on your SERP API payload volume.<\/p>\n<h3>Priorities and cost<\/h3>\n<p>The 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>If you use YouTube Organic or YouTube comments you will be billed per each SERP containing 20 results.<br \/>\n<strong>Note:<\/strong> setting <code>depth<\/code> above the default value will increase the cost of the task. For example, if the default value is 20, you will be billed for every 20 results. So, if you specify <code>\"depth\": 30<\/code>, the price for the task will be multiplied by 2 and you will be billed as for 40 results.<\/p>\n<p>For each API call to YouTube Video Info and YouTube Subtitles you will be charged x3 SEPR price regardless of the result.<\/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 SERP API for free using DataForSEO <a href=\"\/v3\/appendix\/sandbox\/\">Sandbox.<\/a><br \/>\n[\/vc_column_text][\/vc_column][\/vc_row]<\/p>\n<\/div>","protected":false},"excerpt":{"rendered":"<p>[vc_row][vc_column][vc_column_text] YouTube SERP API: Overview YouTube SERP API provides search results for the specified keyword or video id, search engine, location, language, and device OS YouTube SERP API provides search results based on the selected search engine type. The following is the list of available search engine types: YouTube Organic YouTube Video Info YouTube Subtitles [&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-15909","page","type-page","status-publish","hentry"],"_links":{"self":[{"href":"https:\/\/docs.dataforseo.com\/v3\/wp-json\/wp\/v2\/pages\/15909","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=15909"}],"version-history":[{"count":11,"href":"https:\/\/docs.dataforseo.com\/v3\/wp-json\/wp\/v2\/pages\/15909\/revisions"}],"predecessor-version":[{"id":21305,"href":"https:\/\/docs.dataforseo.com\/v3\/wp-json\/wp\/v2\/pages\/15909\/revisions\/21305"}],"wp:attachment":[{"href":"https:\/\/docs.dataforseo.com\/v3\/wp-json\/wp\/v2\/media?parent=15909"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}