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
    }'

import requests
from pprint import pprint


# Estructura la carga útil.
payload = {
    "source": "google_shopping_search",
    "query": "nvidia rtx",
    "render": "html",
    "parse": True
}

# Obtén la respuesta.
response = requests.request(
    "POST",
    "https://realtime.oxylabs.io/v1/queries",
    auth=("USERNAME", "PASSWORD"),
    json=payload,
)

# Imprime la respuesta con formato en stdout.
pprint(response.json())

const https = require("https");

const username = "USERNAME";
const password = "PASSWORD";
const body = {
    source: "google_shopping_search",
    query: "nvidia rtx",
    render: "html",
    parse: true
};

const options = {
    hostname: "realtime.oxylabs.io",
    path: "/v1/queries",
    method: "POST",
    headers: {
        "Content-Type": "application/json",
        Authorization:
            "Basic " + Buffer.from(`${username}:${password}`).toString("base64"),
    },
};

const request = https.request(options, (response) => {
    let data = "";

    response.on("data", (chunk) => {
        data += chunk;
    });

    response.on("end", () => {
        const responseData = JSON.parse(data);
        console.log(JSON.stringify(responseData, null, 2));
    });
});

request.on("error", (error) => {
    console.error("Error:", error);
});

request.write(JSON.stringify(body));
request.end();

<?php

$params = array(
    'source' => 'google_shopping_search',
    'query' => 'nvidia rtx',
    'render' => 'html',
    'parse' => true
);

$ch = curl_init();

curl_setopt($ch, CURLOPT_URL, "https://realtime.oxylabs.io/v1/queries");
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($params));
curl_setopt($ch, CURLOPT_POST, 1);
curl_setopt($ch, CURLOPT_USERPWD, "USERNAME" . ":" . "PASSWORD");

$headers = array();
$headers[] = "Content-Type: application/json";
curl_setopt($ch, CURLOPT_HTTPHEADER, $headers);

$result = curl_exec($ch);
echo $result;

if (curl_errno($ch)) {
    echo 'Error:' . curl_error($ch);
}
curl_close($ch);

package main

import (
	"bytes"
	"encoding/json"
	"fmt"
	"io/ioutil"
	"net/http"
)

func main() {
	const Username = "USERNAME"
	const Password = "PASSWORD"

	payload := map[string]interface{}{
		"source": "google_shopping_search",
		"query":  "nvidia rtx",
		"render": "html",
		"parse":  true,
	}

	jsonValue, _ := json.Marshal(payload)

	client := &http.Client{}
	request, _ := http.NewRequest("POST",
		"https://realtime.oxylabs.io/v1/queries",
		bytes.NewBuffer(jsonValue),
	)

	request.SetBasicAuth(Username, Password)
	response, _ := client.Do(request)

	responseText, _ := ioutil.ReadAll(response.Body)
	fmt.Println(string(responseText))
}

using System;
using System.Collections.Generic;
using System.Net.Http;
using System.Net.Http.Json;
using System.Threading.Tasks;

namespace OxyApi
{
    class Program
    {
        static async Task Main()
        {
            const string Username = "USERNAME";
            const string Password = "PASSWORD";

            var parameters = new {
                source = "google_shopping_search",
                query = "nvidia rtx",
                render = "html",
                parse = true
            };

            var client = new HttpClient();

            Uri baseUri = new Uri("https://realtime.oxylabs.io");
            client.BaseAddress = baseUri;

            var requestMessage = new HttpRequestMessage(HttpMethod.Post, "/v1/queries");
            requestMessage.Content = JsonContent.Create(parameters);

            var authenticationString = $"{Username}:{Password}";
            var base64EncodedAuthenticationString = Convert.ToBase64String(System.Text.ASCIIEncoding.UTF8.GetBytes(authenticationString));
            requestMessage.Headers.Add("Authorization", "Basic " + base64EncodedAuthenticationString);

            var response = await client.SendAsync(requestMessage);
            var contents = await response.Content.ReadAsStringAsync();

            Console.WriteLine(contents);
        }
    }
}

package org.example;

