Auction examples
- Running auctions
- Sponsored listings
- Sponsored banners
- Sponsored brands
Asset examples
Webhook examples
Assets API
Billing API
Campaign API
- GETGet Campaigns
- POSTCreate Campaign
- GETGet Campaign By Id
- DELDelete Campaign By Id
- PATCHUpdate Campaign By Id
- GETGet Campaign Bids
- POSTCreate Campaign Bids
- DELDelete Campaign Bid By Id
- PATCHUpdate Campaign Bid By Id
- POST[BETA] Get estimated clicks of a future campaign for a given vendor
- GETGet Products In Campaign
- GETGet Sponsored Products
Catalog API
Invitation API
Modal API
Reporting API
Toppie API
- GET[BETA] Get Toppie Campaigns
- POST[BETA] Create Toppie Campaign
- GET[BETA] Get Toppie Campaign Details
- GET[BETA] Get Toppie Campaign Bids
- GETGet Agency Account Report
- GETGet Agency Account Activity
- GETGet Agency Account Campaigns
- GETGet Account Campaigns By Ids
- GETGet Agency Campaign Report
- GETGet Campaign Report Per Product
Get Account Campaigns By Ids
Retrieve reports for multiple campaigns using their IDs.
curl --request GET \
--url https://api.topsort.com/public/v1/toppie/reporting/campaigns-by-id{
"campaigns": [
{
"adSpend": 1,
"agencyCampaignId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"chargedClicks": 1,
"chargedImpressions": 1,
"clicks": 1,
"conversionRate": 123,
"cpc": 123,
"ctr": 123,
"impressions": 1,
"purchaseCount": 1,
"purchaseRevenue": 1,
"roas": 123
}
]
}Query Parameters
The start date for which reports will be generated.
The end date for which reports will be generated.
List of campaign IDs to retrieve.
Response
Amount spent on ads during the selected period in minor units of currency.
x > 0The campaign id.
Amount of charged clicks during the selected period.
x > 0Amount of charged impressions during the selected period.
x > 0Number of clicks during the selected period.
x > 0The conversion rate during the selected period.
Average cost per click during the selected period.
The click through rate during the selected period.
Number of impressions during the selected period.
x > 0Number of purchases during the selected period.
x > 0Revenue from promoted sales during the selected period in minor units of currency.
x > 0The return on ad spend during the selected period.
curl --request GET \
--url https://api.topsort.com/public/v1/toppie/reporting/campaigns-by-id{
"campaigns": [
{
"adSpend": 1,
"agencyCampaignId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"chargedClicks": 1,
"chargedImpressions": 1,
"clicks": 1,
"conversionRate": 123,
"cpc": 123,
"ctr": 123,
"impressions": 1,
"purchaseCount": 1,
"purchaseRevenue": 1,
"roas": 123
}
]
}