Produto de Compras

Recupere dados detalhados de produtos do Google Shopping, incluindo preços, reviews, especificações e variantes usando a Web Scraper API.

O google_shopping_product source recupera informações detalhadas do produto (título, descrição, preços, vendedores, itens relacionados, avaliações etc.) do Google Shopping usando um token do produto obtido de google_shopping_search source.

Exemplos de solicitação

No exemplo de código abaixo, fazemos uma solicitação para recuperar a página do produto de um produto do Google Shopping usando um 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


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

# Obtenha a resposta.
response = requests.request(
    'POST',
    'https://realtime.oxylabs.io/v1/queries',
    auth=('USERNAME', 'PASSWORD'),
    json=payload,
)

# Imprima a resposta formatada em 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: O query o parâmetro deve conter um token válido gerado por meio do google_shopping_search source.

Usamos o método de integração Realtime síncrona em nossos exemplos. Se você quiser usar Proxy Endpoint ou a integração assíncrona Push-Pull , consulte a seção métodos de integração .

Valores dos parâmetros da solicitação

Genérico

Opções básicas de configuração e personalização para raspar páginas de produtos do Google Shopping.

Parâmetro

Descrição

Valor padrão

source

Define o scraper.

google_shopping_product

query

O token do produto de google_shopping_search

render

Habilita a renderização de JavaScript quando definido como html. Obrigatório para receber resultados adicionais de preços da seção "Mais lojas". Mais informações.

parse

Retorna dados analisados quando definido como true. Explore a saída dicionário de dados.

false

callback_url

URL para seu endpoint de callback. Mais informações

user_agent_type

Tipo de dispositivo e navegador. A lista completa pode ser encontrada aqui.

desktop

- parâmetro obrigatório

Localização

Adapte os resultados a locais geográficos, domínios e idiomas específicos.

Parâmetro

Descrição

Valor padrão

geo_location

A localização geográfica para a qual o resultado deve ser adaptado. Usar este parâmetro corretamente é extremamente importante para obter os dados certos. Para mais informações, leia sobre nossas geo_location estruturas de parâmetros aqui.

locale

valor do cabeçalho valor do cabeçalho para mudanças no idioma da interface. Mais informações.

Observação: certifique-se de que seus parâmetros de localização para google_shopping_product e google_shopping_search as sources sejam os mesmos (nenhum, se não definido). O desalinhamento regional entre as sources pode resultar em dados incompletos ou imprecisos.

Dados estruturados

Abaixo você pode encontrar um exemplo de saída estruturada para google_shopping_product.

19KB

google_shopping_product-output.json

Abrir

Dicionário de dados de saída

Exemplo em HTML

Estrutura JSON

A tabela abaixo apresenta uma lista detalhada de cada elemento da página do produto que analisamos, juntamente com sua descrição e tipo de dado. A tabela também inclui alguns metadados.

Chave

Descrição

Tipo

url

A URL da página do produto do Google Shopping.

string

title (opcional)

O título do anúncio do produto.

string

description

Uma descrição detalhada do produto.

string

images

Um objeto que contém imagens do produto.

object

images.full_size

Uma matriz de URLs para imagens em tamanho grande do produto.

array

images.thumbnails

Uma matriz de URLs para imagens em miniatura do produto.

array

pricing

Uma matriz contendo todas as informações de preços online.

array

reviews

Um objeto que contém informações de avaliações. (somente EUA)

object

variants

Uma matriz de objetos contendo variantes do produto. (cores, tamanhos etc.)

array

related_items

Uma matriz de objetos contendo itens relacionados.

array

specifications

Uma matriz de objetos contendo especificações do produto.

array

parse_status_code

O código de status do trabalho de análise. Você pode ver os códigos de status do parser descritos aqui.

integer

created_at

O timestamp em que o trabalho de scraping foi criado.

timestamp

updated_at

O timestamp em que o trabalho de scraping foi concluído.

timestamp

status_code

O código de status do trabalho de scraping. Você pode ver os códigos de status do scraper descritos aqui.

integer

job_id

O ID do trabalho associado ao trabalho de scraping.

string

Nas seções a seguir, os trechos de código JSON analisados são abreviados quando há mais de um item disponível para o tipo de resultado.

Pricing

Um objeto que contém informações de preços do produto.

...
   "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": "Novo",
          "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
        },
...
    ]
},
...

Chave (pricing[])

Descrição

Tipo

online

Uma matriz de objetos contendo detalhes de preços do produto.

array

online.price

O preço do produto na moeda especificada.

float

online.seller

O nome do vendedor ou comerciante que oferece o produto.

string

online.details

Detalhes adicionais sobre a compra do produto, como políticas de entrega e devolução.

