Produto

Extraia páginas de produto do Walmart por ID do produto com dados analisados, incluindo preços, avaliações, info do vendedor, especificações, variações, opções de fulfillment, breadcrumbs e mais.

O walmart_product a fonte foi projetada para recuperar páginas de resultados de produtos da Walmart. Podemos retornar o HTML de qualquer página da Walmart que você quiser. Além disso, podemos entregar saída estruturada (parseada) para páginas de produtos da Walmart.

Exemplos de solicitação

O exemplo abaixo ilustra como você pode obter um resultado parseado de uma página de produto da Walmart.

curl 'https://realtime.oxylabs.io/v1/queries' \
--user 'USERNAME:PASSWORD' \
-H 'Content-Type: application/json' \
-d '{
        "source": "walmart_product", 
        "product_id": "15296401808",
        "parse": true
    }'

import requests
from pprint import pprint


# Estruture o payload.
payload = {
    'source': 'walmart_product',
    'product_id': '15296401808',
    'parse': True,
}

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

# Instead of response with job status and results url, this will return the
# JSON response with the result.
pprint(response.json())

const https = require("https");

const username = "USERNAME";
const password = "PASSWORD";
const body = {
    source: "walmart_product",
    product_id: "15296401808",
    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();

# The whole string you submit has to be URL-encoded.

https://Realtime.oxylabs.io/v1/queries?source=walmart_product&product_id=15296401808&parse=true&access_token=12345abcde

<?php

$params = array(
    'source' => 'walmart_product',
    'product_id' => '15296401808',
    '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":       "walmart_product",
		"product_id":   "15296401808",
		"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 = "walmart_product",
                product_id = "15296401808",
                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", "walmart_product");
        jsonObject.put("product_id", "15296401808");
        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();
    }
}

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

Parâmetro

Descrição

Valor padrão

source

Define o scraper.

walmart_product

product_id

ID do produto da Walmart.

render

Habilita a renderização de JavaScript quando definido como html. Mais informações.

parse

Retorna dados analisados quando definido como true.

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 para lojas específicas, locais de envio. Encontre a lista de IDs de lojas da Walmart aqui:

294KB

www_walmart_com_stores.csv

Abrir

Você também pode encontrar a página oficial das lojas Walmart aqui.

Parâmetro

Descrição

Tipo

domain

Localização do domínio para o Walmart. Valores disponíveis: com, com.mx, ca, co.cr. Padrão: com.

String

tipo_de_atendimento

Defina o tipo de atendimento. Os valores suportados são: retirada, entrega, shipping.

String

cep_de_entrega

Defina o local de entrega.

String

id_da_loja

Defina o local da loja.

String

A disponibilidade do parâmetro de tipo de atendimento varia de acordo com o domínio do Walmart:

Domínio

Tipos de atendimento suportados

walmart.com

retirada, entrega, shipping

walmart.com.mx

retirada, entrega

walmart.ca

retirada, entrega

walmart.co.cr

retirada

Para listas internacionais, id_da_loja consulte os arquivos abaixo:

38KB

www_walmart_com_mx_stores.csv

Abrir

24KB

www_walmart_ca_stores.csv

Abrir

126B

walmart_co_cr_stores.json

Abrir

Se a loja alvo estiver muito longe do CEP informado, tentaremos usar o CEP da loja alvo; caso contrário, a localização não será definida corretamente. Caso não consigamos definir o cep_de_entrega - O Walmart retornará os resultados padrão sem segmentação por loja.

Dados estruturados

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.

Saída estruturada da página de produto da Walmart

