Producto de compras

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

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

Ejemplos de solicitud

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

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

import requests
from pprint import pprint


# Estructura la carga útil.
payload = {
    "source": "google_shopping_product",
    "query": "[product_token_string]",
    "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_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();

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

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

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

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

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

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

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

Establece el scraper.

google_shopping_product

query

El token de producto de google_shopping_search

render

Habilita el renderizado de JavaScript cuando se establece en html. Obligatorio 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. 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

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

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 para cambios en el idioma de la interfaz. 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.

Datos estructurados

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

19KB

google_shopping_product-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 del 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.

string

title (opcional)

El título del listado del producto.

string

description

Una descripción detallada del producto.

string

images

Un objeto que contiene imágenes del producto.

object

images.full_size

Un array de URL de las imágenes del producto en tamaño completo.

array

images.thumbnails

Un array de URL de las imágenes en miniatura del producto.

array

pricing

Un array que contiene toda la información de precios en línea.

array

reviews

Un objeto que contiene información de reseñas. (solo US)

object

variants

Un array de objetos que contiene variantes del producto. (colores, tallas, etc.)

array

related_items

Un array de objetos que contiene artículos relacionados.

array

specifications

Un array de objetos que contiene las especificaciones del producto.

array

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.

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.

array

online.price

El precio del producto en la moneda especificada.

float

online.seller

El nombre del vendedor o comerciante que ofrece el producto.

string

online.details

Detalles adicionales sobre el producto, como entrega y políticas de devolución.

string

online.currency

El código de moneda del precio del producto.

string

online.condition

El estado del producto.

string

online.price_tax

La cantidad de impuestos aplicada al precio del producto.

float

online.price_total (opcional)

El precio total del producto, incluidos los impuestos.

float

online.seller_link

La URL de la página del vendedor para el producto.

string

online.price_shipping

El costo de envío del producto.

float

Reseñas

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

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

...       
       "reviews": {
    "rating": 4.7,
    "top_review": {
        "text": "Mi computadora es una Dell Optiplex 9020, i7-4770, 32mb, 500gb SSD. La tarjeta de 3 ventiladores es larga, y hubo que retirar la jaula del disco duro para que cupiera en la caja Optiplex. La fuente de alimentación se actualizó a 750 vatios, lo que requirió un adaptador para la placa base Dell. Con esas modificaciones fuera del camino, la instalación de la tarjeta fue sin problemas, pero hay que usar Google para encontrar el controlador en el sitio web de Nvidia. Estoy usando esta GPU para animación 3D en Blender. Estoy muy satisfecho con la velocidad del renderizado con ray tracing en EEVEE y Cycles. Como este es un ordenador antiguo, la CPU del ordenador nunca llega al 100%, y todavía no he podido exprimir al máximo la capacidad de esta tarjeta. No oigo los ventiladores funcionar, pero supongo que aún no la he sometido a una carga lo bastante alta. Sí emite un pequeño zumbido electrónico cuando está renderizando.\u00a0Menos",
        "author": "walmart.com Shopper",
        "rating": 5,
        "source": "Reseñado en walmart.com"
      },
      "rating_stars": 4.7,
      "reviews_count": 51,
      "reviews_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 valoración media del producto, normalmente sobre 5.

float

top_review (opcional)

Un objeto que contiene detalles de la reseña principal del producto.

object

top_review.text (opcional)

El contenido de texto de la reseña principal

string

top_review.title (opcional)

El título de la reseña principal.

string

top_review.author (opcional)

El autor de la reseña principal.

string

top_review.rating (opcional)

La valoración dada por el autor de la reseña principal, normalmente sobre 5.

float

top_review.source (opcional)

La fuente o el sitio web donde se publicó la reseña principal.

string

rating_stars

La valoración media del producto, normalmente sobre 5 estrellas.

float

reviews_count (opcional)

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

integer

reviews_by_stars

Un objeto que contiene el recuento de reseñas para cada valoración por estrellas.

object

reviews_by_stars.url (opcional)

Un objeto que contiene detalles de reseñas de X estrellas.

string

reviews_by_stars.reviews_count

El recuento de reseñas de X estrellas.

integer

Especificaciones

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

...
"specifications": [
    {
        "items": [
          {
            "title": "Fabricante",
            "value": "PNY"
          },
          {
            "title": "Salida",
            "value": "HDMI, DisplayPort"
          },
          {
            "title": "Interfaz",
            "value": "PCI Express"
          },
          {
            "title": "Marca",
            "value": "PNY"
          },
...
        ],
        "section_title": "atributos"
      }
],
...

Clave (specifications[])

Descripción

Tipo

items

Un array de objetos que contiene detalles individuales de especificaciones.

array

items.title

El título de la especificación.

string

items.value

El valor de la especificación.

string

section_title

El título o encabezado de la sección de especificaciones.

string

AnteriorBúsqueda de compras SiguientePrecios de compras

Última actualización hace 24 días

¿Te fue útil?

Buenas tardes

Producto de compras

Ejemplos de solicitud

Valores de los parámetros de solicitud

Genérico

Localización

Datos estructurados

Diccionario de datos de salida

Estructura JSON

Precios

Reseñas

Artículos relacionados (Más opciones)

Especificaciones