import okhttp3.*;
import org.json.JSONArray;
import org.json.JSONObject;
import java.util.concurrent.TimeUnit;

public class Main implements Runnable {
    private static final String AUTHORIZATION_HEADER = "Authorization";
    public static final String USERNAME = "USERNAME";
    public static final String PASSWORD = "PASSWORD";

    public void run() {
        JSONObject jsonObject = new JSONObject();
        jsonObject.put("source", "google_shopping_search");
        jsonObject.put("query", "nvidia rtx");
        jsonObject.put("render", "html");
        jsonObject.put("parse", true);

        Authenticator authenticator = (route, response) -> {
            String credential = Credentials.basic(USERNAME, PASSWORD);
            return response
                    .request()
                    .newBuilder()
                    .header(AUTHORIZATION_HEADER, credential)
                    .build();
        };

        var client = new OkHttpClient.Builder()
                .authenticator(authenticator)
                .readTimeout(180, TimeUnit.SECONDS)
                .build();

        var mediaType = MediaType.parse("application/json; charset=utf-8");
        var body = RequestBody.create(jsonObject.toString(), mediaType);
        var request = new Request.Builder()
                .url("https://realtime.oxylabs.io/v1/queries")
                .post(body)
                .build();

        try (var response = client.newCall(request).execute()) {
            if (response.body() != null) {
                try (var responseBody = response.body()) {
                    System.out.println(responseBody.string());
                }
            }
        } catch (Exception exception) {
            System.out.println("Error: " + exception.getMessage());
        }

        System.exit(0);
    }

    public static void main(String[] args) {
        new Thread(new Main()).start();
    }
}

Nota: Solo los trabajos analizados renderizados devolverán tokens de producto.

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.

Nota: asegúrate de que tus parámetros de localización para google_shopping_product y google_shopping_search las fuentes sean los mismos (ninguno si no está definido). Un desajuste regional entre las fuentes puede dar lugar a datos incompletos o inexactos.

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:

...
"context": [
    {
        "key": "filter",
        "value": "0"
    }
]
...

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.

998KB

google_shopping_search-output.json

Abrir

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)

...
  "pla": [
    {
        "items": [
            {
                "pos": 1,
                "url": "/aclk?sa=l&ai=DChcSEwiY8fLUi9OGAxVtj1AGHYnVBj0YABABGgJkZw&gclid=EAIaIQobChMImPHy1IvThgMVbY9QBh2J1QY9EAQYASABEgKpS_D_BwE&sig=AOD64_2DguiyFTR4GRY6Ww9o__l9HgJC_A&ctype=5&q=&ved=0ahUKEwj-6ezUi9OGAxWiWUEAHdbxAgsQww8I2xA&adurl=",
                "price": "$2,199.00",
                "title": "Polycade Sente: Black",
                "seller": "Polycade",
                "thumbnail": "https://encrypted-tbn0.gstatic.com/shopping?q=tbn:ANd9GcS59ZNOrZH96cy_cOgzxL52VoJYq9iPl7q8g26f9odcuG8pY8ZRxe9YMhkZDPnFAZDyP04lu29gy57ObwsKpWHb_pzQBja34tkErnSAz3nw&usqp=CAE"
            },
            {
                "pos": 2,
                "url": "/aclk?sa=l&ai=DChcSEwiY8fLUi9OGAxVtj1AGHYnVBj0YABADGgJkZw&gclid=EAIaIQobChMImPHy1IvThgMVbY9QBh2J1QY9EAQYAiABEgJwHvD_BwE&sig=AOD64_0LFB8jrHwNdEkmOdjcjGOdhQ9ZVg&ctype=5&q=&ved=0ahUKEwj-6ezUi9OGAxWiWUEAHdbxAgsQww8I3hA&adurl=",
                "price": "$2,199.00",
                "title": "Polycade Sente: White",
                "seller": "Polycade",
                "thumbnail": "https://encrypted-tbn2.gstatic.com/shopping?q=tbn:ANd9GcQ2onFg_aXbg8LTX3qJT9f9XdiFrl_SNLXlpKhSjCQQ2c5EmQcrNXPwCMphjugJUhWctBpRVC0BiS4OUnq0FRAeQ4BXEWI6FuvZvGERsLc&usqp=CAE"
            },
                                ...
        ],
        "pos_overall": 1
    }
],
...

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

