API de Google Shopping
Google Shopping reúne productos y ofertas de comercios encontrados por Google. search devuelve hasta 100 productos de una consulta con precio, comercio, valoración, número de reseñas, imagen e ID de producto.
Los precios siguen el mercado elegido con country (por defecto us), así que la moneda cambia con él; price es el número extraído de price_text. Acota con min_price y max_price, u ordena por precio o valoración con sort.
Disponibilidad de la plataforma
- Salud 24 h
- Normal
Últimos 30 días
Funciones disponibles
Cada acción de Google Shopping, qué hace, su precio y su salud en las últimas 24 horas. Abre una acción para ver sus parámetros, campos de respuesta y ejemplos de código.
| Capacidad | Qué hace | Por 1.000 | Salud en 24 horas |
|---|---|---|---|
Buscar productos en Google Shoppingsearch | Envía una keyword para listar hasta 100 productos de Google Shopping con title, price, price_text, old_price, merchant, rating, review_count, image_url, product_id y url. | $0.56 por 1.000 solicitudes | Normal |
Abre una capacidad para ver sus parámetros, campos de respuesta, ejemplos de código y prueba.
¿Qué acepta cada acción de Google Shopping?
Cada respuesta enlaza una acción ejecutable con sus entradas reales. El significado y los valores permitidos pertenecen a esa acción; un nombre parecido no conserva automáticamente el mismo sentido en otra plataforma.
Las fuentes oficiales se enlazan solo para precisar el término de la plataforma indicado a su lado. No implican autorización ni respaldo y no añaden a EveryInfra funciones del sitio oficial.
| Acción | Obligatorios | Opcionales | Entrega | Límite | Por 1.000 | Campos de respuesta |
|---|---|---|---|---|---|---|
searchBuscar productos en Google Shopping Envía una | keyword | country, language, max_price, min_price, sort | Entrega síncrona | El catálogo declara defaultLimit = 20 y maxLimit = 100 para el límite de esta acción. Según la acción, la unidad puede aplicarse a una página, a cada elemento padre o a otra unidad propia de la acción; no es necesariamente el total final de filas de toda la solicitud. | $0.56 por 1.000 solicitudes | rank · title · product_id · offer_id · image_id · price_text · price · old_price_text · old_price · merchant · multiple_merchants · rating · rating_scale · review_count · image_url · url · platform |
¿Qué significan los parámetros de Google Shopping search?
Envía una keyword para listar hasta 100 productos de Google Shopping con title, price, price_text, old_price, merchant, rating, review_count, image_url, product_id y url. Filtra con country, language, min_price, max_price y sort.
keywordObligatorio- Término de búsqueda del producto, como
wireless earbuds. countryOpcional- Código de país de dos letras, como
us,gbode, del mercado de Google Shopping (por defectous). Los precios van en la moneda de ese mercado. languageOpcional- Código de idioma de dos letras, como
enode, para títulos y etiquetas (por defectoen). max_priceOpcional- Precio máximo; no inferior a
min_price. min_priceOpcional- Precio mínimo, en la moneda del mercado de
country; 0 o más.Google Merchant Center: precio y precio de oferta en la especificación de datos de producto — La especificación de datos de producto de Google Merchant Center indica que los comercios envían productos con atributos como título, precio (price) y un precio de oferta opcional (sale_price), y que Google usa esos datos para emparejar productos con búsquedas. La fuente solo confirma que los precios de Google Shopping salen de los datos de los comercios y distinguen precio normal y de oferta; `min_price` y `max_price` de esta API filtran en la moneda del país buscado, los define EveryInfra y la fuente no garantiza el filtro ni el número de resultados. · Consultada sortOpcional- Orden:
price_low(precio de menor a mayor),price_high(de mayor a menor) orating(mejor valorados primero). Sin él, por relevancia.
Cómo usar la API de Google Shopping
- 01Consulta el catálogo público y elige una acción de la plataforma.
- 02Envía los parámetros platform y action, junto con los campos obligatorios, a POST /api/v1/social.
- 03Procesa el resultado síncrono o consulta el identificador de trabajo cuando la acción se ejecute de forma asíncrona.
- 04Guarda los campos de la respuesta estructurada que necesita tu aplicación.
curl -X POST https://api.everyinfra.com/api/v1/social \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{"platform":"google_shopping","action":"search","params":{"keyword":"<keyword>"}}'
Preguntas sobre la API de Google Shopping
¿Cómo llamo a la API de Google Shopping?
Envía POST /api/v1/social con platform igual a google_shopping, elige uno de los identificadores de acción indicados e incluye sus parámetros obligatorios.
¿Qué devuelve la API de Google Shopping?
Devuelve JSON estructurado. Por ejemplo, el esquema de search incluye rank, title, product_id y offer_id. Cada acción tiene su propia lista de campos; que un campo esté declarado no garantiza que todos los registros tengan un valor.
¿Qué matiz de la documentación oficial conviene conservar al usar datos de Google Shopping?
La especificación de datos de producto de Google Merchant Center indica que los comercios envían productos con atributos como título, precio (price) y un precio de oferta opcional (sale_price), y que Google usa esos datos para emparejar productos con búsquedas. La fuente solo confirma que los precios de Google Shopping salen de los datos de los comercios y distinguen precio normal y de oferta; min_price y max_price de esta API filtran en la moneda del país buscado, los define EveryInfra y la fuente no garantiza el filtro ni el número de resultados.
¿Qué parámetros son obligatorios?
Depende de la acción. search requiere keyword.
¿Las acciones de Google Shopping responden de inmediato?
Las acciones marcadas como asíncronas devuelven un identificador de trabajo que se consulta por sondeo. Cualquier otra acción también puede ejecutarse de forma asíncrona: añade "mode": "async" al cuerpo de la solicitud para recibir el identificador de inmediato, útil para tareas lentas o límites altos.