Sign in
Merchant

Changed on

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

post/v3/merchant/errors

Request

  • Base URL: https://api.dataforseo.com
  • URL: https://api.dataforseo.com/v3/merchant/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>sellers/ad_url</code>, <code>postback_url</code>, <code>pingback_url</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,
    "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

  • 57e6be77d985Revision changes
    • breaking

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

  • a751331174cfRevision changes
    • breaking

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