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

# Listings patrocinados en resultados de búsqueda

> Aprenda cómo usar listings patrocinados en resultados de búsqueda

El ejemplo en esta página muestra cómo ejecutar [subastas](/en/ad-server/auctions/auctions-api) para productos que se originan en resultados de búsqueda.

Hay dos formas de ejecutar este tipo de subastas:

* Usando el parámetro `searchQuery`, donde solo las ofertas que se dirijan a productos con palabras clave coincidentes tendrán la oportunidad de ganar tales subastas.
* Usando un [conjunto de productos](/en/api-reference/examples/sponsored-listings/set-of-products) y adicionalmente usar el parámetro `searchQuery` para expandir la lista de ofertas agregando productos con palabras clave coincidentes a los del conjunto de productos.

## Casos de uso

Ejecutar este tipo de subastas en páginas de búsqueda permitirá a sus vendedores promover productos dentro de los resultados de búsqueda.

## Ejemplo de llamada API

### Solicitud: usando `searchQuery`

```json theme={null}
{
  "auctions": [
    {
      "type": "listings",
      "slots": 2,
      "searchQuery": "Running shoes"
    }
  ]
}
```

La solicitud anterior creará una sola subasta de listings:

* Tendrá un máximo de dos ganadores debido al campo `slots`.
* El campo `searchQuery` determina qué palabras clave deben tener los objetivos de oferta.

Solo las ofertas que se dirijan a productos con la palabra clave `Running shoes` pueden participar en esta subasta.

### Respuesta

```json theme={null}
{
  "results": [
    {
      "winners": [
        {
          "rank": 1,
          "type": "product",
          "id": "p_Mfk15",
          "resolvedBidId": "WyJiX01mazE1IiwiMTJhNTU4MjgtOGVhZC00Mjk5LTgzMjctY2ViYjAwMmEwZmE4IiwibGlzdGluZ3MiLCJkZWZhdWx0IiwiIl0="
        },
        {
          "rank": 2,
          "type": "product",
          "id": "p_PJbnN",
          "resolvedBidId": "WyJlX1BKYm5OIiwiMTJhNTU4MjgtOGVhZC00Mjk5LTgzMjctY2ViYjAwMmEwZmE4IiwibGlzdGluZ3MiLCJkZWZhdWx0IiwiIl0="
        }
      ],
      "error": false
    }
  ]
}
```

Notable aquí:

* El tipo de los ganadores es `product`, porque estamos ejecutando una subasta de listings.
* Hay dos ganadores, el máximo permitido por el campo `slots` en la solicitud.

### Solicitud: combinando productos y `searchQuery`

```json theme={null}
{
  "auctions": [
    {
      "type": "listings",
      "slots": 2,
      "products": {
        "ids": [
          "p_ojng4",
          "p_8VKDt",
          "p_Mfk15"
        ]
      }
      "searchQuery": "Running shoes"
    }
  ]
}
```

La solicitud anterior creará una sola subasta de listings:

* Tendrá un máximo de dos ganadores debido al campo `slots`.
* El campo `searchQuery` determina qué palabras clave deben tener los objetivos de oferta.

Los productos que entran en esta subasta serán `"p_ojng4"`, `"p_8VKDt"`, `"p_Mfk15"` y aquellos con una palabra clave que coincida con `searchQuery`.

### Respuesta

```json theme={null}
{
  "results": [
    {
      "winners": [
        {
          "rank": 1,
          "type": "product",
          "id": "p_Mfk15",
          "resolvedBidId": "WyJiX01mazE1IiwiMTJhNTU4MjgtOGVhZC00Mjk5LTgzMjctY2ViYjAwMmEwZmE4IiwibGlzdGluZ3MiLCJkZWZhdWx0IiwiIl0="
        },
        {
          "rank": 2,
          "type": "product",
          "id": "p_PJbnN",
          "resolvedBidId": "WyJlX1BKYm5OIiwiMTJhNTU4MjgtOGVhZC00Mjk5LTgzMjctY2ViYjAwMmEwZmE4IiwibGlzdGluZ3MiLCJkZWZhdWx0IiwiIl0="
        }
      ],
      "error": false
    }
  ]
}
```

Comentarios notables:

* El tipo de los ganadores es `product`, porque estamos ejecutando una subasta de listings.
* Hay dos ganadores, el máximo permitido por el campo `slots` en la solicitud.
* El ganador en el rango 1 `"p_Mfk15"` proviene del conjunto de productos y el rango 2 `"p_PJbnN"` proviene de palabras clave coincidentes
  ya que su `id` no se especificó en la solicitud de subasta.

<Note>
  Ejecutar subastas usando el parámetro `searchQuery` mejora a Topsort para
  mejorar el algoritmo de coincidencia de palabras clave.
</Note>

<Warning>
  Usar este tipo de subastas no permite usar **quality scores**.
</Warning>

## Próximos pasos

Los ganadores deberán combinarse con datos de productos para crear un resultado que pueda mostrarse al usuario final.

Consulte [esta página](/en/api-reference/examples/sponsored-listings/combining-results) para ver un ejemplo.