...
"filters": [
    {
        "name": "Mostrar solo",
        "values": [
            {
                "url": "/search?sca_esv=bbd3241cb3940ce2&sca_upv=1&gl=us&hl=en&tbm=shop&q=adidas&tbs=mr:1,sales:1&sa=X&ved=0ahUKEwikoMX_iNOGAxVvFbkGHV6uDZcQ7KEGCJ4WKAA",
                "value": "En oferta"
            }
        ]
    },
    {
        "name": "Precio",
        "values": [
            {
                "url": "/search?sca_esv=bbd3241cb3940ce2&sca_upv=1&gl=us&hl=en&tbm=shop&q=adidas&tbs=mr:1,price:1,ppr_max:40&sa=X&ved=0ahUKEwikoMX_iNOGAxVvFbkGHV6uDZcQvSsIohYoAA",
                "value": "Hasta $40"
            },
                                ...
                                {
                "url": "/search?sca_esv=bbd3241cb3940ce2&sca_upv=1&gl=us&hl=en&tbm=shop&q=adidas&tbs=mr:1,price:1,ppr_min:90&sa=X&ved=0ahUKEwikoMX_iNOGAxVvFbkGHV6uDZcQvSsIpRYoAw",
                "value": "Más de $90"
            }
        ]
    },
    {
        "name": "Color",
        "values": [
            {
                "url": "/search?sca_esv=bbd3241cb3940ce2&sca_upv=1&gl=us&hl=en&tbm=shop&q=adidas&tbs=mr:1,color:specific,color_val:black&sa=X&ved=0ahUKEwikoMX_iNOGAxVvFbkGHV6uDZcQtSsIrBYoAA",
                "value": "Negro"
            },
                                ...
                                {
                "url": "/search?sca_esv=bbd3241cb3940ce2&sca_upv=1&gl=us&hl=en&tbm=shop&q=adidas&tbs=mr:1,color:specific,color_val:pink&sa=X&ved=0ahUKEwikoMX_iNOGAxVvFbkGHV6uDZcQtSsIshYoBg",
                "value": "Rosa"
            }
        ]
    },
                        ...
]

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.

...
"organic": [
    {
        "pos": 1,
        "url": "https://www.google.com/shopping/product/16307418470740744792?q=nvidia+rtx&hl=en&udm=28&sei=j5fsaPC2FYWQur8P293m8A8&gl=us",
        "type": "grid",
        "price": 3090,
        "title": "NVIDIA GeForce RTX 5090 32GB GDDR7 Graphics Card",
        "token": "eyJjYXRhbG9naWQiOiAiMTYzMDc0MTg0NzA3NDA3NDQ3OTIiLCAiZ3BjaWQiOiAiMjM4NTIwNzk2NTI4MjUxMzUzOSIsICJpbWFnZURvY2lkIjogIjkyMjY0MjkwODMxMzQ4NDkwNDUiLCAibWlkIjogIiIsICJwdm8iOiAiMjMiLCAicHZ0IjogImhnIiwgInJkcyI6ICJQQ18yMzg1MjA3OTY1MjgyNTEzNTM5fFBST0RfUENfMjM4NTIwNzk2NTI4MjUxMzUzOSIsICJwcm9kdWN0aWQiOiAiIiwgInF1ZXJ5IjogIm52aWRpYSBydHgifQ==",
        "rating": 4.6,
        "currency": "USD",
        "delivery": "Entrega gratis para el viernes",
        "merchant": {
            "name": "eBay"
        },
        "price_str": "$3,090.00",
        "thumbnail": "<THUMBNAIL_STR>",
        "product_id": "1503163696221055935",
        "pos_overall": 1,
        "reviews_count": 311
    },
]
...

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

AnteriorCompras SiguienteProducto de compras

Última actualización hace 24 días

¿Te fue útil?