Produto

Extraia páginas de produto do Walmart pelo ID do produto com dados parseados, incluindo preços, avaliações, informações do vendedor, especificações, variações, opções de atendimento, breadcrumbs e muito mais.

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

Exemplos de requisição

O exemplo abaixo ilustra como você pode obter um resultado parseado da página de produto do 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


# Structure payload.
payload = {
    'source': 'walmart_product',
    'product_id': '15296401808',
    "'parse': True,"
}

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

# Em vez de uma resposta com o status do job e a URL dos resultados, isto retornará a
# resposta JSON com o resultado.
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();

# Toda a string que você enviar precisa estar codificada em URL.

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

{
    "source": "walmart_product", 
    "product_id": "15296401808", 
    "parse": true
}

Usamos o método de integração síncrona Realtime método de integração em nossos exemplos. Se você quiser usar Proxy Endpoint ou assíncrono Push-Pull de integração, consulte a métodos de integração seçã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 do Walmart.

render

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

parse

Retorna os dados analisados quando definido como verdadeiro.

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 e locais de envio específicos. Encontre a lista de IDs das lojas do Walmart aqui:

www_walmart_com_stores.csv

294KB

Abrir

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

Parâmetro

Descrição

Tipo

domain

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

Cadeia de caracteres

fulfillment_type

Defina o tipo de fulfillment. Valores suportados: pickup, delivery, shipping.

Cadeia de caracteres

delivery_zip

Defina o local de envio.

Cadeia de caracteres

store_id

Defina a localização da loja.

Cadeia de caracteres

A disponibilidade do parâmetro de tipo de fulfillment varia conforme o domínio do Walmart:

Domínio

Tipos de fulfillment suportados

walmart.com

pickup, delivery, shipping

walmart.com.mx

pickup, delivery

walmart.ca

pickup, delivery

walmart.co.cr

pickup

Para uso internacional store_id listas, consulte os arquivos abaixo:

www_walmart_com_mx_stores.csv

38KB

Abrir

www_walmart_ca_stores.csv

24KB

Abrir

walmart_co_cr_stores.json

126B

Abrir

Se a loja de destino estiver muito longe do CEP fornecido - tentaremos usar o CEP da loja de destino; caso contrário, a localização não será definida corretamente. No caso de não conseguirmos definir o delivery_zip - A Walmart retornará seus resultados padrão sem direcionamento por loja.

Dados estruturados

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

