Produto

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

O walmart_product a fonte é projetada 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 entregar saída estruturada (analisada) para páginas de produtos do Walmart.

Exemplos de requisição

O exemplo abaixo ilustra como você pode obter um resultado de página de produto do Walmart analisado.

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


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

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

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

<?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íncrono em nossos exemplos. Se você quiser usar Proxy Endpoint ou a integração assíncrona Push-Pull consulte os métodos de integração na seção.

Valores dos parâmetros de requisição

Genérico

Parâmetro

Descrição

Valor padrão

source

Define o scraper.

walmart_product

product_id

ID do produto no Walmart.

render

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

parse

Retorna dados analisados quando definido como true.

false

callback_url

URL para o 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 entrega. Encontre a lista de IDs de lojas 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 de domínio para o Walmart. Valores disponíveis: com, com.mx, ca, co.cr. Padrão: com.

String

fulfillment_type

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

String

delivery_zip

Defina o local de entrega.

String

store_id

Defina a localização da loja.

String

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

Domain

Supported fulfillment types

walmart.com

pickup, delivery, shipping

walmart.com.mx

pickup, delivery

walmart.ca

pickup, delivery

walmart.co.cr

pickup

Para listas internacionais, store_id 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 distante do CEP fornecido — tentaremos usar o CEP da loja alvo, caso contrário a localização não será definida corretamente. No caso de não conseguirmos definir o delivery_zip - O Walmart retornará seus resultados padrão sem segmentação por loja.

Dados estruturados

Nas seções seguintes, trechos de código JSON analisado são encurtados quando houver 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 de HTML

Estrutura JSON

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

Chave

Descrição

Tipo

general

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

object

price

O objeto contém detalhes sobre a precificaçã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 levam ao produto.

object

location

Fornece informação sobre a localização na qual a requisição foi executada.

object

fulfillment

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

object

specifications

Array de pares chave-valor detalhando atributos ou características específicas 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

created_at

O timestamp quando o trabalho de scraping foi criado.

timestamp

updated_at

O timestamp quando o trabalho de scraping foi finalizado.

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 do Walmart

string

job_id

O ID do job 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 requisição.

boolean

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 para 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, características 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

Global Trade Item Number (GTIN) do produto.

string

Price

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

Chave (price)

Descrição

Tipo

price

O preço atual do produto sem deduções.

float

price_strikethrough

O preço riscado é ou um Was Price, um Bundle Price, ou um List Price.

float

currency

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

string

Rating

...
 "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

Seller

...
"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 registrado oficial 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

Specifications

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

Chave (specifications)

Descrição

Tipo

key

Atributo ou característica específica do produto.

string

value

Valor correspondente ou descrição do atributo especificado pela chave de 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.

boolean

pickup_information

A mensagem de retirada, quando pickup = true.

string

delivery

Indica se o produto está disponível para entrega a partir da loja local.

boolean

delivery_information

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

string

shipping

Indica se o produto está disponível para envio para a casa.

boolean

shipping_information

A mensagem de envio, se exibida.

string

free_shipping

Indica se o envio é gratuito.

boolean

out_of_stock

Indica se o produto está atualmente fora de estoque.

boolean

Variations

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

Chave (variations)

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

Location

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

Chave (location)

Descrição

Tipo

city

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

string

state

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

string

zip_code

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

string

store_id

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

string

AnteriorBusca PróximoURL

Atualizado há 6 dias

Isto foi útil?

Boa tarde

hashtagExemplos de requisição

hashtagValores dos parâmetros de requisição

hashtagGenérico

hashtagLocalização

hashtagDados estruturados

hashtagDicionário de dados de saída

hashtagExemplo de HTML

hashtagGeral

hashtagPrice

hashtagRating

hashtagSeller

hashtagSpecifications

hashtagFulfillment

hashtagVariations

hashtagBreadcrumbs

hashtagLocation

Exemplos de requisição

Valores dos parâmetros de requisição

Genérico

Localização

Dados estruturados

Dicionário de dados de saída

Exemplo de HTML

Geral

Price

Rating

Seller

Specifications

Fulfillment

Variations

Breadcrumbs

Location