Producto de compras

Recupera datos detallados de productos de Google Shopping, incluidos precios, reseñas, especificaciones y variantes, usando Web Scraper API.

La google_shopping_product source recupera información detallada del producto (título, descripción, precios, vendedores, elementos relacionados, reseñas, etc.) de Google Shopping usando un token de producto obtenido de google_shopping_search (aquí) o google_search.

Ejemplos de solicitud

En el ejemplo de código siguiente, hacemos una solicitud para recuperar la página del producto de un producto de Google Shopping usando un token válido.

cURL

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

Python

import requests
from pprint import pprint


# Estructura del payload.
payload = {
    "source": "google_shopping_product",
    "query": "[product_token_string]",
    "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())

Node.js

const https = require("https");

const username = "USERNAME";
const password = "PASSWORD";
const body = {
    source: "google_shopping_product",
    query: "[product_token_string]",
    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();

HTTP

https://realtime.oxylabs.io/v1/queries?source=google_shopping_product&query=[product_token_string]&parse=true&access_token=12345abcde

PHP

<?php

$params = array(
    'source' => 'google_shopping_product',
    'query' => '[product_token_string]',
    '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);

Golang

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_product",
		"query": "[product_token_string]",
		"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))
}

C#

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_product",
                query = "[product_token_string]",
                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);
        }
    }
}

Java

package org.example;

import okhttp3.*;
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_product");
        jsonObject.put("query", "[product_token_string]");
        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();
    }
}

JSON

{
    "source": "google_shopping_product",
    "query": "[product_token_string]",
    "render": "html",
    "parse": true
}

Importante: La consulta El parámetro debe contener un token válido generado a través de google_shopping_search source.

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

Opciones básicas de configuración y personalización para extraer páginas de productos de Google Shopping.

Parámetro	Descripción	Valor predeterminado
source	Configura el scraper.	google_shopping_product
consulta	El token de producto de google_shopping_search o google_search	-
render	Habilita el renderizado de JavaScript cuando se establece en html. Requerido para recibir resultados adicionales de precios de la sección "Más tiendas". 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

Adapta los resultados a ubicaciones geográficas, dominios e idiomas específicos.

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.

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 para cambios de idioma de la interfaz. Más información.	-

Datos estructurados

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

google_shopping_product-output.json

19KB

Abrir

Diccionario de datos de salida

Muestra HTML

Estructura JSON

La tabla de abajo presenta una lista detallada de cada elemento de la página de producto 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 del producto de Google Shopping.	cadena
title (opcional)	El título del listado del producto.	cadena
description	Una descripción detallada del producto.	cadena
images	Un objeto que contiene imágenes del producto.	objeto
images.full_size	Un array de URLs de imágenes del producto en tamaño completo.	arreglo
images.thumbnails	Un array de URLs de imágenes en miniatura del producto.	arreglo
pricing	Un array que contiene toda la información de precios en línea.	arreglo
reseñas	Un objeto que contiene información de reseñas. (solo EE. UU.)	objeto
variants	Un array de objetos que contiene variantes del producto. (colores, tamaños, etc.)	arreglo
related_items	Un array de objetos que contiene elementos relacionados.	arreglo
especificaciones	Un array de objetos que contiene especificaciones del producto.	arreglo
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.

Precios

Un objeto que contiene información de precios del producto.

...
   "pricing": {
    "online": [
        {
          "price": 559,
          "seller": "Walmart - Seller",
          "details": "Pny GeForce RTX 4070 GPU 12gb Xlr8 Gaming Verto Epic-x RGB Triple Fan Dlss 3 Graphics Card",
          "currency": "USD",
          "condition": "Nuevo",
          "seller_link": "https://www.walmart.com/ip/PNY-GeForce-RTX-4070-GPU-12GB-XLR8-Gaming-VERTO-EPIC-X-RGB-Triple-Fan-DLSS-3-Graphics-Card/1396859462?wmlspartner=wlpa&selectedSellerId=101035116&selectedOfferId=159733DADC653E1891C050148D16D747&conditionGroupCode=1",
          "price_shipping": 22.05
        },
...
    ]
},
...

Clave (pricing[])	Descripción	Tipo
online	Un array de objetos que contiene detalles de precios del producto.	arreglo
online.price	El precio del producto en la moneda especificada.	flotante
online.seller	El nombre del vendedor o comerciante que ofrece el producto.	cadena
online.details	Detalles adicionales sobre la compra del producto, como las políticas de entrega y devolución.	cadena
online.currency	El código de moneda del precio del producto.	cadena
online.condition	La condición del producto.	cadena
online.seller_link	La URL de la página del vendedor para el producto.	cadena
online.price_shipping	El costo de envío del producto.	flotante

Reseñas

Un objeto que contiene información de reseñas y calificaciones del producto.

Por el momento, las reseñas solo están disponibles en la configuración regional de EE. UU.

