Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.topsort.com/llms.txt

Use this file to discover all available pages before exploring further.

High-visibility locations like the homepage and landing pages (specially crafted standalone pages for marketing purposes) are excellent choices for displaying relevant and engaging banner ads. To serve banner ads on these pages, start by configuring your banner slots. When making auction requests for landing pages, ensure that the category and searchQuery fields are left empty. Here’s an example with only one banner slot on the search results page on desktop: 
{
  "auctions": [
    {
      "type": "banners",
      "slots": 1,
      "slotId": "backtoschool_banners_top",
      "device": "desktop"
    }
  ]
}
You can see a sample response with everything you need to serve the banner ads. 
{
  "results": [
    {
      "winners": [
        {
          "rank": 1,
          "winnerType": "brand",
          "winnerId": "p_PJbnN",
          "resolvedBidId": "WyJlX1BKYm5OIiwiMTJhNTU4MjgtOGVhZC00Mjk5LTgzMjctY2ViYjAwMmEwZmE4IiwiYmFubmVyQWRzIiwiZGVmYXVsdCIsIiJd",
          "asset": [
            {
              "url": "https://topsort.cdnprovider.com/lhs-banner-image-for-p_PJbnN-1x.png"
            }
          ]
        }
      ],
      "error": false
    }
  ]
}