Reports

Create a report to retrieve analytics for each of your products using synchronous or asynchronous requests depending on the size of your data.

For more information available in the Reports API, check our documentation below:

path Parameters
accountId
required
string
query Parameters
v
required
string

A date in YYYYMMDD format.

async
boolean

Defaults to false. When true, the report’s ID will be returned immediately and the report results can be fetched later. When false, the report results will be returned immediately, but an error may occur if the data requested is too large.

callback
string

Optional. When async=true and callback is specified, the provided URL will be called when the report is ready. The URL must be of the form:

POST https://[your domain]/[your path]

It must accept the following parameters:

id:         (string)  - The ID of the report request which completed.
status:     (string)  - One of [DONE, FAILED] indicating the result of the request.
statusCode: (int)     - An HTTP status code indicating the result of the request.
message:    (string)  - When status=FAILED, contains an error message.
url:        (string)  - When status=DONE, contains the URL to download the report data as a text file.
Request Body schema: application/json

JSON object containing any filters to be applied to the report

metrics
required
Array of strings

The kinds of data the report should include. Specify up to 10 values.

dimensions
required
Array of strings

Determines how the data will be grouped. Specify up to 10 values.

NOTES:
You can only use one time-based dimension (e.g., DAYS, WEEKS) per report.
You can only use one location-based dimension (e.g., FOLDER_IDS, LOCATION_NAMES) per report.

object

Responses

Request samples

Content type
application/json
{
  • "metrics": [
    ],
  • "dimensions": [
    ],
  • "filters": {
    }
}

Response samples

Content type
application/json
{
  • "meta": {
    },
  • "response": {
    }
}
Feedback