{"id":16464,"date":"2023-02-09T12:22:09","date_gmt":"2023-02-09T12:22:09","guid":{"rendered":"https:\/\/docs_v3.dataforseo.com\/v3\/?page_id=16464"},"modified":"2026-01-23T14:39:18","modified_gmt":"2026-01-23T14:39:18","slug":"serp-id_list","status":"publish","type":"page","link":"https:\/\/docs.dataforseo.com\/v3\/serp-id_list\/","title":{"rendered":"serp\/id_list"},"content":{"rendered":"<div class=\"wpb-content-wrapper\"><p>[vc_row][vc_column][vc_column_text]<\/p>\n<h2 id=\"api-name-errors\">SERP API ID List<\/h2>\n<p>&nbsp;<br \/>\nThis endpoint is designed to provide you with a list of IDs and metadata for all SERP tasks created within the specified time period, including both successful and uncompleted tasks.<\/p>\n<p><strong>Note that:<\/strong> You can set the date range within six months from the date of calling the endpoint. Metadata is only available for tasks that were made within one month.<\/p>\n<p>\t<article class=\"info-card info-card--yellow\">\n\t\t<header class=\"info-card__header\">\n\t\t\t<div class=\"info-card__icon\">\n\t\t\t\t<svg width=\"16\" height=\"16\" viewBox=\"0 0 16 16\">\n\t\t\t\t\t<use href=\"https:\/\/docs.dataforseo.com\/v3\/wp-content\/themes\/dataforseo\/assets\/img\/icons\/sprite.svg#label\"><\/use>\n\t\t\t\t<\/svg>\n\t\t\t<\/div>\n\t\t\t<div class=\"info-card__title\">Pricing<\/div>\n\t\t<\/header>\n\t\t<div class=\"info-card__content\">\n\t\t\t<p>Your account will not be charged for using this API<\/p>\n\t\t<\/div>\n\t<\/article>\n\t    <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                    POST            <button class=\"btn-reset button-link copy-button\" data-href=\"https:\/\/api.dataforseo.com\/v3\/serp\/id_list\">\n                https:\/\/api.dataforseo.com\/v3\/serp\/id_list                <svg width=\"16\" height=\"16\" viewBox=\"0 0 16 16\">\n                    <use href=\"https:\/\/docs.dataforseo.com\/v3\/wp-content\/themes\/dataforseo\/assets\/img\/icons\/sprite.svg#layers\"><\/use>\n                <\/svg>\n            <\/button>\n            <\/div>\n    [\/vc_column_text][vc_column_text]You can make up to <strong>10 API calls per minute<\/strong>. With each API call, you can get 1000 task IDs within six previous month. <\/p>\n<p>All POST data should be sent in JSON format (UTF-8 encoding). The task setting is done using the POST method. When setting a task, you should send all task parameters in the task array of the generic POST array.<\/p>\n<p><strong>Description of the fields for sending a request:<\/strong><\/p>\n<table style=\"width: 86.0726%; height: 34px;\">\n<thead>\n<tr style=\"height: 24px;\">\n<th style=\"width: 12.4003%; height: 24px;\">Field name<\/th>\n<th style=\"width: 3.91588%; height: 24px;\">Type<\/th>\n<th style=\"width: 82.9587%; height: 24px;\">Description<\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr style=\"height: 192px;\">\n<td style=\"width: 12.4003%; height: 10px;\"><code>datetime_from<\/code><\/td>\n<td style=\"width: 3.91588%; height: 10px;\">string<\/td>\n<td style=\"width: 82.9587%; height: 10px;\"><em>start time for filtering results<\/em><br \/>\n<strong>required field<\/strong><br \/>\nif <code>include_metadata<\/code> is set to <code>true<\/code>, minimum start value: a month from current datetime;<br \/>\nif <code>include_metadata<\/code> is set to <code>false<\/code>, minimum start value: six months from current datetime;<br \/>\nmaximum start value: current <code>datetime<\/code>;<br \/>\nmust be specified in the UTC format: &#8220;yyyy-mm-dd hh-mm-ss +00:00&#8221;;<br \/>\nexample:<br \/>\n<code>2023-01-15 12:57:46 +00:00<\/code><\/td>\n<\/tr>\n<tr style=\"height: 192px;\">\n<td style=\"width: 12.4003%; height: 10px;\"><code>datetime_to<\/code><\/td>\n<td style=\"width: 3.91588%; height: 10px;\">string<\/td>\n<td style=\"width: 82.9587%; height: 10px;\"><em>finish time for filtering results<\/em><br \/>\n<strong>required field<\/strong><br \/>\nif <code>include_metadata<\/code> is set to <code>true<\/code>, minimum finish value: a month from current datetime;<br \/>\nif <code>include_metadata<\/code> is set to <code>false<\/code>, minimum finish value: six months from current datetime;<br \/>\nmaximum finish value: current <code>datetime<\/code>;<br \/>\n<strong>Note:<\/strong> <code>datetime_to<\/code> must be greater than <code>datetime_from<\/code>;<br \/>\nmust be specified in the UTC format: &#8220;yyyy-mm-dd hh-mm-ss +00:00&#8221;;<br \/>\nexample:<br \/>\n<code>2023-01-31 13:57:46 +00:00<\/code><\/td>\n<\/tr>\n<tr style=\"height: 192px;\">\n<td style=\"width: 12.4003%; height: 10px;\"><code>limit<\/code><\/td>\n<td style=\"width: 3.91588%; height: 10px;\">integer<\/td>\n<td style=\"width: 82.9587%; height: 10px;\"><em>the maximum number of returned task IDs<\/em><br \/>\noptional field<br \/>\ndefault value: <code>1000<\/code><br \/>\nmaximum value: <code>1000<\/code><br \/>\nminimum value: <code>1<\/code><\/td>\n<\/tr>\n<tr style=\"height: 192px;\">\n<td style=\"width: 12.4003%; height: 10px;\"><code>offset<\/code><\/td>\n<td style=\"width: 3.91588%; height: 10px;\">integer<\/td>\n<td style=\"width: 82.9587%; height: 10px;\"><em>offset in the results array of returned task IDs<\/em><br \/>\noptional field<br \/>\nif you specify the <code>10<\/code> value, the first ten tasks in the results array will be omitted;<br \/>\nminimum and default value: <code>0<\/code>;<br \/>\nmaximum value: <code>100M<\/code> (100 million)\n<\/td>\n<\/tr>\n<tr style=\"height: 192px;\">\n<td style=\"width: 12.4003%; height: 10px;\"><code>sort<\/code><\/td>\n<td style=\"width: 3.91588%; height: 10px;\">string<\/td>\n<td style=\"width: 82.9587%; height: 10px;\"><em>sorting by task execution time<\/em><br \/>\noptional field<br \/>\npossible values: <code>\"asc\"<\/code>, <code>\"desc\"<\/code><br \/>\ndefault value: <code>\"asc\"<\/code>\n<\/td>\n<\/tr>\n<tr style=\"height: 192px;\">\n<td style=\"width: 12.4003%; height: 10px;\"><code>include_metadata<\/code><\/td>\n<td style=\"width: 3.91588%; height: 10px;\">boolean<\/td>\n<td style=\"width: 82.9587%; height: 10px;\"><em>include task metadata in the response<\/em><br \/>\noptional field<br \/>\nif set to <code>true<\/code>, the <code>metadata<\/code> object containing parameters specified in the POST request will be provided in the response;<br \/>\ndefault value: <code>false<\/code>\n<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<p>&nbsp;<br \/>\n\u200c\u200cAs a response of the API server, you will receive <a href=\"https:\/\/en.wikipedia.org\/wiki\/JSON\">JSON<\/a>-encoded data containing a <code>tasks<\/code> array with the information specific to the set tasks.<\/p>\n<table style=\"width: 58%; height: 648px;\">\n<thead>\n<tr style=\"height: 24px;\">\n<th style=\"width: 38.423%; height: 24px;\">Field name<\/th>\n<th style=\"width: 1.75219%; height: 24px;\">Type<\/th>\n<th style=\"width: 61.2015%; height: 24px;\">Description<\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr style=\"height: 48px;\">\n<td style=\"width: 24.3517%; height: 48px;\"><code>version<\/code><\/td>\n<td style=\"width: 6.19209%; height: 48px;\">string<\/td>\n<td style=\"width: 79.8065%; height: 48px;\"><em>the current version of the API<\/em><\/td>\n<\/tr>\n<tr style=\"height: 48px;\">\n<td style=\"width: 38.423%; height: 48px;\"><code>status_code<\/code><\/td>\n<td style=\"width: 1.75219%; height: 48px;\">integer<\/td>\n<td style=\"width: 61.2015%; height: 48px;\"><i>general status code<\/i><br \/>\nyou can find the full list of the response codes <a href=\"\/v3\/appendix\/errors\">here<\/a><\/td>\n<\/tr>\n<tr style=\"height: 24px;\">\n<td style=\"width: 24.3517%; height: 24px;\"><code>status_message<\/code><\/td>\n<td style=\"width: 6.19209%; height: 24px;\">string<\/td>\n<td style=\"width: 79.8065%; height: 24px;\"><em>general informational message<\/em><br \/>\nyou can find the full list of general informational messages <a href=\"\/v3\/appendix\/errors\">here<\/a><\/td>\n<\/tr>\n<tr style=\"height: 24px;\">\n<td style=\"width: 38.423%; height: 24px;\"><code>time<\/code><\/td>\n<td style=\"width: 1.75219%; height: 24px;\">string<\/td>\n<td style=\"width: 61.2015%; height: 24px;\"><em>total execution time, seconds<\/em><\/td>\n<\/tr>\n<tr style=\"height: 24px;\">\n<td style=\"width: 38.423%; height: 24px;\"><code>cost<\/code><\/td>\n<td style=\"width: 1.75219%; height: 24px;\">float<\/td>\n<td style=\"width: 61.2015%; height: 24px;\"><em>total tasks cost, USD<\/em><\/td>\n<\/tr>\n<tr style=\"height: 24px;\">\n<td style=\"width: 38.423%; height: 24px;\"><code>tasks_count<\/code><\/td>\n<td style=\"width: 1.75219%; height: 24px;\">integer<\/td>\n<td style=\"width: 61.2015%; height: 24px;\"><em>the number of tasks in the <strong><code>tasks<\/code><\/strong> array<\/em><\/td>\n<\/tr>\n<tr style=\"height: 24px;\">\n<td style=\"width: 38.423%; height: 24px;\"><code>tasks_error<\/code><\/td>\n<td style=\"width: 1.75219%; height: 24px;\">integer<\/td>\n<td style=\"width: 61.2015%; height: 24px;\"><em>the number of tasks in the <strong><code>tasks<\/code><\/strong> array returned with an error<\/em><\/td>\n<\/tr>\n<tr style=\"height: 24px;\">\n<td style=\"width: 38.423%; height: 24px;\"><strong><code>tasks<\/code><\/strong><\/td>\n<td style=\"width: 1.75219%; height: 24px;\">array<\/td>\n<td style=\"width: 61.2015%; height: 24px;\"><em>array of tasks<\/em><\/td>\n<\/tr>\n<tr style=\"height: 24px;\">\n<td style=\"width: 38.423%; height: 24px;\">\u00a0 \u00a0 \u00a0 \u00a0 <code>id<\/code><\/td>\n<td style=\"width: 1.75219%; height: 24px;\">string<\/td>\n<td style=\"width: 61.2015%; height: 24px;\"><em>task identifier<\/em><br \/>\n<strong>unique task identifier in our system in the <a href=\"https:\/\/en.wikipedia.org\/wiki\/Universally_unique_identifier\" target=\"_blank\">UUID<\/a> format<\/strong><\/td>\n<\/tr>\n<tr style=\"height: 48px;\">\n<td style=\"width: 38.423%; height: 48px;\">\u00a0 \u00a0 \u00a0 \u00a0 <code>status_code<\/code><\/td>\n<td style=\"width: 1.75219%; height: 48px;\">integer<\/td>\n<td style=\"width: 61.2015%; height: 48px;\"><em>status code of the task<\/em><br \/>\ngenerated by DataForSEO, can be within the following range: 10000-60000<br \/>\nyou can find the full list of the response codes <a href=\"\/v3\/appendix-errors\/\">here<\/a><\/td>\n<\/tr>\n<tr style=\"height: 24px;\">\n<td style=\"width: 38.423%; height: 24px;\">\u00a0 \u00a0 \u00a0 \u00a0 <code>status_message<\/code><\/td>\n<td style=\"width: 1.75219%; height: 24px;\">string<\/td>\n<td style=\"width: 61.2015%; height: 24px;\"><em>informational message of the task<\/em><br \/>\nyou can find the full list of general informational messages <a href=\"\/v3\/appendix-errors\/\">here<\/a><\/td>\n<\/tr>\n<tr style=\"height: 24px;\">\n<td style=\"width: 38.423%; height: 24px;\">\u00a0 \u00a0 \u00a0 \u00a0 <code>time<\/code><\/td>\n<td style=\"width: 1.75219%; height: 24px;\">string<\/td>\n<td style=\"width: 61.2015%; height: 24px;\"><em>execution time, seconds<\/em><\/td>\n<\/tr>\n<tr style=\"height: 24px;\">\n<td style=\"width: 38.423%; height: 24px;\">\u00a0 \u00a0 \u00a0 \u00a0 <code>cost<\/code><\/td>\n<td style=\"width: 1.75219%; height: 24px;\">float<\/td>\n<td style=\"width: 61.2015%; height: 24px;\"><em>cost of the task, USD<\/em><\/td>\n<\/tr>\n<tr style=\"height: 24px;\">\n<td style=\"width: 38.423%; height: 24px;\">\u00a0 \u00a0 \u00a0 \u00a0 <code>result_count<\/code><\/td>\n<td style=\"width: 1.75219%; height: 24px;\">integer<\/td>\n<td style=\"width: 61.2015%; height: 24px;\"><em>number of elements in the <code>result<\/code> array<\/em><\/td>\n<\/tr>\n<tr style=\"height: 24px;\">\n<td style=\"width: 38.423%; height: 24px;\">\u00a0 \u00a0 \u00a0 \u00a0 <code>path<\/code><\/td>\n<td style=\"width: 1.75219%; height: 24px;\">array<\/td>\n<td style=\"width: 61.2015%; height: 24px;\"><em>URL path<\/em><\/td>\n<\/tr>\n<tr style=\"height: 24px;\">\n<td style=\"width: 38.423%; height: 24px;\">\u00a0 \u00a0 \u00a0 \u00a0 <code>data<\/code><\/td>\n<td style=\"width: 1.75219%; height: 24px;\">object<\/td>\n<td style=\"width: 61.2015%; height: 24px;\"><em>contains the same parameters that you specified in the POST request<\/em><\/td>\n<\/tr>\n<tr style=\"height: 24px;\">\n<td style=\"width: 38.423%; height: 24px;\">\u00a0 \u00a0 <strong>\u00a0 \u00a0 <code>result<\/code><\/strong><\/td>\n<td style=\"width: 1.75219%; height: 24px;\">array<\/td>\n<td style=\"width: 61.2015%; height: 24px;\"><em>array of results<\/em><\/td>\n<\/tr>\n<tr style=\"height: 24px;\">\n<td style=\"width: 38.423%; height: 24px;\">\u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 <code>id<\/code><\/td>\n<td style=\"width: 1.75219%; height: 24px;\">string<\/td>\n<td style=\"width: 61.2015%; height: 24px;\"><em>id of the task<\/em><\/td>\n<\/tr>\n<tr style=\"height: 24px;\">\n<td style=\"width: 38.423%; height: 24px;\">\u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 <code>url<\/code><\/td>\n<td style=\"width: 1.75219%; height: 24px;\">string<\/td>\n<td style=\"width: 61.2015%; height: 24px;\"><em>URL of the task<\/em><br \/>\nURL you used for making an API call<\/td>\n<\/tr>\n<tr style=\"height: 24px;\">\n<td style=\"width: 38.423%; height: 24px;\">\u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 <code>datetime_posted<\/code><\/td>\n<td style=\"width: 1.75219%; height: 24px;\">string<\/td>\n<td style=\"width: 61.2015%; height: 24px;\"><em>date and time when the task was made<\/em><br \/>\nin the UTC format: &#8220;yyyy-mm-dd hh-mm-ss +00:00&#8221;<br \/>\nexample:<br \/>\n<code>2023-01-15 12:57:46 +00:00<\/code><\/td>\n<\/tr>\n<tr style=\"height: 24px;\">\n<td style=\"width: 38.423%; height: 24px;\">\u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 <code>datetime_done<\/code><\/td>\n<td style=\"width: 1.75219%; height: 24px;\">string<\/td>\n<td style=\"width: 61.2015%; height: 24px;\"><em>date and time when the task was completed<\/em><br \/>\nin the UTC format: &#8220;yyyy-mm-dd hh-mm-ss +00:00&#8221;<br \/>\nexample:<br \/>\n<code>2023-01-15 12:57:46 +00:00<\/code><\/td>\n<\/tr>\n<tr style=\"height: 24px;\">\n<td style=\"width: 38.423%; height: 24px;\">\u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 <code>status<\/code><\/td>\n<td style=\"width: 1.75219%; height: 24px;\">string<\/td>\n<td style=\"width: 61.2015%; height: 24px;\"><em>informational message of the task<\/em><br \/>\nyou can find the full list of general informational messages <a href=\"\/v3\/appendix-errors\/\">here<\/a><\/td>\n<\/tr>\n<tr style=\"height: 24px;\">\n<td style=\"width: 38.423%; height: 24px;\">\u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 <code>cost<\/code><\/td>\n<td style=\"width: 1.75219%; height: 24px;\">float<\/td>\n<td style=\"width: 61.2015%; height: 24px;\"><em>cost of the task, USD<\/em><\/td>\n<\/tr>\n<tr style=\"height: 24px;\">\n<td style=\"width: 38.423%; height: 24px;\">\u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 <code>metadata<\/code><\/td>\n<td style=\"width: 1.75219%; height: 24px;\">object<\/td>\n<td style=\"width: 61.2015%; height: 24px;\"><em>contains parameters you specified in the POST request<\/em><\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<div data-unique=\"list-of-keywords-finder-locations\"><\/div>\n<p>[\/vc_column_text][\/vc_column][\/vc_row]<\/p>\n<blockquote><p>Instead of \u2018login\u2019 and \u2018password\u2019 use your credentials from https:\/\/app.dataforseo.com\/api-access<\/p><\/blockquote><div id=\"curl\" class=\"tab-content example__content\"><div class=\"example__code\"><pre><code class=\"language-bash hljs\"># Instead of &#039;login&#039; and &#039;password&#039; use your credentials from https:\/\/app.dataforseo.com\/api-access \r\nlogin=&quot;login&quot; \r\npassword=&quot;password&quot; \r\ncred=&quot;$(printf ${login}:${password} | base64)&quot; \r\ncurl --location --request POST &quot;https:\/\/api.dataforseo.com\/v3\/serp\/id_list&quot; \r\n--header &quot;Authorization: Basic ${cred}&quot;  \r\n--header &quot;Content-Type: application\/json&quot;\r\n--data-raw &#039;[\r\n    {\r\n        &quot;datetime_from&quot;: &quot;2023-01-31 00:00:00 +02:00&quot;,\r\n        &quot;datetime_to&quot;: &quot;2023-02-01 00:00:00 +02:00&quot;,\r\n        &quot;limit&quot;: 100,\r\n        &quot;offset&quot;: 0,\r\n        &quot;sort&quot;: &quot;desc&quot;,\r\n        &quot;include_metadata&quot;: true\r\n    }\r\n]&#039;<\/code><\/pre><\/div><\/div><div id=\"php\" class=\"tab-content example__content\"><div class=\"example__code\"><pre><code class=\"language-php hljs\">&lt;?php\r\n\/\/ You can download this file from here https:\/\/cdn.dataforseo.com\/v3\/examples\/php\/php_RestClient.zip\r\nrequire(&#039;RestClient.php&#039;);\r\n$api_url = &#039;https:\/\/api.dataforseo.com\/&#039;;\r\n\/\/ Instead of &#039;login&#039; and &#039;password&#039; use your credentials from https:\/\/app.dataforseo.com\/api-access\r\n$client = new RestClient($api_url, null, &#039;login&#039;, &#039;password&#039;);\r\n$post_array = array();\r\n\/\/ simple way to get a result\r\n$post_array[] = array(\r\n   &quot;datetime_from&quot; =&gt; &quot;2023-01-31 00:00:00 +02:00&quot;,\r\n   &quot;datetime_to&quot; =&gt; &quot;2023-02-01 00:00:00 +02:00&quot;,\r\n   &quot;limit&quot; =&gt; 100,\r\n   &quot;offset&quot; =&gt; 0,\r\n   &quot;sort&quot; =&gt; &quot;desc&quot;\r\n   &quot;include_metadata&quot; =&gt; true\r\n);\r\ntry {\r\n   \/\/ POST \/v3\/serp\/id_list\r\n   \/\/ the full list of possible parameters is available in documentation\r\n   $result = $client-&gt;post(&#039;\/v3\/serp\/id_list&#039;, $post_array);\r\n   print_r($result);\r\n   \/\/ do something with post result\r\n} catch (RestClientException $e) {\r\n   echo &quot;n&quot;;\r\n   print &quot;HTTP code: {$e-&gt;getHttpCode()}n&quot;;\r\n   print &quot;Error code: {$e-&gt;getCode()}n&quot;;\r\n   print &quot;Message: {$e-&gt;getMessage()}n&quot;;\r\n   print  $e-&gt;getTraceAsString();\r\n   echo &quot;n&quot;;\r\n}\r\n$client = null;\r\n?&gt;<\/code><\/pre><\/div><\/div><div id=\"javascript\" class=\"tab-content example__content\"><div class=\"example__code\"><pre><code class=\"language-javascript hljs\">const post_array = [];\r\n\r\npost_array.push({\r\n  &quot;datetime_from&quot;: &quot;2023-01-31 00:00:00 +02:00&quot;,\r\n  &quot;datetime_to&quot;: &quot;2023-02-01 00:00:00 +02:00&quot;,\r\n  &quot;limit&quot;: 100,\r\n  &quot;offset&quot;: 0,\r\n  &quot;sort&quot;: &quot;desc&quot;,\r\n  &quot;include_metadata&quot;: true\r\n});\r\n\r\nconst axios = require(&#039;axios&#039;);\r\n\r\naxios({\r\n  method: &#039;post&#039;,\r\n  url: &#039;https:\/\/api.dataforseo.com\/v3\/serp\/id_list&#039;,\r\n  auth: {\r\n    username: &#039;login&#039;,\r\n    password: &#039;password&#039;\r\n  },\r\n  data: post_array,\r\n  headers: {\r\n    &#039;content-type&#039;: &#039;application\/json&#039;\r\n  }\r\n}).then(function (response) {\r\n  var result = response[&#039;data&#039;][&#039;tasks&#039;];\r\n  \/\/ Result data\r\n  console.log(result);\r\n}).catch(function (error) {\r\n  console.log(error);\r\n});<\/code><\/pre><\/div><\/div><div id=\"python\" class=\"tab-content example__content\"><div class=\"example__code\"><pre><code class=\"language-python hljs\">from random import Random\r\nfrom client import RestClient\r\n# You can download this file from here https:\/\/api.dataforseo.com\/v3\/_examples\/python\/_python_Client.zip\r\nclient = RestClient(&quot;login&quot;, &quot;password&quot;)\r\npost_data = dict()\r\npost_data[len(post_data)] = dict(\r\n    datetime_from=&quot;2023-01-31 00:00:00 +02:00&quot;,\r\n    datetime_to=&quot;2023-02-01 00:00:00 +02:00&quot;,\r\n    limit=100,\r\n    offset=0,\r\n    sort=&quot;desc&quot;,\r\n    include_metadata=True\r\n)\r\n# POST \/v3\/serp\/id_list\r\n# the full list of possible parameters is available in documentation\r\nresponse = client.post(&quot;\/v3\/serp\/id_list&quot;, post_data)\r\n# you can find the full list of the response codes here https:\/\/docs.dataforseo.com\/v3\/serp\/id_list\r\nif response[&quot;status_code&quot;] == 20000:\r\n    print(response)\r\n    # do something with result\r\nelse:\r\n    print(&quot;error. Code: %d Message: %s&quot; % (response[&quot;status_code&quot;], response[&quot;status_message&quot;]))<\/code><\/pre><\/div><\/div><div id=\"csharp\" class=\"tab-content example__content\"><div class=\"example__code\"><pre><code class=\"language-csharp hljs\">using Newtonsoft.Json;\r\nusing System;\r\nusing System.Collections.Generic;\r\nusing System.Net.Http;\r\nusing System.Net.Http.Headers;\r\nusing System.Text;\r\nusing System.Threading.Tasks;\r\nnamespace DataForSeoDemos\r\n{\r\n    public static partial class Demos\r\n    {\r\n        public static async Task errors()\r\n        {\r\n            var httpClient = new HttpClient\r\n            {\r\n                BaseAddress = new Uri(&quot;https:\/\/api.dataforseo.com\/&quot;),\r\n                \/\/ Instead of &#039;login&#039; and &#039;password&#039; use your credentials from https:\/\/app.dataforseo.com\/api-access\r\n                DefaultRequestHeaders = { Authorization = new AuthenticationHeaderValue(&quot;Basic&quot;, Convert.ToBase64String(Encoding.ASCII.GetBytes(&quot;login:password&quot;))) }\r\n            };\r\n            var postData = new List&lt;object&gt;();\r\n            \/\/ simple way to get a result\r\n            postData.Add(new\r\n            {\r\n             datetime_from = &quot;2023-01-31 00:00:00 +02:00&quot;,\r\n             datetime_to = &quot;2023-02-01 00:00:00 +02:00&quot;,\r\n             limit = 100,\r\n             offset = 0,\r\n             sort = &quot;desc&quot;,\r\n             include_metadata = true\r\n            });\r\n            \/\/ POST \/v3\/serp\/id_list\r\n            \/\/ the full list of possible parameters is available in documentation\r\n            var taskPostResponse = await httpClient.PostAsync(&quot;\/v3\/serp\/id_list&quot;, new StringContent(JsonConvert.SerializeObject(postData)));\r\n            var result = JsonConvert.DeserializeObject&lt;dynamic&gt;(await taskPostResponse.Content.ReadAsStringAsync());\r\n            \/\/ you can find the full list of the response codes here https:\/\/docs.dataforseo.com\/v3\/serp\/id_list\r\n            if (result.status_code == 20000)\r\n            {\r\n                \/\/ do something with result\r\n                Console.WriteLine(result);\r\n            }\r\n            else\r\n                Console.WriteLine($&quot;error. Code: {result.status_code} Message: {result.status_message}&quot;);\r\n        }\r\n    }\r\n}<\/code><\/pre><\/div><\/div><blockquote><p>The above command returns JSON structured like this:<\/p><\/blockquote><div class=\"example example--json\"><div class=\"example__content\"><div class=\"example__code example__code-json\"><pre><code class=\"language-json hljs\">{\r\n  &quot;version&quot;: &quot;0.1.20221214&quot;,\r\n  &quot;status_code&quot;: 20000,\r\n  &quot;status_message&quot;: &quot;Ok.&quot;,\r\n  &quot;time&quot;: &quot;1.6078 sec.&quot;,\r\n  &quot;cost&quot;: 0,\r\n  &quot;tasks_count&quot;: 1,\r\n  &quot;tasks_error&quot;: 0,\r\n  &quot;tasks&quot;: [\r\n    {\r\n      &quot;id&quot;: &quot;02061637-4426-0521-0000-00f930977c58&quot;,\r\n      &quot;status_code&quot;: 20000,\r\n      &quot;status_message&quot;: &quot;Ok.&quot;,\r\n      &quot;time&quot;: &quot;1.5527 sec.&quot;,\r\n      &quot;cost&quot;: 0,\r\n      &quot;result_count&quot;: 8,\r\n      &quot;path&quot;: [\r\n        &quot;v3&quot;,\r\n        &quot;serp&quot;,\r\n        &quot;id_list&quot;\r\n      ],\r\n      &quot;data&quot;: {\r\n        &quot;api&quot;: &quot;serp&quot;,\r\n        &quot;function&quot;: &quot;id_list&quot;,\r\n        &quot;datetime_from&quot;: &quot;2023-01-07 00:00:00 +02:00&quot;,\r\n        &quot;datetime_to&quot;: &quot;2023-02-01 00:00:00 +02:00&quot;,\r\n        &quot;limit&quot;: 100,\r\n        &quot;sort&quot;: &quot;desc&quot;,\r\n        &quot;include_metadata&quot;: true\r\n      },\r\n      &quot;result&quot;: [\r\n        {\r\n          &quot;id&quot;: &quot;01262030-4426-0139-0000-50c0b9a6c886&quot;,\r\n          &quot;url&quot;: &quot;v3\/serp\/google\/organic\/live\/advanced&quot;,\r\n          &quot;datetime_posted&quot;: &quot;2023-01-26 18:31:01 +00:00&quot;,\r\n          &quot;datetime_done&quot;: &quot;2023-01-26 18:31:01 +00:00&quot;,\r\n          &quot;status&quot;: &quot;20000&quot;,\r\n          &quot;cost&quot;: 0.002,\r\n          &quot;metadata&quot;: {\r\n            &quot;api&quot;: &quot;serp&quot;,\r\n            &quot;function&quot;: &quot;live&quot;,\r\n            &quot;se&quot;: &quot;google&quot;,\r\n            &quot;se_type&quot;: &quot;organic&quot;,\r\n            &quot;language_name&quot;: &quot;English&quot;,\r\n            &quot;location_name&quot;: &quot;London,England,United Kingdom&quot;,\r\n            &quot;keyword&quot;: &quot;rank checker&quot;,\r\n            &quot;postback_data&quot;: &quot;advanced&quot;,\r\n            &quot;device&quot;: &quot;desktop&quot;,\r\n            &quot;os&quot;: &quot;windows&quot;\r\n          }\r\n        },\r\n        {\r\n          &quot;id&quot;: &quot;01161600-4426-0139-0000-3357191881e9&quot;,\r\n          &quot;url&quot;: &quot;v3\/serp\/google\/dataset_info\/live\/advanced&quot;,\r\n          &quot;datetime_posted&quot;: &quot;2023-01-16 14:00:30 +00:00&quot;,\r\n          &quot;datetime_done&quot;: &quot;2023-01-16 14:00:30 +00:00&quot;,\r\n          &quot;status&quot;: &quot;20000&quot;,\r\n          &quot;cost&quot;: 0.002,\r\n          &quot;metadata&quot;: {\r\n            &quot;api&quot;: &quot;serp&quot;,\r\n            &quot;function&quot;: &quot;live&quot;,\r\n            &quot;se&quot;: &quot;google&quot;,\r\n            &quot;se_type&quot;: &quot;dataset_info&quot;,\r\n            &quot;dataset_id&quot;: &quot;L2cvMTFxcGdsbDMwMQ==&quot;,\r\n            &quot;postback_data&quot;: &quot;advanced&quot;,\r\n            &quot;device&quot;: &quot;desktop&quot;,\r\n            &quot;os&quot;: &quot;windows&quot;\r\n          }\r\n        },\r\n        {\r\n          &quot;id&quot;: &quot;01161555-4426-0139-0000-027b8dd062f3&quot;,\r\n          &quot;url&quot;: &quot;v3\/serp\/google\/dataset_search\/live\/advanced&quot;,\r\n          &quot;datetime_posted&quot;: &quot;2023-01-16 13:55:36 +00:00&quot;,\r\n          &quot;datetime_done&quot;: &quot;2023-01-16 13:55:36 +00:00&quot;,\r\n          &quot;status&quot;: &quot;20000&quot;,\r\n          &quot;cost&quot;: 0.002,\r\n          &quot;metadata&quot;: {\r\n            &quot;api&quot;: &quot;serp&quot;,\r\n            &quot;function&quot;: &quot;live&quot;,\r\n            &quot;se&quot;: &quot;google&quot;,\r\n            &quot;se_type&quot;: &quot;dataset_search&quot;,\r\n            &quot;keyword&quot;: &quot;water quality&quot;,\r\n            &quot;postback_data&quot;: &quot;advanced&quot;,\r\n            &quot;device&quot;: &quot;desktop&quot;,\r\n            &quot;os&quot;: &quot;windows&quot;\r\n          }\r\n        },\r\n        {\r\n          &quot;id&quot;: &quot;01161535-4426-0139-0000-eca053a01ae6&quot;,\r\n          &quot;url&quot;: &quot;v3\/serp\/google\/dataset_search\/live\/advanced&quot;,\r\n          &quot;datetime_posted&quot;: &quot;2023-01-16 13:35:36 +00:00&quot;,\r\n          &quot;datetime_done&quot;: &quot;2023-01-16 13:35:35 +00:00&quot;,\r\n          &quot;status&quot;: &quot;20000&quot;,\r\n          &quot;cost&quot;: 0.002,\r\n          &quot;metadata&quot;: {\r\n            &quot;api&quot;: &quot;serp&quot;,\r\n            &quot;function&quot;: &quot;live&quot;,\r\n            &quot;se&quot;: &quot;google&quot;,\r\n            &quot;se_type&quot;: &quot;dataset_search&quot;,\r\n            &quot;keyword&quot;: &quot;water quality&quot;,\r\n            &quot;last_updated&quot;: &quot;1m&quot;,\r\n            &quot;file_formats&quot;: [\r\n              &quot;archive&quot;,\r\n              &quot;image&quot;\r\n            ],\r\n            &quot;usage_rights&quot;: &quot;noncommercial&quot;,\r\n            &quot;is_free&quot;: true,\r\n            &quot;topics&quot;: [\r\n              &quot;natural_sciences&quot;,\r\n              &quot;geo&quot;\r\n            ],\r\n            &quot;postback_data&quot;: &quot;advanced&quot;,\r\n            &quot;device&quot;: &quot;desktop&quot;,\r\n            &quot;os&quot;: &quot;windows&quot;\r\n          }\r\n        },\r\n        {\r\n          &quot;id&quot;: &quot;01130021-4426-0139-0000-60d2806c6081&quot;,\r\n          &quot;url&quot;: &quot;v3\/serp\/google\/dataset_search\/live\/advanced&quot;,\r\n          &quot;datetime_posted&quot;: &quot;2023-01-12 22:21:18 +00:00&quot;,\r\n          &quot;datetime_done&quot;: &quot;2023-01-12 22:21:18 +00:00&quot;,\r\n          &quot;status&quot;: &quot;20000&quot;,\r\n          &quot;cost&quot;: 0.020000000000000004,\r\n          &quot;metadata&quot;: {\r\n            &quot;api&quot;: &quot;serp&quot;,\r\n            &quot;function&quot;: &quot;live&quot;,\r\n            &quot;se&quot;: &quot;google&quot;,\r\n            &quot;se_type&quot;: &quot;dataset_search&quot;,\r\n            &quot;keyword&quot;: &quot;water quality&quot;,\r\n            &quot;depth&quot;: 700,\r\n            &quot;postback_data&quot;: &quot;advanced&quot;,\r\n            &quot;device&quot;: &quot;desktop&quot;,\r\n            &quot;os&quot;: &quot;windows&quot;\r\n          }\r\n        },\r\n        {\r\n          &quot;id&quot;: &quot;01130020-4426-0139-0000-bcded021ab37&quot;,\r\n          &quot;url&quot;: &quot;v3\/serp\/google\/dataset_search\/live\/advanced&quot;,\r\n          &quot;datetime_posted&quot;: &quot;2023-01-12 22:20:17 +00:00&quot;,\r\n          &quot;datetime_done&quot;: &quot;2023-01-12 22:20:16 +00:00&quot;,\r\n          &quot;status&quot;: &quot;20000&quot;,\r\n          &quot;cost&quot;: 0.002,\r\n          &quot;metadata&quot;: {\r\n            &quot;api&quot;: &quot;serp&quot;,\r\n            &quot;function&quot;: &quot;live&quot;,\r\n            &quot;se&quot;: &quot;google&quot;,\r\n            &quot;se_type&quot;: &quot;dataset_search&quot;,\r\n            &quot;keyword&quot;: &quot;water quality&quot;,\r\n            &quot;postback_data&quot;: &quot;advanced&quot;,\r\n            &quot;device&quot;: &quot;desktop&quot;,\r\n            &quot;os&quot;: &quot;windows&quot;\r\n          }\r\n        },\r\n        {\r\n          &quot;id&quot;: &quot;01122000-4426-0139-0000-d2a69bec4af8&quot;,\r\n          &quot;url&quot;: &quot;v3\/serp\/google\/dataset_info\/live\/advanced&quot;,\r\n          &quot;datetime_posted&quot;: &quot;2023-01-12 18:00:26 +00:00&quot;,\r\n          &quot;datetime_done&quot;: &quot;2023-01-12 18:00:25 +00:00&quot;,\r\n          &quot;status&quot;: &quot;20000&quot;,\r\n          &quot;cost&quot;: 0.002,\r\n          &quot;metadata&quot;: {\r\n            &quot;api&quot;: &quot;serp&quot;,\r\n            &quot;function&quot;: &quot;live&quot;,\r\n            &quot;se&quot;: &quot;google&quot;,\r\n            &quot;se_type&quot;: &quot;dataset_info&quot;,\r\n            &quot;dataset_id&quot;: &quot;L2cvMTFuMDQ3X3B6aA&quot;,\r\n            &quot;postback_data&quot;: &quot;advanced&quot;,\r\n            &quot;device&quot;: &quot;desktop&quot;,\r\n            &quot;os&quot;: &quot;windows&quot;\r\n          }\r\n        },\r\n        {\r\n          &quot;id&quot;: &quot;01121947-4426-0139-0000-8c3f461ee95b&quot;,\r\n          &quot;url&quot;: &quot;v3\/serp\/google\/dataset_search\/live\/advanced&quot;,\r\n          &quot;datetime_posted&quot;: &quot;2023-01-12 17:47:24 +00:00&quot;,\r\n          &quot;datetime_done&quot;: &quot;2023-01-12 17:47:23 +00:00&quot;,\r\n          &quot;status&quot;: &quot;20000&quot;,\r\n          &quot;cost&quot;: 0.002,\r\n          &quot;metadata&quot;: {\r\n            &quot;api&quot;: &quot;serp&quot;,\r\n            &quot;function&quot;: &quot;live&quot;,\r\n            &quot;se&quot;: &quot;google&quot;,\r\n            &quot;se_type&quot;: &quot;dataset_search&quot;,\r\n            &quot;keyword&quot;: &quot;water quality&quot;,\r\n            &quot;last_updated&quot;: &quot;1m&quot;,\r\n            &quot;file_formats&quot;: [\r\n              &quot;archive&quot;,\r\n              &quot;image&quot;\r\n            ],\r\n            &quot;usage_rights&quot;: &quot;noncommercial&quot;,\r\n            &quot;is_free&quot;: true,\r\n            &quot;topics&quot;: [\r\n              &quot;natural_sciences&quot;,\r\n              &quot;geo&quot;\r\n            ],\r\n            &quot;postback_data&quot;: &quot;advanced&quot;,\r\n            &quot;device&quot;: &quot;desktop&quot;,\r\n            &quot;os&quot;: &quot;windows&quot;\r\n          }\r\n        }\r\n      ]\r\n    }\r\n  ]\r\n}<\/code><\/pre><\/div><\/div><\/div><\/div>","protected":false},"excerpt":{"rendered":"<p>[vc_row][vc_column][vc_column_text] SERP API ID List &nbsp; This endpoint is designed to provide you with a list of IDs and metadata for all SERP tasks created within the specified time period, including both successful and uncompleted tasks. Note that: You can set the date range within six months from the date of calling the endpoint. Metadata [&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-16464","page","type-page","status-publish","hentry"],"_links":{"self":[{"href":"https:\/\/docs.dataforseo.com\/v3\/wp-json\/wp\/v2\/pages\/16464","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=16464"}],"version-history":[{"count":18,"href":"https:\/\/docs.dataforseo.com\/v3\/wp-json\/wp\/v2\/pages\/16464\/revisions"}],"predecessor-version":[{"id":23670,"href":"https:\/\/docs.dataforseo.com\/v3\/wp-json\/wp\/v2\/pages\/16464\/revisions\/23670"}],"wp:attachment":[{"href":"https:\/\/docs.dataforseo.com\/v3\/wp-json\/wp\/v2\/media?parent=16464"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}