Skip to content
Topsort Documentation
API

Get Marketplace Report

GET
/v1/reporting-service/marketplace

Endpoint to get a marketplace’s total behavioral summary report between given dates.

Authentication

Topsort’s APIs are authenticated via bearer tokens. Requests must include an authorization header containing your private API key.

Don't have an API key yet? Learn how to generate one.

Authorization
required
string

The header containing a private API key. Format this header as follows:

Authorization: Bearer <YOUR-API-KEY>

Query Parameters

object
start_date
required

The start date for which reports will be generated.

string format: date

The start date for which reports will be generated.

end_date
required

The end date for which reports will be generated.

string format: date

The end date for which reports will be generated.

Responses

Successful Response

Clicks, impressions and purchases attributed to this report item so far.

application/json
object
clicks
required

How many clicks are attributed to this report item.

object
adSpent
required

Ad spent over a period of time, in minor units of currency according to ISO 4217.

integer format: int64
charged
required

Number of charged events.

integer format: int64
total
required

Total number of events.

integer format: int64
impressions
required

How many impressions are attributed to this report item.

object
adSpent
required

Ad spent over a period of time, in minor units of currency according to ISO 4217.

integer format: int64
charged
required

Number of charged events.

integer format: int64
total
required

Total number of events.

integer format: int64
purchases
required

How many purchases are attributed to this report item.

object
amount
required

Amount of money made by purchases over a period of time, in minor units of currency according to ISO 4217.

integer format: int64
count
required

Amount of purchase events.

integer format: int64
countByProduct

Purchase count by product. Available if count_by_product is set to true.

object
key
additional properties
integer
quantity
required

Amount of items purchased.

integer format: int64