Auction examples
- Running auctions
- Sponsored listings
- Sponsored banners
- Sponsored brands
Asset examples
Webhook examples
Toptimize
Assets API
Billing API
- GETGet Billing Contacts
- GETGet Billing Contact
- PUTUpsert Billing Contact
- GETGet Campaign Billing Contact
- PUTUpsert Campaign Billing Contact
- GETGet Marketplace Credit Limit
- POSTSet Marketplace Credit Limit
- PUTUpsert Vendor Billing Contact
- GETGet Vendor Charges
- GETGet Vendor Account Activity
- GETGet Vendor Balance
- POSTAdd Vendor Balance
- POSTBurn Vendor Balance
- GETGet Vendor Credit History
- GETGet Vendor Credit Limit
- POSTSet Vendor Credit Limit
- DELDelete Vendor Billing Contact
- GETGet Vendor Wallets
- POSTCreate Wallet
- POSTAdjust Wallet Balance
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
- GETGet Campaign Report
- GETGet Campaign Daily Report
- GETGet Campaign Report By Product
- GETGet Product Report
- GETGet Product Daily Report
- GETGet Marketplace Interactions Report
- GETGet Marketplace Report
- GETGet Marketplace Campaigns Kpis
- GETGet Marketplace Daily Report
- GETGet Marketplace Vendors Kpis
- GETGet Vendor Report
- GETGet Vendor Daily Report
Segments Service
Toppie API
- GET[BETA] Get Agency Account Balance
- GET[BETA] Get Agency Account Top-ups
- GET[BETA] Get Toppie Campaigns
- POST[BETA] Create Toppie Campaign
- GET[BETA] Get Toppie Campaign Details
- PATCH[BETA] Update Toppie Campaign
- GET[BETA] Get Toppie Campaign Bids
- GETList Account Products
- 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
Create Campaign Bids
Endpoint to create a bid for a campaign.
curl --request POST \
--url https://api.topsort.com/public/v1/campaign-service/campaigns/{campaign-id}/bids \
--header 'Content-Type: application/json' \
--data '{
"bids": [
{
"amount": 1,
"formatProperties": {
"adFormat": "banner",
"bannerAssets": [
{
"assetId": "asset_01j713j64yfsvtj4bs3ccpy5ca",
"contentType": "image/png",
"dimensions": {
"height": 1080,
"width": 1920
},
"size": 123,
"url": "<string>"
}
],
"deviceType": "desktop",
"slotId": "<string>"
},
"location": "Santiago",
"target": {
"id": "p_8983",
"type": "product"
},
"trigger": {
"type": "keyword",
"value": {
"matchType": "exact",
"words": [
"<string>"
]
}
},
"triggers": [
{
"type": "keyword",
"value": {
"matchType": "exact",
"words": [
"<string>"
]
}
}
]
}
]
}'
{
"bids": [
{
"amount": 1,
"bidId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"bidsBehaviorData": "<string>",
"campaignId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"formatProperties": {
"adFormat": "banner",
"bannerAssets": [
{
"assetId": "asset_01j713j64yfsvtj4bs3ccpy5ca",
"contentType": "image/png",
"dimensions": {
"height": 1080,
"width": 1920
},
"size": 123,
"url": "<string>"
}
],
"deviceType": "desktop",
"slotId": "<string>"
},
"isActive": true,
"location": "Santiago",
"state": "active",
"target": {
"id": "p_8983",
"type": "product"
},
"trigger": {
"type": "keyword",
"value": {
"matchType": "exact",
"words": [
"<string>"
]
}
},
"triggers": [
{
"type": "keyword",
"value": {
"matchType": "exact",
"words": [
"<string>"
]
}
}
]
}
],
"hasMore": true,
"next": {
"limit": 123,
"offset": 123
}
}
Path Parameters
The ID of the campaign.
Query Parameters
Skip creating bids that already exist. Existing bids will not be updated and will not be returned in the response.
Body
An array of bids to be created.
The request model for bid creation.
Represents a promotable entity that will be returned upon a winning auction.
Maximum amount of money willing to offer for a sponsored slot in minor units of currency according to ISO 4217.
x > 0
The format properties of the bid. This field is required for banner ads. Should be not set for listing ads.
banner
The assets for the banner campaign, if adFormat
is banner
.
Represents the banner resource file, it's location, mimetype, dimensions and size.
Asset id, if created using the asset API.
33
"asset_01j713j64yfsvtj4bs3ccpy5ca"
The mime type of the asset. If asset_id is provided, this field will be ignored.
1
"image/png"
The file size of the asset, in bytes. If asset_id is provided, this field will be ignored.
The url where the asset is located. If asset_id is provided, this field will be ignored.
1 - 2083
The external slot id provided by the marketplace.
1
The targeted device for this campaign, if adFormat
is banner
.
mobile
, desktop
By using this option you will be able to target this campaign to a specific group.You must define the same location as a parameter on the auction request. Products on a specific campaign will have specific conversion rates, considering the context of location, so it will not interfere with the conversion rates for the same product in other campaigns.
1
"Santiago"
A list of objects that trigger the appearance of this bid on an auction.
When should this bid participate in an auction.
Response
The public response body of the bids endpoints.
An array of bids.
Represents an auction bid for a specific entity and a specific maximum amount.
The ID of the bid
The ID of the campaign.
Whether the bid is active.
The activity state of the bid.
active
, deactivated_manually
, inactive_entity
, deleted_entity
, legacy_inactive
A list of objects that trigger the appearance of this bid on an auction.
When should this bid participate in an auction.
Maximum amount of money willing to offer for a sponsored slot in minor units of currency according to ISO 4217.
x > 0
Deprecated. This field is always null. For behavioral data use reporting service.
banner
The assets for the banner campaign, if adFormat
is banner
.
Represents the banner resource file, it's location, mimetype, dimensions and size.
Asset id, if created using the asset API.
33
"asset_01j713j64yfsvtj4bs3ccpy5ca"
The mime type of the asset. If asset_id is provided, this field will be ignored.
1
"image/png"
The file size of the asset, in bytes. If asset_id is provided, this field will be ignored.
The url where the asset is located. If asset_id is provided, this field will be ignored.
1 - 2083
The external slot id provided by the marketplace.
1
The targeted device for this campaign, if adFormat
is banner
.
mobile
, desktop
By using this option you will be able to target this campaign to a specific group.You must define the same location as a parameter on the auction request. Products on a specific campaign will have specific conversion rates, considering the context of location, so it will not interfere with the conversion rates for the same product in other campaigns.
1
"Santiago"
Whether this is the last page of results or not.
curl --request POST \
--url https://api.topsort.com/public/v1/campaign-service/campaigns/{campaign-id}/bids \
--header 'Content-Type: application/json' \
--data '{
"bids": [
{
"amount": 1,
"formatProperties": {
"adFormat": "banner",
"bannerAssets": [
{
"assetId": "asset_01j713j64yfsvtj4bs3ccpy5ca",
"contentType": "image/png",
"dimensions": {
"height": 1080,
"width": 1920
},
"size": 123,
"url": "<string>"
}
],
"deviceType": "desktop",
"slotId": "<string>"
},
"location": "Santiago",
"target": {
"id": "p_8983",
"type": "product"
},
"trigger": {
"type": "keyword",
"value": {
"matchType": "exact",
"words": [
"<string>"
]
}
},
"triggers": [
{
"type": "keyword",
"value": {
"matchType": "exact",
"words": [
"<string>"
]
}
}
]
}
]
}'
{
"bids": [
{
"amount": 1,
"bidId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"bidsBehaviorData": "<string>",
"campaignId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"formatProperties": {
"adFormat": "banner",
"bannerAssets": [
{
"assetId": "asset_01j713j64yfsvtj4bs3ccpy5ca",
"contentType": "image/png",
"dimensions": {
"height": 1080,
"width": 1920
},
"size": 123,
"url": "<string>"
}
],
"deviceType": "desktop",
"slotId": "<string>"
},
"isActive": true,
"location": "Santiago",
"state": "active",
"target": {
"id": "p_8983",
"type": "product"
},
"trigger": {
"type": "keyword",
"value": {
"matchType": "exact",
"words": [
"<string>"
]
}
},
"triggers": [
{
"type": "keyword",
"value": {
"matchType": "exact",
"words": [
"<string>"
]
}
}
]
}
],
"hasMore": true,
"next": {
"limit": 123,
"offset": 123
}
}