> ## 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.

# Gesponserte Banner auf Suchseiten

> Erfahren Sie, wie Sie die Auction API verwenden, um Auktionen für Suchergebnisse zu erstellen

Um zielgerichtete Banner-Anzeigen auf Ihren Suchseiten basierend auf Benutzeranfragen bereitzustellen, fügen Sie einfach die Suchanfrage und die Slot-ID in Ihre Auktionsanfrage ein.

Hier ist ein Beispiel mit einem einzelnen Banner-Slot auf einer Suchergebnisseite für mobile Geräte:

```json theme={null}
{
  "auctions": [
    {
      "type": "banners",
      "slots": 1,
      "slotId": "search_banner_top",
      "device": "mobile",
      "searchQuery": "blue running shoes"
    }
  ]
}
```

Die untenstehende Beispielantwort liefert alle Informationen, die zum Bereitstellen der Banner-Anzeige erforderlich sind:

```json theme={null}
{
  "results": [
    {
      "winners": [
        {
          "rank": 1,
          "winnerType": "product",
          "winnerId": "p_PJbnN",
          "resolvedBidId": "WyJlX1BKYm5OIiwiMTJhNTU4MjgtOGVhZC00Mjk5LTgzMjctY2ViYjAwMmEwZmE4IiwiYmFubmVyQWRzIiwiZGVmYXVsdCIsIiJd",
          "asset": [
            {
              "url": "https://topsort.cdnprovider.com/lhs-banner-image-for-p_PJbnN-1x.png"
            }
          ]
        }
      ],
      "error": false
    }
  ]
}
```

<Note>
  winnerType kann "product", "brand", "vendor" oder "url" sein, abhängig vom Ziel
  der gewinnenden Banner-Anzeigenkampagne.
</Note>