Saída estruturada da página de produto do 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": "Best seller",
                    "brand": "Apple",
                    "title": "Pre-Owned Apple iPhone XS - Carrier Unlocked - 64GB Gold",
                    "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. In Big and Bigger. An all-screen design gives you a large, beautiful canvas for everything you love to do. Custom-built OLED. The OLED panels in iPhone Xs allow for an HDR display with the industry's best color accuracy, true blacks, and remarkable brightness and contrast. They're the sharpest displays, with the highest pixel density, on any Apple device. A new level of water resistance. The most durable glass in a smartphone, sealed and precision-fitted with surgical-grade stainless steel band, helps create a more water-resistant enclosure - up to 2 meters for 30 minutes. iPhone Xs even resists spills from Coffee, Tea, Soda, and more. A whole new level of intelligence. The A12 Bionic, with our next-generation Neural Engine, delivers incredible performance. It uses real-time machine learning to transform the way you experience photos, gaming, augmented reality, and more. Sensors, processors, algorithms, and you. An innovative dual-camera system integrates the ISP, the Neural Engine, and advanced algorithms to unlock new creative possibilities and help you capture incredible photos. A picture is worth a trillion operations. The iPhone Xs dual-camera system harnesses the unprecedented power of the Neural Engine and its ability to perform five trillion operations per second. Together with the Apple-designed ISP, it works like the world's fastest photographer's assistant to help turn your pictures into showstoppers. Security made simple. Face ID reinvent the way we unlock, log in, and pay. Some of our most sophisticated technologies - the True Depth camera system, the Secure Enclave, and the Neural Engine - make it the most secure facial authentication ever in a smartphone. And even faster and easier to use.</p><ul>   <li>Phone is tested, working and functional. May have scruff, scratched, cracks or other minor issues that don't affect the functionality of phone.</li>   <li>5.8-inch Super AMOLED Capacitive Touchscreen, 1125 x 2436 pixels</li>   <li>iOS, Apple A12 Bionic, Hexa-Core, Apple GPU (4-Core Graphics)</li>   <li>Dual 12MP(f/1.8, 28mm, OIS) &amp; 12MP(f/2.4, 52mm, 2x optical Zoom) Cameras with Quad-LED Dual-Tone Flash &amp; 7MP Front Camera with f/2.2, 32mm</li>   <li>Internal Memory: 64GB, 4GB RAM</li>   <li>IP68 Dust/Water Resistant (Up to 2m for 30 mins), Scratch-Resistant Glass, Oleophobic Coating</li>   <li>Dimensions: 5.65 x 2.79 x 0.30 inches, Weight: 6.24 oz</li>  </ul>"
                },
                "location": {
                    "city": "Sacramento",
                    "state": "CA",
                    "store_id": "3081",
                    "zip_code": "95829"
                },
                 "variations": [
                    {
                        "state": "IN_STOCK",
                        "product_id": "7328JAQF0Y2S",
                        "selected_options": [
                            {
                                "key": "Carrier",
                                "value": "Verizon"
                            },
                            {
                                "key": "Capacity",
                                "value": "256GB"
                            },
                            {
                                "key": "Color",
                                "value": "Desert Titanium"
                            }
                        ]
                    },
                "breadcrumbs": [
                    {
                        "url": "/cp/cell-phones/1105910",
                        "category_name": "Cell Phones"
                    },
                    {
                        "url": "/cp/unlocked-phones/1073085",
                        "category_name": "Unlocked Phones"
                    },
                    {
                        "url": "/cp/gsm-unlocked/8230659",
                        "category_name": "GSM Unlocked"
                    }
                ],
                "fulfillment": {
                    "pickup": false,
                    "delivery": false,
                    "shipping": true,
                    "out_of_stock": false,
                    "free_shipping": true,
                    "pickup_information": "Pickup, Not available",
                    "delivery_information": "Delivery, Not available",
                    "shipping_information": "Shipping, Arrives Oct 18, Free"
                },
                "specifications": [
                    {
                        "key": "Processor Brand",
                        "value": "Apple"
                    },
                    {
                        "key": "Display Technology",
                        "value": "Retina Display"
                    },
                    {
                        "key": "Phone Feature",
                        "value": "Wireless Charging"
                    },
                    ...
                ],
                "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 em HTML

Estrutura JSON

A tabela abaixo apresenta uma lista detalhada de cada elemento da página de produto que analisamos, junto 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.

objeto

price

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

objeto

rating

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

objeto

seller

Informações sobre o vendedor.

objeto

variações (opcional)

Lista de variações do produto.

array

breadcrumbs

Hierarquia de categorias que leva ao produto.

objeto

location

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

objeto

Fulfillment

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

objeto

especificações

Vetor de pares chave-valor que detalha atributos ou recursos específicos do produto.

array

parse_status_code

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

integer

criado_em

O timestamp em que o trabalho de scraping foi criado.

carimbo_de_data_hora

atualizado_em

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

carimbo_de_data_hora

page

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

integer

url

URL da página do produto no site do Walmart

string

id_do_trabalho

O ID do trabalho associado ao trabalho de scraping.

string

código_de_status

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 (geral)

Descrição

Tipo

url

A URL do produto.

string

main_image

A URL da imagem principal do produto

integer

images

Vetor 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 à marca.

lista de strings

meta

Metadados do produto.

objeto

meta.sku

Unidade de manutenção de estoque (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 (preço)

Descrição

Tipo

price

O preço atual do produto sem nenhum desconto.

ponto flutuante

price_strikethrough

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

ponto flutuante

moeda

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 (avaliação)

Descrição

Tipo

rating

Avaliação média do produto.

ponto flutuante

contagem

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 (vendedor)

Descrição

Tipo

nome

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 à vitrine do vendedor.

string

catalog_id

ID do catálogo.

string

Especificações

...
"specifications": [
    ...
    {
        "key": "Brand",
        "value": "LEGO"
    },
    {
        "key": "Age Range",
        "value": "9 Years & Up"
    },
]
...

Chave (especificações)

Descrição

Tipo

key

Atributo ou característica específica do produto.

string

valor

Valor correspondente ou descrição do atributo especificado pela chave specifications.

string

Fulfillment

...
"fulfillment": {
                    "pickup": false,
                    "delivery": false,
                    "shipping": true,
                    "out_of_stock": false,
                    "free_shipping": true,
                    "pickup_information": "Pickup, Not available",
                    "delivery_information": "Delivery, Not available",
                    "shipping_information": "Shipping, Arrives Oct 24, Free"
                },
...

Chave (fulfillment)

Descrição

Tipo

pickup

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

booleano

pickup_information

A mensagem de retirada, quando pickup = true.

string

delivery

Indica se o produto está disponível para 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 para casa.

booleano

shipping_information

A mensagem de envio, se exibida.

string

free_shipping

Indica se o envio é gratuito.

booleano

out_of_stock

Indica se o produto está atualmente fora de estoque.

booleano

Variações

...
"variations": [
    {
        "state": "IN_STOCK",
        "product_id": "7328JAQF0Y2S",
        "selected_options": [
            {
                "key": "Color",
                "value": "Black"
            },
]
...

Chave (variações)

Descrição

Tipo

estado

Estado de disponibilidade da variação do produto.

string

product_id

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

string

selected_options

Vetor 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": "Cell Phones"
    },
    {
        "url": "/cp/phones-with-plans/1073085",
        "category_name": "Phones With Plans"
    },
    {
        "url": "/cp/postpaid-phones/8230659",
        "category_name": "Postpaid Phones"
    }
    ...
],
...

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 (localização)

Descrição

Tipo

cidade

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

string

estado

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

string

zip_code

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

string

store_id

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

string

AnteriorBusca

PróximoURL

Atualizado há 20 dias

Isto foi útil?