Sign in
Serp

Changed on

By calling this endpoint you will receive information about the SERP API tasks that returned an error within the past 7 days.

post/v3/serp/errors

Request

  • Base URL: https://api.dataforseo.com
  • URL: https://api.dataforseo.com/v3/serp/errors
  • Auth: HTTP basic

Request body

limitinteger nullable

<em>the maximum number of returned tasks that responded with an error</em><br>optional field<br>default value: <code>1000</code><br>maximum value: <code>1000</code><br>minimum value: <code>1</code>

offsetinteger nullable

<em>offset in the results array of returned tasks</em><br>optional field<br>if you specify the <code>10</code> value, the first ten tasks in the results array will be omitted and the data will be provided for the successive tasks<br>default and minimum value: <code>0</code><br>maximum value: <code>100M</code> (100 million)

filtered_functionstring nullable

<em>return tasks with a certain function</em><br>use this field to obtain a list of tasks that returned an error filtered by the certain endpoint's URL, as well as <code>pingback_url</code> or <code>postback_url</code> specified in the API request;<br>you can filter the results by the values you receive in the <code>function</code> fields of the API response;<br>i.e., once you receive unfiltered results, you can call this API again to filter them by <code>function</code>; <br>example: <code>serp/task_get/advanced</code>

datetime_fromstring nullable

<em>start time for filtering results</em><br>optional field<br>allows filtering results by the <code>datetime</code> parameter within the range of the last 7 days;<br>must be specified in the UTC format: <code>"yyyy-mm-dd hh-mm-ss +00:00"</code>;<br>minimum value: 7 days from the current <code>datetime</code><br>maximum value: current <code>datetime</code><br>example:<br><code>2021-11-15 12:57:46 +00:00</code>

datetime_tostring nullable

<em>finish time for filtering results</em><br>optional field<br>allows filtering results by the <code>datetime</code> parameter within the range of the last 7 days;<br>must be specified in the UTC format: "yyyy-mm-dd hh-mm-ss +00:00"<br>minimum value: 7 days from the current <code>datetime</code><br>maximum value: current <code>datetime</code><br><strong>Note</strong> <code>datetime_to</code> must be greater than <code>datetime_from</code> if both parameters are used;<br>example:<br><code>2021-11-15 13:57:46 +00:00</code>

Example request

[
  {
    "limit": 10,
    "offset": 0,
    "filtered_function": "pingback_url"
  }
]

Response

Successful operation

versionstring nullable

the current version of the API

status_codeinteger nullable

general status code you can find the full list of the response codes here

status_messagestring nullable

general informational message you can find the full list of general informational messages here

timestring nullable

total execution time, seconds

costnumber double nullable

total tasks cost, USD

tasks_countinteger nullable

the number of tasks in the tasks array

tasks_errorinteger nullable

the number of tasks in the tasks array returned with an error

Changes

  • be20fca9d9ccRevision changes
    • info

      api operation id SerpErrors removed and replaced with Errors

  • a751331174cfRevision changes
    • breaking

      the ////////////////// response's property format changed from float to no format for status