string

online.currency

O código da moeda do preço do produto.

string

online.condition

A condição do produto.

string

online.price_tax

O valor do imposto aplicado ao preço do produto.

float

online.price_total (opcional)

O preço total do produto, incluindo impostos.

float

online.seller_link

A URL da página do vendedor para o produto.

string

online.price_shipping

O custo de frete do produto.

float

Avaliações

Um objeto que contém informações de avaliações e classificações do produto.

No momento, as avaliações estão disponíveis apenas no locale dos EUA.

...       
       "reviews": {
    "rating": 4.7,
    "top_review": {
        "text": "Meu computador é um Dell Optiplex 9020, i7-4770, 32mb, SSD de 500gb. A placa de 3 fans é comprida, e a gaiola do disco rígido teve que ser removida para caber no gabinete do Optiplex. A fonte de alimentação foi atualizada para 750 watts, o que exigiu um adaptador para a placa-mãe Dell. Com essas modificações resolvidas, a instalação da placa foi tranquila, mas você precisa usar o Google para encontrar o driver no site da Nvidia. Estou usando esta GPU para animação 3D no Blender. Estou muito satisfeito com a velocidade da renderização com ray tracing no EEVEE e no Cycles. Como este é um computador antigo, o CPU do computador nunca chega a 100%, e ainda não consegui usar toda a capacidade desta placa. Não ouço os fans funcionando, mas também nunca a coloquei sob carga alta o suficiente, eu acho. Ela faz um leve zumbido eletrônico quando está renderizando.\u00a0Menos",
        "author": "comprador do walmart.com",
        "rating": 5,
        "source": "Avaliado em 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
        }
    },
},
...

Chave(reviews[])

Descrição

Tipo

rating

A classificação média do produto, normalmente de 5.

float

top_review (opcional)

Um objeto que contém os detalhes da principal avaliação do produto.

object

top_review.text (opcional)

O conteúdo textual da principal avaliação

string

top_review.title (opcional)

O título da principal avaliação.

string

top_review.author (opcional)

O autor da principal avaliação.

string

top_review.rating (opcional)

A classificação dada pelo autor da principal avaliação, normalmente de 5.

float

top_review.source (opcional)

A fonte ou site onde a principal avaliação foi publicada.

string

rating_stars

A classificação média do produto, normalmente de 5 estrelas.

float

reviews_count (opcional)

O número total de avaliações do produto.

integer

reviews_by_stars

Um objeto que contém a contagem de avaliações para cada classificação por estrelas.

object

reviews_by_stars.url (opcional)

Um objeto que contém detalhes de avaliações de X estrelas.

string

reviews_by_stars.reviews_count

A contagem de avaliações de X estrelas.

integer

Itens relacionados (Mais opções)

Uma matriz de objetos contendo itens relacionados ao produto-alvo.

...             
   "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": "Placa de vídeo NVIDIA GeForce RTX 5070 12GB GDDR7",
            "currency": "USD",
            "reviews_count": 228
          },
...
        ],
        "title": "Mais opções"
     }
],
...

Chave(related_items[])

Descrição

Tipo

itens

Uma matriz de objetos contendo detalhes de cada item relacionado.

array

items.url

A URL da página do produto relacionado.

string

items.image

A URL da imagem do produto relacionado.

string

items.price

O preço do produto relacionado na moeda especificada.

float

items.title (opcional)

O título do anúncio do produto relacionado.

string

items.rating (opcional)

A avaliação média dos usuários do produto relacionado, normalmente de 5.

integer

items.store (opcional)

O nome da loja ou comerciante que oferece o produto relacionado.

string

items.currency

O código da moeda do preço do produto.

string

items.reviews_count

O número total de avaliações do produto relacionado.

integer

title

O título ou cabeçalho da seção de itens relacionados

string

Especificações

Uma matriz de objetos contendo detalhes das especificações do produto.

...
"specifications": [
    {
        "items": [
          {
            "title": "Fabricante",
            "value": "PNY"
          },
          {
            "title": "Saída",
            "value": "HDMI, DisplayPort"
          },
          {
            "title": "Interface",
            "value": "PCI Express"
          },
          {
            "title": "Marca",
            "value": "PNY"
          },
...
        ],
        "section_title": "attributes"
      }
],
...

Chave (specifications[])

Descrição

Tipo

itens

Uma matriz de objetos contendo detalhes individuais das especificações.

array

items.title

O título da especificação.

string

items.value

O valor da especificação.

string

section_title

O título ou cabeçalho da seção de especificações.

string

AnteriorPesquisa de Compras PróximoPreços de Compras

Atualizado há 24 dias

Isto foi útil?