Shopping Product

Recupera datos detallados de productos de Google Shopping incluyendo 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 adquirido de google_shopping_search source.

Solicitar ejemplos

En el ejemplo de código siguiente, hacemos una solicitud para recuperar la página del 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


# Estructurar 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,
)

# Imprimir la respuesta formateada 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íncrono Realtime en nuestros ejemplos. Si desea usar Proxy Endpoint o asíncrono Push-Pull para la integración, consulte los métodos de integración sección.

Valores de parámetros de la solicitud

Genérico

Configuración básica y opciones de 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

user_agent_type

Activa el renderizado de JavaScript cuando se establece en html. Requerido para recibir resultados de precios adicionales de la sección "Más tiendas". Más información.

parse

Devuelve datos parseados cuando se establece en true. Explore la salida diccionario de datos.

false

callback_url

URL de su 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 y idiomas específicos.

Parámetro

Descripción

Valor predeterminado

geo_location

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

dominio

Localización del dominio de Google. La lista completa de dominios disponibles se puede encontrar aquí.

com

localidad

Accept-Language valor del encabezado para cambios en el idioma de la interfaz. Más información.

context: results_language

Idioma de los resultados. La lista de idiomas de Google soportados se puede encontrar aquí.

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án definidos). La desalineación regional entre las fuentes puede resultar en 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 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 de producto en Google Shopping.

string

title

El título del anuncio del producto.

string

description

Una descripción detallada del producto.

string

images

Un objeto que contiene imágenes del producto.

object

images.full_size

Una matriz de URL para imágenes de tamaño completo del producto.

array

images.thumbnails

Una matriz de URL para imágenes en miniatura del producto.

array

pricing

Una matriz que contiene toda la información de precios en línea.

array

reseñas

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

object

variants

Una matriz de objetos que contiene variantes del producto. (colores, tallas, etc.)

array

related_items

Una matriz de objetos que contiene artículos relacionados.

array

specifications

Una matriz de objetos que contiene especificaciones del producto.

array

parse_status_code

El código de estado del trabajo de parseo. Puede ver los códigos de estado del parser descritos aquí.

integer

created_at

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

timestamp

updated_at

La marca de tiempo cuando el trabajo de scraping fue finalizado.

timestamp

status_code

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

integer

job_id

El ID del trabajo asociado con la tarea de scraping.

string

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

Pricing

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": "New",
          "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

Una matriz 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 o la compra, como políticas de entrega y devoluciones.

string

online.currency

El código de moneda del precio del producto.

string

online.condition

La condición del producto.

string

online.price_tax

El monto de impuestos aplicado al precio del producto.

float

online.price_total (opcional)

El precio total del producto, incluyendo impuestos.

float

online.seller_link

La URL a 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 EE. UU.

...       
       "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 la jaula del disco duro tuvo que ser retirada para caber en la carcasa 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 drama, pero tienes que usar Google para encontrar el controlador en el sitio de Nvidia. Estoy usando esta GPU para animación 3D en Blender. Estoy muy satisfecho con la velocidad del renderizado con trazado de rayos en EEVEE y Cycles. Como esta es una computadora antigua, la CPU nunca funciona al 100%, y aún no he podido exprimir al máximo la capacidad de esta tarjeta. No oigo los ventiladores, pero nunca le he puesto una carga tan alta, supongo. Tiene un pequeño zumbido electrónico cuando está renderizando.\u00a0Menos",
        "author": "walmart.com Shopper",
        "rating": 5,
        "source": "Reviewed on 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 calificación promedio del producto, típicamente de 0 a 5.

float

top_review

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

object

top_review.text (opcional)

El contenido de texto de la mejor reseña

string

top_review.title (opcional)

El título de la mejor reseña.

string

top_review.author

El autor de la mejor reseña.

string

top_review.rating

La calificación dada por el autor de la mejor reseña, típicamente de 0 a 5.

float

top_review.source

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

string

rating_stars

La calificación promedio del producto, típicamente de 0 a 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 calificació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

Una matriz 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

Una matriz 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 para la sección de especificaciones.

string

AnteriorShopping Search SiguienteShopping Pricing

Última actualización hace 1 mes

¿Te fue útil?

Buenas noches

Shopping Product

Solicitar ejemplos

Valores de parámetros de la solicitud

Genérico

Localización

Datos estructurados

Diccionario de datos de salida

Estructura JSON

Pricing

Reseñas

Artículos relacionados (Más opciones)

Especificaciones