BusinessData

Changed on

This endpoint is designed to provide you with a list of IDs and metadata for all Business Data tasks created within the specified time period, including both successful and uncompleted tasks.

post/v3/business_data/id_list

Request

  • Base URL: https://api.dataforseo.com
  • URL: https://api.dataforseo.com/v3/business_data/id_list
  • Auth: HTTP basic

Request body

datetime_fromstring

<em>start time for filtering results</em><br><strong>required field</strong><br>if <code>include_metadata</code> is set to <code>true</code>, maximum value: a month from current datetime;<br>if <code>include_metadata</code> is set to <code>false</code>, maximum value: six months from current datetime;<br>must be specified in the UTC format: "yyyy-mm-dd hh-mm-ss +00:00"<br>example:<br><code>2023-01-15 12:57:46 +00:00</code>

datetime_tostring

<em>finish time for filtering results</em><br><strong>required field</strong><br>maximum value: current datetime;<br>must be specified in the UTC format: "yyyy-mm-dd hh-mm-ss +00:00"<br>example:<br><code>2023-01-31 13:57:46 +00:00</code>

limitinteger nullable

<em>the maximum number of returned task IDs</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 task IDs</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

sortstring nullable

<em>sorting by task execution time</em><br>optional field<br>possible values: <code>"asc"</code>, <code>"desc"</code><br>default value: <code>"asc"</code>

include_metadataboolean nullable

<em>include task metadata in the respond</em><br>optional field<br>default value: <code>false</code>

Example request

[
  {
    "datetime_from": "2026-09-22 05:48:19",
    "datetime_to": "2026-10-02 05:48:19",
    "limit": 10,
    "include_metadata": true
  }
]

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

  • 5948818f63bdRevision changes
    • breaking

      the ////////////////// response's property type changed from array to object for status

  • a751331174cfRevision changes
    • breaking

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