Búsqueda de compras

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

La 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 siguiente, 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 del payload.
payload = {
    "source": "google_shopping_search",
    "query": "nvidia rtx",
    "render": "html",
    "parse": True
}

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

# Print prettified response to 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();

https://realtime.oxylabs.io/v1/queries?source=google_shopping_search&query=nvidia+rtx&render=html&parse=true&access_token=12345abcde

<?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();
    }
}

{
    "source": "google_shopping_search",
    "query": "nvidia rtx",
    "render": "html",
    "parse": true
}

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

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

Valores de los parámetros de solicitud

Genérico

Parámetro

Descripción

Valor predeterminado

source

Configura el scraper.

google_shopping_search

consulta

La palabra clave o frase que se buscará.

render

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

parse

Devuelve datos analizados cuando se establece en true. Explorar la salida diccionario de datos.

false

callback_url

URL para 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 a la que debe adaptarse el resultado. Usar correctamente este parámetro 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: Los parámetros de localización (gl y hl) ahora están incrustados en el token de producto. Para recuperar google_shopping_products datos que coincidan con el resultado de búsqueda original, recomendamos dejar estos campos vacíos a menos que se necesiten sobrescrituras intencionales.

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 ajustar el contexto de búsqueda o 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

contexto: sort_by

Ordena la lista de productos según un criterio dado. r aplica la ordenación predeterminada de Google, rv - por puntuación de reseñas, p - por precio ascendente, pd - por precio descendente.

r

contexto: min_price

Precio mínimo de los productos a filtrar.

contexto: max_price

Precio máximo de los productos a filtrar.

contexto: nfpr

true desactivará la autocorrección ortográfica.

Datos estructurados

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

google_shopping_search-output.json

998KB

Abrir

Diccionario de datos de salida

Ejemplo en HTML

Estructura JSON

La tabla siguiente 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.

cadena

page

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

entero

results

Un objeto que contiene resultados de búsqueda detallados.

objeto

pla (opcional)

Una lista de anuncios de productos con sus respectivos detalles.

arreglo

filters (opcional)

Lista de varios filtros.

arreglo

organic

Una lista de resultados orgánicos con sus respectivos detalles.

arreglo

información_de_búsqueda

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

objeto

search_information.query

El término de búsqueda original.

cadena

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 autocorrigió el término de búsqueda proporcionado.

cadena

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 desplazándose).

entero

parse_status_code

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

entero

creado_en

La marca de tiempo en que se creó el trabajo de scraping.

marca_de_tiempo

actualizado_en

La marca de tiempo en que terminó el trabajo de scraping.

marca_de_tiempo

código_de_estado

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

entero

id_del_trabajo

El ID del trabajo asociado con el trabajo de scraping.

cadena

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

Anuncios de listado patrocinados

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: Negro",
                "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: Blanco",
                "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 en la página.

arreglo

pos

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

entero

url

La URL del producto.

cadena

precio

El precio del producto en el anuncio de listado.

cadena

title

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

cadena

rating

La valoración del producto.

entero

vendedor

El vendedor del producto en el anuncio de listado.

cadena

thumbnail

La URL de la imagen en miniatura del producto.

cadena

reviews_count

La cantidad de reseñas del producto.

opcional

pos_overall

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

entero

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": "Black"
            },
                                ...
                                {
                "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

nombre

El nombre de la categoría del filtro

cadena

values

Opciones de filtro disponibles dentro de la categoría.

arreglo

values.url

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

cadena

values.value

El nombre visible de la opción de filtro

cadena

values.merchant_id (opcional)

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

cadena

Orgánico

Un array de objetos que contiene detalles de 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": "Tarjeta gráfica NVIDIA GeForce RTX 5090 32 GB GDDR7",
        "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 (organic)

Descripción

Tipo

pos

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

entero

url

La URL de la página del producto.

cadena

type

El tipo de diseño del listado.

cadena

precio

El precio del producto en la moneda especificada.

flotante

title

El título del listado del producto.

cadena

token

El token del producto.

cadena

rating (opcional)

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

entero

moneda

El código de moneda del precio del producto.

cadena

delivery

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

cadena

merchant (opcional)

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

objeto

merchant.name

El nombre del comerciante.

cadena

price_str

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

cadena

thumbnail

La URL de la imagen en miniatura del producto.

cadena

product_id

Un identificador único del producto.

cadena

pos_overall

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

entero

reviews_count (opcional)

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

entero

AnteriorCompras

SiguienteProducto de compras

Última actualización hace 20 días

¿Te fue útil?