Topsort's core API has 2 endpoints, /auctions and /events. Auctions are responsible for deciding the winner - often times a product or a listing or a creative that wins a unique promoted impression. Events are used for tracking the performance of the promoted listings and banners. You can monitor and check API Status here
Avoid round trip
Since we are intent on minimizing the impact of running auctions over your app, there is no redirect your app from trailing
/endpoints to avoid an extra round trip before auction winners are returned, i.e. use
Topsort Core API is authenticated via a bearer token. Requests must include an authorization header containing a marketplace API key. If such header is missing or invalid, the HTTP response code will be
POST /v1/auctions HTTP/2 Host: sandbox.app.topsort.com ... Authorization: Bearer <YOUR-API-KEY> ...
Obtaining an API Key
By this point we will have provided you with credentials to log into Topsort's Auctions Manager. After logging in, open the API Integration page, then click on the Generate API key button.
- This token is not meant to be a public key. Please keep this token for server usage only, do not share it.
- If you have multiple marketplaces, you'll need to keep a set of API keys through different instances.