GET
/
public
/
v1
/
reporting-service
/
marketplace
/
campaigns-kpis
curl --request GET \
  --url https://api.topsort.com/public/v1/reporting-service/marketplace/campaigns-kpis
{
  "campaignsKpis": [
    {
      "adSpend": 1,
      "campaignId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "campaignName": "<string>",
      "chargedClicks": 1,
      "chargedImpressions": 1,
      "clicks": 1,
      "conversionRate": 123,
      "cpc": 123,
      "ctr": 123,
      "endDate": "2023-11-07T05:31:56Z",
      "impressions": 1,
      "purchaseCount": 1,
      "purchaseRevenue": 1,
      "roas": 123,
      "startDate": "2023-11-07T05:31:56Z",
      "vendorId": "<string>"
    }
  ],
  "hasMore": true,
  "nextPage": "SSBzb2xlbW5seSBzd2VhciB0aGF0IEkgYW0gdXAgdG8gbm8gZ29vZAo="
}

Query Parameters

​
limit
integer
default:100

The pagination limit.

Required range: 0 <= x <= 100
​
next_page
string

Pagination cursor as provided in an earlier response. If provided will fetch the next page of results.

​
start_date
string
required

The start date for which reports will be generated.

​
end_date
string
required

The end date for which reports will be generated.

​
search
string

The search string for a given query.

​
ad_format
enum<string>

The ad format for which reports will be generated. If not specified, all ad formats will be included.

Available options:
listing,
banner,
exclusive_listing,
travel_listing,
flight_listing
​
vendor_id
string

External vendor ID.

​
order_by
string[]

Order by field. Must be one of: impressions, charged_impressions, clicks, charged_clicks, purchase_count, purchase_revenue, ad_spend, cpc, cpm, ctr, conversion_rate, roas, vendor_id, vendor_name, timegroup, campaign_name, campaign_id, status, ad_format or active_campaigns.

​
direction
string[]

Order direction. Must be one of: asc, desc.

Response

200
application/json
Successful Response

Response for marketplace campaign KPIs using external vendor IDs.

​
campaignsKpis
object[]
required

A list with the marketplace campaign KPIs.

Response for campaign KPIs using external vendor IDs.

​
hasMore
boolean
required

Flag that indicates whether more results are available. true indicates there is a next page of results. false indicates this response contains the last page of results.

​
nextPage
string

Pagination cursor. Provide this value as a next_page query parameter in a new request to retrieve the next page of results.

Minimum length: 1
Example:

"SSBzb2xlbW5seSBzd2VhciB0aGF0IEkgYW0gdXAgdG8gbm8gZ29vZAo="