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

# Bannières sponsorisées sur les pages de recherche

> Apprenez à utiliser l'API d'enchères pour créer des enchères pour les résultats de recherche

Pour diffuser des bannières publicitaires ciblées sur vos pages de recherche en fonction des requêtes des utilisateurs, incluez simplement la requête de recherche et l'ID d'emplacement dans votre requête d'enchère.

Voici un exemple présentant un seul emplacement de bannière sur une page de résultats de recherche pour les appareils mobiles :

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

L'exemple de réponse ci-dessous fournit toutes les informations nécessaires pour diffuser la bannière publicitaire :

```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 peut être "product", "brand", "vendor" ou "url" en fonction de la cible
  de la campagne de bannières publicitaires gagnante.
</Note>