Pesquisa

Extraia resultados de pesquisa do Walmart com dados analisados, incluindo preços, avaliações, info do vendedor, variantes, opções de fulfillment e facetas, com filtros por faixa de preço e ordenação.

O walmart_search a fonte foi projetada para recuperar páginas de resultados de busca 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 busca do Walmart.

Exemplos de solicitação

O exemplo abaixo ilustra como obter um resultado parseado de uma página de busca do Walmart.

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

import requests
from pprint import pprint


# Estruture o payload.
payload = {
    'source': 'walmart_search',
    'query': 'iphone',
    '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_search",
    query: "iphone",
    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_search',
    'query' => 'iphone',
    '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_search",
		"query":        "iphone",
		"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_search",
                query = "iphone",
                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_search");
        jsonObject.put("query", "iphone");
        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_search

query

A palavra-chave ou frase para pesquisar produtos.

min_price

Defina o preço mínimo.

max_price

Defina o preço máximo.

sort_by

Selecione a ordenação dos produtos. Os valores disponíveis são: price_low, price_high, best_seller, best_match.

best_match

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 a lojas específicas, locais de entrega etc. Encontre a lista de IDs de lojas do 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

fulfillment_speed

Defina a velocidade de atendimento. Os valores disponíveis são: hoje, 2_days, anytime, tomorrow.

String

tipo_de_atendimento

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

String

cep_de_entrega

Defina o local de envio.

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.

Paginação

Parâmetro

Descrição

Valor padrão

start_page

Número da página inicial.

1

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

{
    "results": [
        {
            "content": {
                "url": "https://www.walmart.com/search?q=adidas",
                "facets": [
                    {
                        "type": "sort",
                        "values": [
                            {
                                "name": "Melhor correspondência"
                            },
                            {
                                "name": "Preço baixo"
                            },
                            {
                                "name": "Preço alto"
                            },
                            {
                                "name": "Mais vendido"
                            }
                        ],
                        "display_name": "Ordenar por"
                    },
                    ...
                ],
                "results": [
                    {
                        "price": {
                            "price": 31.95,
                            "currency": "USD"
                        },
                        "rating": {
                            "count": 0,
                            "rating": 0
                        },
                        "seller": {
                            "id": "5027DF43EB634E91AEADF0D69DD4E009",
                            "name": "Revel Commerce"
                        },
                        "general": {
                            "pos": 13,
                            "url": "/ip/Adidas-Men-s-California-2-0-Crew-Neck-Short-Sleeve-Tee-T-Shirt/833623567?classType=VARIANT",
                            "image": "https://i5.walmartimages.com/seo/Adidas-Men-s-California-2-0-Crew-Neck-Short-Sleeve-Tee-T-Shirt_1b8e0b00-fdc7-4b88-99fb-9a633bf0227b_1.812a96a559770448397cd828ef1cf68b.jpeg?odnHeight=180&odnWidth=180&odnBg=FFFFFF",
                            "title": "Adidas Men's California 2.0 Crew Neck Short Sleeve Tee T-Shirt",
                            "sponsored": false,
                            "product_id": "833623567",
                            "out_of_stock": false,
                            "section_title": "Resultados para \"adidas\""
                        },
                        "variants": [
                            {
                                "url": "/ip/Adidas-Men-California-2-0-Tee-S-Black/524412260?classType=undefined&variantFieldId=actual_color",
                                "image": "https://i5.walmartimages.com/asr/f60cd6ff-41fd-484d-b76e-57f6022c2201.eedd632efbb4ce3803e9ef8306190aa3.jpeg?odnHeight=180&odnWidth=180&odnBg=ffffff",
                                "title": "Preto/Branco",
                                "product_id": "524412260"
                            },
                            {
                                "url": "/ip/Adidas-Men-s-California-2-0-Crew-Neck-Short-Sleeve-Tee-T-Shirt/833623567?classType=undefined&variantFieldId=actual_color",
                                "image": "https://i5.walmartimages.com/asr/1b8e0b00-fdc7-4b88-99fb-9a633bf0227b_1.812a96a559770448397cd828ef1cf68b.jpeg?odnHeight=180&odnWidth=180&odnBg=ffffff",
                                "title": "Branco",
                                "product_id": "833623567"
                            }
                        ],
                        "fulfillment": {
                            "pickup": false,
                            "delivery": false,
                            "shipping": true,
                            "free_shipping": true
                        }
                    },
                    ...
                ],
                "location": {
                    "city": "Sacramento",
                    "state": "CA",
                    "zipcode": "95829",
                    "store_id": "3081"
                },
                "page_details": {
                    "page": 1,
                    "total_results": 11524,
                    "last_visible_page": 25
                },
                "parse_status_code": 12000
            },
            "created_at": "2024-10-16 09:57:40",
            "updated_at": "2024-10-16 09:57:46",
            "page": 1,
            "url": "https://www.walmart.com/search?q=adidas",
            "job_id": "7252256376867528705",
            "is_render_forced": false,
            "status_code": 200,
            "parser_type": "walmart_search_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 busca que analisamos, junto 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 de busca.

string

facets

Um array contendo detalhes de quaisquer facetas de busca disponíveis (refinamentos) mostradas na página de resultados da busca.

array

resultados

Resultados da página de busca.

array

results.general

Um objeto com detalhes gerais do produto.

object

results.price

Um objeto com detalhes de preço do produto.

object

results.rating

O objeto contém detalhes sobre a avaliação do produto.

object

results.seller

O objeto contém informações do vendedor.

object

results.variants (opcional)

O array contém uma lista de variantes do produto.

array

results.fulfillment

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

object

location

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

object

page_details

O objeto contém dados sobre a página de resultados da consulta de busca.

object

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 foram extraídos

integer

url

A URL da página de busca.

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

string

Geral

...
"general": {
    "pos": 1,
    "url": "/ip/Adidas-Men-s-California-2-0-Crew-Neck-Short-Sleeve-Tee-T-Shirt/833623567?classType=VARIANT",
    "image": "https://i5.walmartimages.com/seo/Adidas-Men-s-California-2-0-Crew-Neck-Short-Sleeve-Tee-T-Shirt_1b8e0b00-fdc7-4b88-99fb-9a633bf0227b_1.812a96a559770448397cd828ef1cf68b.jpeg?odnHeight=180&odnWidth=180&odnBg=FFFFFF",
    "title": "Adidas Men's California 2.0 Crew Neck Short Sleeve Tee T-Shirt",
    "sponsored": true,
    "product_id": "833623567",
    "out_of_stock": false,
    "section_title": "Resultados para \"adidas\""
},
...

Chave (general)

Descrição

Tipo

pos

Um indicador que denota a posição de um item dentro da seção à qual o produto é atribuído.

integer

url

A URL do produto.

string

image

A URL da imagem principal do produto.

string

title

Título ou nome do produto.

string

product_id

O ID do produto.

string

sponsored

Identifica se o produto é patrocinado.

booleano

badge (opcional)

Oferta, escolha popular, mais vendido, 100+ comprados desde ontem

lista de strings

section_title

O nome da seção à qual o produto é atribuído na página de busca.

string

out_of_stock

Indica se o item está fora de estoque.

booleano

Preço

...
"price": {
    "price": 1149.99,
    "currency": "USD",
    "price_min": 1149.99
    "price_max": 1399.00
},
...

Chave (price)

Descrição

Tipo

preço

O preço atual do produto sem quaisquer descontos.

float

price_strikethrough(opcional)

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 três letras ISO 4217 da moeda.

string

price_min(opcional)

O preço mínimo do produto no caso de preço em faixa.

float

price_max(opcional)

O preço máximo do produto no caso de preço em faixa.

float

Avaliação

...
"rating": {
    "count": 428,
    "rating": 4.6
},
...

Chave (rating)

Descrição

Tipo

rating

Avaliação média do produto.

float

count

Número de avaliações do produto.

integer

Vendedor

Dados não exibidos visualmente.

Chave (seller)

Descrição

Tipo

name

Nome do vendedor.

string

id

ID do vendedor.

string

Variantes

...
"variants": [
    {
        "url": "/ip/Apple-MacBook-Air-13-3-inch-Laptop-Gold-M1-Chip-8GB-RAM-256GB-storage/550880792?classType=undefined&variantFieldId=actual_color",
        "image": "https://i5.walmartimages.com/asr/a9857413-b9fa-4c8d-9f81-7ea4c93889a1.410fd3cb7fe36102bbe2d3dca32a8075.jpeg?odnHeight=180&odnWidth=180&odnBg=ffffff",
        "title": "Dourado",
        "product_id": "550880792"
    },
    {
        "url": "/ip/Apple-MacBook-Air-13-3-inch-Laptop-Silver-M1-Chip-8GB-RAM-256GB-storage/715596133?classType=undefined&variantFieldId=actual_color",
        "image": "https://i5.walmartimages.com/asr/056c08d5-2d68-44f2-beb0-dd8a47e2f8e8.2a2a210657937c3c11b37df5be8fa4ad.jpeg?odnHeight=180&odnWidth=180&odnBg=ffffff",
        "title": "Prateado",
        "product_id": "715596133"
    },
    {
        "url": "/ip/Apple-MacBook-Air-13-3-inch-Laptop-Space-Gray-M1-Chip-8GB-RAM-256GB-storage/609040889?classType=undefined&variantFieldId=actual_color",
        "image": "https://i5.walmartimages.com/asr/af1d4133-6de9-4bdc-b1c6-1ca8bd0af7a0.c0eb74c31b2cb05df4ed11124d0e255b.jpeg?odnHeight=180&odnWidth=180&odnBg=ffffff",
        "title": "Cinza espacial",
        "product_id": "609040889"
    }
],
...

Chave (variants)

Descrição

Tipo

url

URL da variação do produto.

string

title

O título da variação do produto.

string

product_id

O ID da variação do produto.

string

image

A imagem da variação do produto.

string

Atendimento

 ...
"fulfillment": {
    "pickup": true,
    "delivery": true,
    "shipping": true,
    "free_shipping": false
}
...

Chave (fulfillment)

Descrição

Tipo

retirada

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

booleano

entrega

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

A entrega vem da sua loja local, se disponível.

booleano

shipping

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

booleano

free_shipping

Indica se o frete é gratuito.

booleano

Facetas

... 
"facets": [
    {
        "type": "sort",
        "values": [
            {
                "name": "Melhor correspondência"
            },
            {
                "name": "Preço baixo"
            },
            {
                "name": "Preço alto"
            },
            {
                "name": "Mais vendido"
            }
        ],
        "display_name": "Ordenar por"
    },
...

Chave (facets)

Descrição

Tipo

display_name

O nome exibido da faceta (ou seja, o nome visível ao usuário).

string

type

O tipo da faceta.

string

values

O array de valores da faceta mostra os valores da faceta fornecida.

array

values.name

O nome do valor da faceta.

string

values.item_count (opcional)

O número de itens disponíveis para a faceta específica.

integer

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

Detalhes da página

 ...
"page_details": {
    "page": 1,
    "total_results": 11524,
    "last_visible_page": 25
},
...

Chave (page_details)

Descrição

Chave

total_results

O número total de resultados de busca mostrados como disponíveis.

integer

last_visible_page

Número da última página dos resultados de busca.

integer

page

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

integer

AnteriorWalmart PróximoProduto

Atualizado há 1 mês

Isto foi útil?