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 la fuente 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.

Muestras de solicitud

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


# Structure payload.
payload = {
    "source": "google_shopping_product",
    "query": "[product_token_string]",
    "render": "html",
    "parse": True
}

# Get response.
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_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 Realtime método de integración en nuestros ejemplos. Si desea usar Proxy Endpoint o asincrónico Push-Pull integración, consulte el 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 raspar 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

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 analizados cuando se establece en true. Explorar el 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 específicas, dominios e idiomas.

Parámetro

Descripción

Valor predeterminado

geo_location

La ubicación geográfica para la cual 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í.

locale

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á definido). El desajuste regional entre las fuentes puede resultar en datos incompletos o inexactos.

"key": "filter",

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

Muestra 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 (opcional)

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 de imágenes de tamaño completo del producto.

array

images.thumbnails

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

array

pricing

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

array

reviews

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 análisis. 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 se finalizó el trabajo de scraping.

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 el trabajo de scraping.

string

En las secciones siguientes, 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": "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 para el 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, incluido el impuesto.

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.

En este 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 retirarse 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 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 trazado de rayos en EEVEE y Cycles. Como es una computadora antigua, la CPU nunca funciona al 100%, y aún no he podido exprimir la capacidad de esta tarjeta. No oigo los ventiladores funcionando pero supongo que nunca le he puesto una carga lo suficientemente alta todavía. Tiene un pequeño zumbido electrónico cuando renderiza.\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 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 calificación dada por el autor de la reseña principal, típicamente sobre 5.

float

top_review.source (opcional)

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

string

rating_stars

La calificación promedio del producto, típicamente 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 por cada calificación de 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 las especificaciones del producto.

...
"specifications": [
    {
        "results": {
          {
            "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

elementos

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 día

¿Te fue útil?

Buenas noches

Shopping Product

Muestras de solicitud

Valores de parámetros de la solicitud

Genérico

Localización

"key": "filter",

Diccionario de datos de salida

Estructura JSON

Precios

Reseñas

Artículos relacionados (Más opciones)

Especificaciones

Buenas noches

hashtagMuestras de solicitud

hashtagValores de parámetros de la solicitud

hashtagGenérico

hashtagLocalización

hashtag"key": "filter",

hashtagDiccionario de datos de salida

hashtagEstructura JSON

hashtagPrecios

hashtagReseñas

hashtagArtículos relacionados (Más opciones)

hashtagEspecificaciones

Muestras de solicitud

Valores de parámetros de la solicitud

Genérico

Localización

"key": "filter",

Diccionario de datos de salida

Estructura JSON

Precios

Reseñas

Artículos relacionados (Más opciones)

Especificaciones