...       
       "reviews": {
    "rating": 4.7,
    "top_review": {
        "text": "My computer is a Dell Optiplex 9020, i7-4770, 32mb, 500gb SSD. The 3 fan card is a long, and the hard drive cage had to be removed to fit in the Optiplex case. The power supply was upgraded to 750 watts which required an adapter for the Dell motherboard. With those modifications out of the way, installation of the card was drama free, but you have use Google to find the driver in the Nvidia website. I am using this GPU for 3D animation in Blender. I am very pleased with the speed of the rendering with ray tracing in EEVEE and Cycles. As this is an old computer, the computer's CPU never runs at 100%, and I haven't been able to max out this card's capacity yet. I don't hear the fans running but I have never put a high load enough on it yet, I guess. It does have a little electronic buzz when it is rendering.\u00a0Less",
        "author": "walmart.com Shopper",
        "rating": 5,
        "source": "Reviewed on walmart.com"
      },
      "rating_stars": 4.7,
      "reviews_count": 51,
      "review_count_by_stars": {
        "1": {
          "reviews_count": 2
        },
        "2": {
          "reviews_count": 0
        },
        "3": {
          "reviews_count": 2
        },
        "4": {
          "reviews_count": 3
        },
        "5": {
          "reviews_count": 44
        }
    },
},
...

Clave(reviews[])	Descripción	Tipo
rating	La calificación promedio del producto, normalmente sobre 5.	flotante
top_review (opcional)	Un objeto que contiene detalles de la reseña principal del producto.	objeto
top_review.text (opcional)	El contenido de texto de la reseña principal	cadena
top_review.title (opcional)	El título de la reseña principal.	cadena
top_review.author (opcional)	El autor de la reseña principal.	cadena
top_review.rating (opcional)	La calificación dada por el autor de la reseña principal, normalmente sobre 5.	flotante
top_review.source (opcional)	La fuente o sitio web donde se publicó la reseña principal.	cadena
rating_stars	La calificación promedio del producto, normalmente sobre 5 estrellas.	flotante
reviews_count (opcional)	El número total de reseñas del producto.	entero
review_count_by_stars	Un objeto que contiene el recuento de reseñas para cada calificación por estrellas.	objeto
review_count_by_stars.url (opcional)	Un objeto que contiene detalles de reseñas de X estrellas.	cadena
review_count_by_stars.reviews_count	El recuento de reseñas de X estrellas.	entero

Elementos relacionados (Más opciones)

Un array de objetos que contiene elementos relacionados para el producto objetivo.

...             
   "related_items": [
      {
        "items": [
          {
            "url": "/search?ibp=oshop&prds=catalogid:1368129371371338580,gpcid:14975392695437189622,headlineOfferDocid:2388507960063782588,imageDocid:1618178582933849531,productid:7780474142858650836,pvo:2,pvt:hg,rds:PC_14975392695437189622%7CPROD_PC_14975392695437189622&q=nvidia+rtx&gl=us&hl=en&pvorigin=2",
            "image": "https://encrypted-tbn3.gstatic.com/shopping?q=tbn:ANd9GcScO-LIdlqj1WjcLznMECFXNo4qbZ1TRbkfHdDsDPoIYxx7S9TjKhnQX7Ah6QsKI-zPBKFrC54H0wGZC60Q_NdRebesvYUXwRhQFuZRwvtWmx4_0xoxbylM",
            "price": 639.99,
            "title": "NVIDIA GeForce RTX 5070 12GB GDDR7 Graphics Card",
            "currency": "USD",
            "reviews_count": 228
          },
...
        ],
        "title": "More options"
     }
],
...

Clave(related_items[])	Descripción	Tipo
items	Un array de objetos que contiene detalles de cada elemento relacionado.	arreglo
items.url	La URL de la página del producto relacionado.	cadena
items.image	La URL de la imagen del producto relacionado.	cadena
items.price	El precio del producto relacionado en la moneda especificada.	flotante
items.title (opcional)	El título del listado del producto relacionado.	cadena
items.rating (opcional)	La calificación promedio de los usuarios del producto relacionado, normalmente sobre 5.	entero
items.store (opcional)	El nombre de la tienda o comerciante que ofrece el producto relacionado.	cadena
items.currency	El código de moneda del precio del producto.	cadena
items.reviews_count	El número total de reseñas del producto relacionado.	entero
title	El título o encabezado de la sección de elementos relacionados	cadena

Especificaciones

Un array de objetos que contiene detalles de especificaciones del producto.

...
"specifications": [
    {
        "items": [
          {
            "title": "Manufacturer",
            "value": "PNY"
          },
          {
            "title": "Output",
            "value": "HDMI, DisplayPort"
          },
          {
            "title": "Interface",
            "value": "PCI Express"
          },
          {
            "title": "Brand",
            "value": "PNY"
          },
...
        ],
        "section_title": "attributes"
      }
],
...

Clave (specifications[])	Descripción	Tipo
items.title	El título de la especificación.	cadena
items.value	El valor de la especificación.	cadena