Búsqueda de compras

Extrae resultados de búsqueda de Google Shopping con datos analizados de listados de productos orgánicos y anuncios de listados de pago, incluyendo precios, valoraciones, reseñas, tokens de producto y más.

El google_shopping_search source devuelve resultados de búsqueda de Google Shopping. Cada resultado renderizado incluye un token de producto que es necesario para recopilar datos del producto usando el google_shopping_product source.

Ejemplos de solicitud

En el ejemplo de código a continuación, buscamos "Nvidia RTX" para obtener el producto token en la respuesta.

curl 'https://realtime.oxylabs.io/v1/queries' \
--user 'USERNAME:PASSWORD' \
-H 'Content-Type: application/json' \
-d '{
    "source": "google_shopping_search",
    "query": "nvidia rtx",
    "render": "html",
    "parse": true
    }'

Usamos el método de integración síncrona Realtime en nuestros ejemplos. Si deseas usar Proxy Endpoint o la integración asíncrona Push-Pull consulta la sección de métodos de integración .

Valores de los parámetros de solicitud

Genérico

Parámetro
Descripción
Valor predeterminado

source

Establece el scraper.

google_shopping_search

query

La palabra clave o frase a buscar.

-

render

Habilita el renderizado de JavaScript. Debe configurarse en html para obtener el producto tokens. Más información.

-

parse

Devuelve datos analizados cuando se establece en true. Explora el diccionario de datos.

false

callback_url

URL de tu endpoint de callback. Más información

-

user_agent_type

Tipo de dispositivo y navegador. La lista completa se puede encontrar aquí.

desktop

- parámetro obligatorio

Localización

Parámetro
Descripción
Valor predeterminado

geo_location

La ubicación geográfica para la que se debe adaptar el resultado. Usar este parámetro correctamente es extremadamente importante para obtener los datos correctos. Para más información, lee sobre nuestras geo_location estructuras de parámetros aquí.

-

locale

Accept-Language valor del encabezado que cambia el idioma de la interfaz web de tu página de búsqueda de Google. Más información.

-

Paginación

Controles para gestionar la paginación y la recuperación de resultados de búsqueda.

Parámetro
Descripción
Valor predeterminado

start_page

Número de página inicial.

1

pages

Número de páginas a recuperar.

1

Parámetros de contexto

Opciones avanzadas para adaptar el contexto de búsqueda o los controles para requisitos especializados. Los parámetros de contexto deben añadirse a un array de contexto como se muestra a continuación:

Parámetro
Descripción
Valor predeterminado

context: sort_by

Ordena la lista de productos por un criterio dado. r aplica el orden predeterminado de Google, rv - por puntuación de reseñas, p - por precio ascendente, pd - por precio descendente.

r

context: min_price

Precio mínimo de los productos para filtrar.

-

context: max_price

Precio máximo de los productos para filtrar.

-

context: nfpr

true desactivará la autocorrección ortográfica.

-

Datos estructurados

A continuación puedes encontrar un ejemplo de salida estructurada para google_shopping_search.

Diccionario de datos de salida

Ejemplo HTML

Estructura JSON

La tabla a continuación presenta una lista detallada de cada elemento de la página de búsqueda que analizamos, junto con su descripción y tipo de dato. La tabla también incluye algunos metadatos.

Clave
Descripción
Tipo

url

La URL de la página de búsqueda de Google Shopping para la consulta.

string

page

El número de página actual de los resultados de búsqueda.

integer

resultados

Un objeto que contiene resultados de búsqueda detallados.

object

pla (opcional)

Una lista de anuncios de fichas de producto con sus respectivos detalles.

array

filtros (opcional)

Lista de varios filtros.

array

organic

Una lista de listados no pagados con sus respectivos detalles.

array

search_information

Una lista de detalles de la consulta de búsqueda enviada.

object

search_information.query

El término de búsqueda original.

string

search_information.showing_results_for

El término de búsqueda para el que se muestran los resultados. `query` y `showing_results_for` pueden diferir si Google corrigió automáticamente el término de búsqueda proporcionado.

string

last_visible_page

Valor que identifica el número máximo de página visible en la página de resultados de la consulta de búsqueda. (-1 cuando la carga de más resultados se inicia al desplazarse).

integer

parse_status_code

El código de estado del trabajo de análisis. Puedes ver los códigos de estado del analizador descritos aquí.

integer

created_at

La marca de tiempo cuando se creó el trabajo de scraping.

timestamp

updated_at

La marca de tiempo cuando terminó el trabajo de scraping.

timestamp

status_code

El código de estado del trabajo de scraping. Puedes ver los códigos de estado del scraper descritos aquí.

integer

job_id

El ID del trabajo asociado con el trabajo de scraping.

string

En las siguientes secciones, los fragmentos de código JSON analizados están abreviados cuando hay más de un elemento disponible para el tipo de resultado.

Anuncios de listados pagados

Un array de objetos que contiene anuncios de listado de productos (PLA) para el producto. (Ejemplo ilustrativo)

Clave (pla)
Descripción
Tipo

items

Todos los PLA disponibles dentro de la página.

array

pos

Un indicador que denota la posición de un elemento dado entre los resultados PLA.

integer

url

La URL del producto.

string

price

El precio del producto en el anuncio del listado.

string

title

El título del producto en el anuncio del listado.

string

rating

La calificación del producto.

integer

seller

El vendedor del producto en el anuncio del listado.

string

miniatura

La URL de la imagen miniatura del producto.

string

reviews_count

El número de reseñas del producto.

opcional

pos_overall

Una indicación de la posición del resultado dentro de la SERP.

integer

Filtros

Clave (filters)
Descripción
Tipo

name

El nombre de la categoría de filtro

string

values

Opciones de filtro disponibles dentro de la categoría.

array

values.url

La URL que representa la consulta de búsqueda filtrada para esta opción de filtro.

string

values.value

El nombre mostrado de la opción de filtro

string

values.merchant_id (opcional)

El ID del comerciante asociado con esta opción de filtro.

string

Orgánico

Un array de objetos que contiene detalles de los resultados de búsqueda orgánicos.

Clave (orgánico)
Descripción
Tipo

pos

La posición del producto en los resultados de búsqueda.

integer

url

La URL de la página del producto.

string

type

El tipo de diseño del listado.

string

price

El precio del producto en la moneda especificada.

float

title

El título del listado del producto.

string

token

El token del producto.

string

rating (opcional)

La calificación media de los usuarios del producto, normalmente sobre 5.

integer

moneda

El código de moneda del precio del producto.

string

entrega

Detalles de entrega, incluida la fecha estimada de entrega y la política de devoluciones.

string

merchant (opcional)

Un objeto que contiene detalles sobre el comerciante que vende el producto.

object

merchant.url

La URL de la página del comerciante.

string

merchant.name

El nombre del comerciante.

string

price_str

El precio del producto como cadena, incluyendo el símbolo de moneda.

string

miniatura

La URL de la imagen miniatura del producto.

string

product_id

Un identificador único del producto.

string

pos_overall

La posición general del producto en los resultados de búsqueda.

integer

reviews_count (opcional)

El número total de reseñas del producto.

integer

Última actualización

¿Te fue útil?