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
curl --request GET \
--url https://api.topsort.com/public/v1/catalog-search-service/catalogs/categories \
--header 'Authorization: Bearer <token>'{
"hasMore": true,
"response": [
{
"id": "<string>",
"name": "<string>",
"parentId": "bneEmHKG2yUe",
"globalId": "CAT-12345",
"metadata": {
"associatedProducts": 100,
"description": "All drinks available in the marketplace.",
"globalName": "Beers",
"path": "Driks/Alcoholic/Beers",
"showInStore": true
}
}
],
"nextPage": "SSBzb2xlbW5seSBzd2VhciB0aGF0IEkgYW0gdXAgdG8gbm8gZ29vZAo="
}Get Categories
Get multiple categories from the catalog.
curl --request GET \
--url https://api.topsort.com/public/v1/catalog-search-service/catalogs/categories \
--header 'Authorization: Bearer <token>'{
"hasMore": true,
"response": [
{
"id": "<string>",
"name": "<string>",
"parentId": "bneEmHKG2yUe",
"globalId": "CAT-12345",
"metadata": {
"associatedProducts": 100,
"description": "All drinks available in the marketplace.",
"globalName": "Beers",
"path": "Driks/Alcoholic/Beers",
"showInStore": true
}
}
],
"nextPage": "SSBzb2xlbW5seSBzd2VhciB0aGF0IEkgYW0gdXAgdG8gbm8gZ29vZAo="
}Authorizations
A valid API key generated in Topsort's UI.
Query Parameters
Pagination cursor as provided in an earlier response. If provided will fetch the next page of results.
Response
Successful Response
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.
Array of categories. Empty when the catalog contains no categories.
Show child attributes
Show child attributes
Unique ID of the category. Topsort treats IDs as strings, choose any format as long as it is unique within the catalog.
1Category name. Shown in Topsort UI.
1ID of the parent category. Each category can have at most one parent category, allowing categories to be organized into hierarchies.
1"bneEmHKG2yUe"
Global ID of the category. This is an optional field that can be used to link the category to other marketplaces.
"CAT-12345"
Pagination cursor. Provide this value as a next_page query parameter in a new request to retrieve the next page of results.
1"SSBzb2xlbW5seSBzd2VhciB0aGF0IEkgYW0gdXAgdG8gbm8gZ29vZAo="
Was this page helpful?