{
    "results": [
        {
            "content": {
                "price": {
                    "price": 157.97,
                    "currency": "USD",
                    "price_strikethrough": 199.99
                },
                "rating": {
                    "count": 94,
                    "rating": 4.5
                },
                "seller": {
                    "id": "ED6F630F4BA94318A00A1D0BAACD0A48",
                    "url": "/seller/7648?itemId=701606028&pageName=item&returnUrl=%2Fip%2FApple-iPhone-Xs-64GB-Unlocked-GSM-CDMA-4G-LTE-Phone-w-Dual-12MP-Camera-Gold-Fair-Cosmetics-Fully-Functional%2F701606028",
                    "name": "Kiss Electronics Inc",
                    "catalog_id": "7648",
                    "official_name": "Kiss Electronics Inc"
                },
                "general": {
                    "url": "https://www.walmart.com/ip/Apple-iPhone-Xs-64GB-Unlocked-GSM-CDMA-4G-LTE-Phone-w-Dual-12MP-Camera-Gold-Fair-Cosmetics-Fully-Functional/701606028",
                    "meta": {
                        "sku": "701606028",
                        "gtin": "683346585136"
                    },
                    "badge": "Mais vendido",
                    "brand": "Apple",
                    "title": "Apple iPhone XS seminovo - desbloqueado para operadora - 64GB dourado",
                    "images": [
                        "https://i5.walmartimages.com/seo/Apple-iPhone-Xs-64GB-Unlocked-GSM-CDMA-4G-LTE-Phone-w-Dual-12MP-Camera-Gold-Fair-Cosmetics-Fully-Functional_d6dacc88-10c1-46e0-b528-c626915adadc.4c6907ee5896ccbc68382cb59470a6d8.jpeg?odnHeight=117&odnWidth=117&odnBg=FFFFFF"
                    ],
                    "main_image": "https://i5.walmartimages.com/seo/Apple-iPhone-Xs-64GB-Unlocked-GSM-CDMA-4G-LTE-Phone-w-Dual-12MP-Camera-Gold-Fair-Cosmetics-Fully-Functional_d6dacc88-10c1-46e0-b528-c626915adadc.4c6907ee5896ccbc68382cb59470a6d8.jpeg?odnHeight=640&odnWidth=640&odnBg=FFFFFF",
                    "description": "<p>Super Retina. Em grande e maior ainda. Um design de tela inteira oferece uma grande e bonita tela para tudo o que você adora fazer. OLED feito sob medida. Os painéis OLED no iPhone Xs permitem uma tela HDR com a melhor precisão de cores do setor, pretos verdadeiros e brilho e contraste notáveis. São as telas mais nítidas, com a maior densidade de pixels, em qualquer dispositivo Apple. Um novo nível de resistência à água. O vidro mais durável em um smartphone, selado e ajustado com precisão com uma faixa de aço inoxidável de grau cirúrgico, ajuda a criar um corpo mais resistente à água - até 2 metros por 30 minutos. O iPhone Xs até resiste a respingos de café, chá, refrigerante e mais. Um nível totalmente novo de inteligência. O A12 Bionic, com nosso Neural Engine de próxima geração, oferece desempenho incrível. Ele usa aprendizado de máquina em tempo real para transformar a forma como você vivencia fotos, jogos, realidade aumentada e mais. Sensores, processadores, algoritmos e você. Um inovador sistema de câmera dupla integra o ISP, o Neural Engine e algoritmos avançados para abrir novas possibilidades criativas e ajudar você a capturar fotos incríveis. Uma imagem vale um trilhão de operações. O sistema de câmera dupla do iPhone Xs aproveita o poder sem precedentes do Neural Engine e sua capacidade de realizar cinco trilhões de operações por segundo. Junto com o ISP projetado pela Apple, ele funciona como o assistente fotográfico mais rápido do mundo para ajudar suas fotos a se destacarem. Segurança simplificada. O Face ID reinventa a forma como desbloqueamos, fazemos login e pagamos. Algumas de nossas tecnologias mais sofisticadas - o sistema de câmera True Depth, o Secure Enclave e o Neural Engine - fazem dele a autenticação facial mais segura já vista em um smartphone. E ainda mais rápido e fácil de usar.</p><ul>   <li>O telefone foi testado, está funcionando e operacional. Pode ter marcas de uso, arranhões, rachaduras ou outros pequenos problemas que não afetam a funcionalidade do telefone.</li>   <li>Tela sensível ao toque Super AMOLED de 5,8 polegadas, 1125 x 2436 pixels</li>   <li>iOS, Apple A12 Bionic, Hexa-Core, GPU da Apple (gráficos de 4 núcleos)</li>   <li>Câmeras duplas de 12MP (f/1.8, 28mm, OIS) e 12MP (f/2.4, 52mm, zoom óptico 2x) com flash quad-LED de dois tons e câmera frontal de 7MP com f/2.2, 32mm</li>   <li>Memória interna: 64GB, 4GB RAM</li>   <li>Resistente a poeira/água IP68 (até 2m por 30 min), vidro resistente a arranhões, revestimento oleofóbico</li>   <li>Dimensões: 5,65 x 2,79 x 0,30 polegadas, peso: 6,24 oz</li>  </ul>"
                },
                "location": {
                    "city": "Sacramento",
                    "state": "CA",
                    "store_id": "3081",
                    "zip_code": "95829"
                },
                 "variations": [
                    {
                        "state": "EM_ESTOQUE",
                        "product_id": "7328JAQF0Y2S",
                        "selected_options": [
                            {
                                "key": "Operadora",
                                "value": "Verizon"
                            },
                            {
                                "key": "Capacidade",
                                "value": "256GB"
                            },
                            {
                                "key": "Cor",
                                "value": "Titânio Deserto"
                            }
                        ]
                    },
                "breadcrumbs": [
                    {
                        "url": "/cp/cell-phones/1105910",
                        "category_name": "Celulares"
                    },
                    {
                        "url": "/cp/unlocked-phones/1073085",
                        "category_name": "Celulares desbloqueados"
                    },
                    {
                        "url": "/cp/gsm-unlocked/8230659",
                        "category_name": "GSM desbloqueados"
                    }
                ],
                "fulfillment": {
                    "pickup": false,
                    "delivery": false,
                    "shipping": true,
                    "out_of_stock": false,
                    "free_shipping": true,
                    "pickup_information": "Retirada, não disponível",
                    "delivery_information": "Entrega, não disponível",
                    "shipping_information": "Envio, chega em 18 de out., grátis"
                },
                "specifications": [
                    {
                        "key": "Marca do processador",
                        "value": "Apple"
                    },
                    {
                        "key": "Tecnologia de exibição",
                        "value": "Retina Display"
                    },
                    {
                        "key": "Recurso do telefone",
                        "value": "Carregamento sem fio"
                    },
                    ...
                ],
                "parse_status_code": 12000
            },
            "created_at": "2024-09-16 08:09:03",
            "updated_at": "2024-09-16 08:09:06",
            "page": 1,
            "url": "https://www.walmart.com//ip/Apple-iPhone-Xs-64GB-Unlocked-GSM-CDMA-4G-LTE-Phone-w-Dual-12MP-Camera-Gold-Fair-Cosmetics-Fully-Functional/701606028",
            "job_id": "7253339040034008521",
            "is_render_forced": false,
            "status_code": 200,
            "parser_type": "walmart_product_new"
        }
    ]
}

Dicionário de dados de saída

Exemplo de 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

geral

Um objeto com detalhes gerais do resultado da página do produto.

object

preço

O objeto contém detalhes sobre o preço do produto.

object

rating

Informações de avaliação do produto.

object

seller

Informações sobre o vendedor.

object

variations (opcional)

Lista de variações do produto.

array

breadcrumbs

Hierarquia de categorias que leva ao produto.

object

location

Fornece informações sobre a localização em que a solicitação foi executada.

object

fulfillment

O objeto contém informações sobre as opções de atendimento do produto.

object

specifications

Array de pares chave-valor detalhando atributos ou recursos específicos 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

page

Número da página de onde os dados do produto foram extraídos

integer

url

URL da página do produto no site da Walmart

string

job_id

O ID do trabalho associado ao trabalho de scraping.

string

status_code

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

integer

is_render_forced

Identifica se a renderização foi forçada para esta solicitação.

booleano

parser_type

Tipo de parser usado para extrair os dados (por exemplo, "walmart_product_new").

string

Geral

Chave (general)

Descrição

Tipo

url

A URL do produto.

string

main_image

A URL da imagem principal do produto

integer

images

Array de URLs das imagens do produto.

array

title

Título ou nome do produto.

string

description

Descrição detalhada do produto.

string

brand

A marca do produto.

string

badge

Indicador de atributos específicos, como promoções, recursos do produto, certificações ou afiliações de marca.

lista de strings

meta

Metadados do produto.

object

meta.sku

Stock Keeping Unit (SKU) do produto.

string

meta.gtin

Número Global de Item Comercial (GTIN) do produto.

string

Preço

...
"price": {
    "price": 12.49,
    "price_strikethrough": 23.72,
    "currency": "USD"
},
...

Chave (price)

Descrição

Tipo

preço

O preço atual do produto sem quaisquer descontos.

float

price_strikethrough

O preço riscado é um preço anterior, um preço de pacote ou um preço de lista.

float

currency

O código de moeda de três letras ISO 4217 para o preço do produto.

string

Avaliação

...
 "rating": {
    "count": 64,
    "rating": 4.7
},
...

Chave (rating)

Descrição

Tipo

rating

Avaliação média do produto.

float

count

Número de avaliações do produto.

integer

Vendedor

...
"seller": {
    "id": "ED6F630F4BA94318A00A1D0BAACD0A48",
    "url": "/seller/7648?itemId=701606028&pageName=item&returnUrl=%2Fip%2FApple-iPhone-Xs-64GB-Unlocked-GSM-CDMA-4G-LTE-Phone-w-Dual-12MP-Camera-Gold-Fair-Cosmetics-Fully-Functional%2F701606028",
    "name": "Kiss Electronics Inc",
    "catalog_id": "7648",
    "official_name": "Kiss Electronics Inc"
},
...

Chave (seller)

Descrição

Tipo

name

Nome do vendedor.

string

official_name

Nome oficial registrado da entidade vendedora.

string

id

Identificador único atribuído ao vendedor pela plataforma.

string

url

A URL que leva ao site oficial ou à loja do vendedor.

string

catalog_id

ID do catálogo.

string

Especificações

...
"specifications": [
    ...
    {
        "key": "Marca",
        "value": "LEGO"
    },
    {
        "key": "Faixa etária",
        "value": "9 anos ou mais"
    },
]
...

Chave (especificações)

Descrição

Tipo

key

Atributo ou característica específica do produto.

string

). Mais informações

