Sign in
Backlinks

Changed on

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

post/v3/backlinks/errors

Request

  • Base URL: https://api.dataforseo.com
  • URL: https://api.dataforseo.com/v3/backlinks/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>

offsetinteger nullable

<em>offset in the results array of returned tasks</em><br>optional field<br>default value: <code>0</code><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

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 a certain function<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>backlinks/live</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: "yyyy-mm-dd hh-mm-ss +00:00"<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>example:<br><code>2021-11-15 13:57:46 +00:00</code>

Example request

[
  {
    "limit": 10
  }
]

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

  • 57e6be77d985Revision changes
    • breaking

      the ////////////////// response's property type changed from integer to number for status