Auctions

Create travel auctions

Use the /auctions/travel endpoint to create batch auctions for sponsored travel listings. We support two types of sponsored travel listings, hotels and flights. Each batch of auction requests can be a combination of sponsored hotel and flight listing auctions. Each auction type has a unique body schemas.

post/v2/auctions/travel

Request

  • Base URL: https://api.topsort.com
  • URL: https://api.topsort.com/v2/auctions/travel
  • Auth: HTTP bearer

Request body

Example request

{
  "auctions": [
    {
      "type": "hotels",
      "slots": 2,
      "travelContext": {
        "site": "argentina"
      }
    }
  ]
}

Response

The travel auction results. The list of winners will contain at most winners entries per auction. It may contain fewer or no entries at all if there aren't enough products with usable bids, that is, a bid amount greater than the reserve price and belonging to a campaign with enough remaining budget. Bids become unusable if campaign budget is exhausted, the bid is disqualified to preserve spend pacing, etc.

Example response

{
  "results": [
    {
      "winners": [
        {
          "resolvedBidId": "WyJiX01mazE1IiwiMTJhNTU4MjgtOGVhZC00Mjk5LTgzMjctY2ViYjAwMmEwZmE4IiwibGlzdGluZ3MiLCJkZWZhdWx0IiwiIl0=",
          "campaignId": "82588593-85c5-47c0-b125-07e315b7f2b3"
        }
      ]
    }
  ]
}

Changes

No recorded changes to this operation across all 1 revision of this API.