Valor correspondente ou descrição do atributo especificado pela chave de especificações.

string

Atendimento

...
"fulfillment": {
                    "pickup": false,
                    "delivery": false,
                    "shipping": true,
                    "out_of_stock": false,
                    "free_shipping": true,
                    "pickup_information": "Retirada, não disponível",
                    "delivery_information": "Entrega, não disponível",
                    "shipping_information": "Envio, chega em 24 de out., grátis"
                },
...

Chave (fulfillment)

Descrição

Tipo

retirada

Indica se o produto está disponível para retirada na loja.

booleano

pickup_information

A mensagem de retirada, quando pickup = true.

string

entrega

Indica se o produto está disponível para ser atendido via entrega da loja local.

booleano

delivery_information

A mensagem de entrega da loja local, quando delivery = true.

string

shipping

Indica se o produto está disponível para envio ao domicílio.

booleano

shipping_information

A mensagem de envio, se exibida.

string

free_shipping

Indica se o frete é gratuito.

booleano

out_of_stock

Indica se o produto está atualmente sem estoque.

booleano

Variações

...
"variations": [
    {
        "state": "EM_ESTOQUE",
        "product_id": "7328JAQF0Y2S",
        "selected_options": [
            {
                "key": "Cor",
                "value": "Preto"
            },
]
...

Chave (variações)

Descrição

Tipo

state

Estado de disponibilidade da variação do produto.

string

product_id

Identificador único para cada variação do produto.

string

selected_options

Array contendo as opções selecionadas que definem a variação.

array

selected_options.key

Chave que descreve a opção selecionada.

string

selected_options.value

Valor da opção selecionada.

string

Breadcrumbs

... 
"breadcrumbs": [
    {
        "url": "/cp/cell-phones/1105910",
        "category_name": "Celulares"
    },
    {
        "url": "/cp/phones-with-plans/1073085",
        "category_name": "Celulares com planos"
    },
    {
        "url": "/cp/postpaid-phones/8230659",
        "category_name": "Celulares pós-pagos"
    }
    ...
],
...

Chave (breadcrumbs)

Descrição

Tipo

category_name

O nome da categoria.

string

url

A URL da categoria

string

Localização

...
"location": {
    "city": "Sacramento",
    "state": "CA",
    "store_id": "8915",
    "zip_code": "95829"
},
...

Chave (location)

Descrição

Tipo

city

A cidade em que a solicitação foi executada.

string

state

O estado em que a solicitação foi executada.

string

zip_code

O CEP em que a solicitação foi executada.

string

id_da_loja

O ID da loja em que a solicitação foi executada.

string

AnteriorPesquisa PróximoURL

Atualizado há 1 mês

Isto foi útil?