Auction examples
Webhook examples
Toppie API
- GET[BETA] Get Toppie Campaigns
- POST[BETA] Create Toppie Campaign
- GET[BETA] Get Agency Account Report.
- GET[BETA] Get Campaigns Reporting.
- GET[BETA] Account Activity Reports.
- GETGet Agency Daily Kpis By Product Dump Urls
- GET[BETA] List Account Products
- GET[BETA] Get Toppie Campaign Details
- DEL[BETA] Delete Toppie Campaign
- PATCH[BETA] Update Toppie Campaign
- GET[BETA] Get Toppie Campaign Bids
- GET[BETA] Get Campaign Report.
- GET[BETA] Get Campaign Products Report.
Campaign API
- GETGet Restriction Types
- GETGet Json Templates
- POSTCreate Json Template
- GETGet Campaigns
- POSTCreate Campaign
- POST[BETA] Get estimated clicks of a future campaign for a given vendordeprecated
- GETGet Sponsored Productsdeprecated
- GETGet Products In Campaign
- POST[BETA] Create exclusive listing campaign.
- POST[BETA] Create exclusive banner campaign.
- GETGet Campaign Restriction
- POSTCreate Campaign Restriction
- PATCHUpdate Campaign Restriction
- GETGet Restriction Type
- GETGet Json Template
- PATCHUpdate Json Template
- GETGet Campaign By Id
- DELDelete Campaign By Id
- PATCHUpdate Campaign By Id
- GETGet Campaign Bids
- POSTCreate Campaign Bids
- DELDelete All Bids From A Campaign
- DELDelete Campaign Bid By Id
- PATCHUpdate Campaign Bid By Id
- GETGet Campaign Products
- PUTUpsert Campaign Products
- GET[BETA] Get exclusive listing campaign by ID.
- PATCH[BETA] Update exclusive listing campaign by ID.
- GET[BETA] Get exclusive banner campaign by ID.
- PATCH[BETA] Update exclusive banner campaign by ID.
Catalog API
Billing API
- GETGet Marketplace Credit Limitdeprecated
- POSTSet Marketplace Credit Limitdeprecated
- GETGet Vendor Chargesdeprecated
- GETGet Billing Contacts
- PUTUpsert Vendor Billing Contact
- GETGet Campaign Billing Contact
- PUTUpsert Campaign Billing Contact
- GETGet Vendor Wallets
- POSTCreate Wallet
- GETGet Vendor Credit Limitdeprecated
- POSTSet Vendor Credit Limitdeprecated
- GETGet Vendor Credit Historydeprecated
- GETGet Vendor Account Activitydeprecated
- GETGet Vendor Balance
- POSTAdd Vendor Balance
- POSTBurn Vendor Balance
- POSTAdjust Wallet Balance
- GETGet Billing Contact
- PUTUpsert Billing Contact
- DELDelete Vendor Billing Contact
Reporting API
- GETGet Marketplace Report
- GETGet Marketplace Daily Report
- GETGet Marketplace Vendors Kpis
- GETGet Marketplace Campaigns Kpis
- GETGet Marketplace Interactions Report
- GETGet Scored Attribution Dump Urls
- GETGet Interactions Dump Urls
- GETGet Vendor Report
- GETGet Vendor Daily Report
- GETGet Campaign Report
- GETGet Campaign Daily Report
- GETGet Product Daily Report
- GETGet Campaign Report By Product
- GETGet Product Report
Invitation API
Assets API
Segments Service
Offsite Ads API
- POSTCreate a new advertiser
- GETGet vendor offsite campaigns
- POSTCreate Campaign
- GETList Audiences
- POST[BETA] Create offsite user list audience job.
- PUTUpsert Advertiser Domain
- GETGet Job Status
- GETGet advertiser onboarding state for a specific DSP
- GETGet campaign information
- PATCHUpdate Campaign
- GETGet Campaign Products Report
- GETGet Campaign Aggregated Report
- GETGet Campaign Daily Report
Forecasting Service
API Reference
[BETA] Get Agency Account Report.
Copy
Ask AI
curl --request GET \
--url https://api.topsort.com/public/v1/toppie/reporting \
--header 'Authorization: Bearer <token>'Copy
Ask AI
{
"reports": [
{
"adSpend": 1,
"cpc": 123,
"ctr": 123,
"conversionRate": 123,
"impressions": 1,
"chargedImpressions": 1,
"clicks": 1,
"chargedClicks": 1,
"purchaseCount": 1,
"purchaseRevenue": 1,
"roas": 123,
"timegroup": "2023-12-25"
}
]
}Toppie API
[BETA] Get Agency Account Report.
Retrieve a general report for an account.
GET
/
public
/
v1
/
toppie
/
reporting
[BETA] Get Agency Account Report.
Copy
Ask AI
curl --request GET \
--url https://api.topsort.com/public/v1/toppie/reporting \
--header 'Authorization: Bearer <token>'Copy
Ask AI
{
"reports": [
{
"adSpend": 1,
"cpc": 123,
"ctr": 123,
"conversionRate": 123,
"impressions": 1,
"chargedImpressions": 1,
"clicks": 1,
"chargedClicks": 1,
"purchaseCount": 1,
"purchaseRevenue": 1,
"roas": 123,
"timegroup": "2023-12-25"
}
]
}Authorizations
A valid API key generated in Topsort's UI.
Query Parameters
The start date for which reports will be generated.
The end date for which reports will be generated.
Response
Successful Response
Show child attributes
Show child attributes
Amount spent on ads during the selected period in minor units of currency.
Required range:
x >= 0Average cost per click during the selected period.
The click through rate during the selected period.
The conversion rate during the selected period.
Number of impressions during the selected period.
Required range:
x >= 0Amount of charged impressions during the selected period.
Required range:
x >= 0Number of clicks during the selected period.
Required range:
x >= 0Amount of charged clicks during the selected period.
Required range:
x >= 0Number of purchases during the selected period.
Required range:
x >= 0Revenue from promoted sales during the selected period in minor units of currency.
Required range:
x >= 0The return on ad spend during the selected period.
Timegroup for the Kpis.
Was this page helpful?
⌘I