Commerce Search API (COMMERCE_SERP)

​

Solicitud

curl -X POST https://api.querying.ai/v1/async/task \
  -H "Authorization: Bearer $QUERYING_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "taskType": "COMMERCE_SERP", "payload": { "site": "amazon", "query": "wireless earbuds", "limit": 20 } }'

​

Parámetros

• site: Obligatorio. La tienda donde buscar, de la tabla siguiente.
• query: Consulta de búsqueda obligatoria, de 1 a 500 caracteres.
• country: Opcional. Por defecto, el país de la tienda. Cualquier otro país se rechaza con 422 REGION_UNSUPPORTED.
• limit: Entero opcional de 1 a 40, con 20 por defecto.

​

Ejemplo de respuesta

{
  "site": "amazon",
  "query": "wireless earbuds",
  "country": "US",
  "returnedCount": 1,
  "products": [
    {
      "rank": 1,
      "productId": "B0CHWRXH8B",
      "title": "Wireless Earbuds, Bluetooth 5.3 Headphones",
      "url": "https://www.amazon.com/dp/B0CHWRXH8B",
      "price": 24.99,
      "currency": "USD",
      "rating": 4.6,
      "reviewCount": 19406
    }
  ]
}

​

Campos del resultado

• site, query y country repiten la solicitud. returnedCount es el número de elementos de products.
• Cada producto incluye rank, productId, title y url. productId es el ID de producto propio de la tienda, como el ASIN en Amazon, el número de artículo en eBay o shop:item en Rakuten. rank sigue el orden predeterminado de la tienda. Salvo en Coupang, omite los anuncios que la tienda marca como patrocinados.
• price, rating, reviewCount, imageUrl y brand aparecen cuando la página de resultados los muestra. price es un número en la currency (ISO 4217) de cada producto: una misma búsqueda de Amazon puede mostrar más de una moneda. Si los tamaños tienen precios distintos, price es el más bajo. Los precios de Target son los de su tienda en línea predeterminada. Los precios de AliExpress son los precios de venta que ve un comprador de EE. UU. sin iniciar sesión.
• rating usa una escala de cinco estrellas. Kurly y Zalando no muestran valoraciones, AliExpress muestra estrellas sin el número de valoraciones, y los recuentos abreviados como 999+ se omiten. brand llega de Target, Sephora, Ulta, Olive Young, Lotte ON, Musinsa, Yahoo! Shopping, Qoo10, Flipkart, Myntra, Nykaa y Zalando, que muestran la marca aparte del título.
• En google_shopping, productId es el ID de producto de Google, o el ID de la oferta cuando Google no ha agrupado el anuncio en un producto. La página de Google no enlaza la página del producto ni la del comercio, así que url es la página de resultados de Google Shopping donde apareció el producto, con #product={productId}&title={title} al final. Pase esa url a Commerce Product para leer las tiendas, especificaciones y descripción del producto. seller es la tienda que Google muestra primero, y reviewCount aparece solo cuando Google muestra el número exacto (menos de 1.000).
• Cada búsqueda devuelve productos de la primera página de resultados de la tienda. Esa página muestra hasta 30 productos en Yahoo! Shopping, 32 en Myntra y 24 en Zalando. En Flipkart tiene 40 posiciones y en Nykaa 20, con los anuncios patrocinados incluidos.
• Si una tienda envía la búsqueda a otra página, los productos vienen de esa página: Ulta envía algunas marcas a su página de marca, Target envía algunas búsquedas a una búsqueda relacionada y Nykaa muestra la página de categoría en las búsquedas que nombran una categoría.
• Una búsqueda sin productos termina como tarea fallida. Se factura por búsqueda completada.

​

Relacionado

• Commerce Product
• Resumen de motores
• Créditos y límites