Search

Extraia resultados de busca da Walmart com dados analisados, incluindo preços, avaliações, informações do vendedor, variantes, opções de atendimento e facets, com filtros por faixa de preço e ordenação.

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

Exemplos de requisição

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

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


# Estruturar o payload.
payload = {
    'source': 'walmart_search',
    'query': 'iphone',
    '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 de resultados, isto retornará o
# JSON de resposta com o resultado.
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 síncrono Realtime em nossos exemplos. Se desejar usar Proxy Endpoint ou integração assíncrona Push-Pull consulte os métodos de integração da seção.

Valores dos parâmetros de requisição

Genérico

Parâmetro

Descrição

Valor padrão

source

Define o scraper.

walmart_search

query

A palavra-chave ou frase para buscar 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. Valores disponíveis são: price_low, price_high, best_seller, best_match.

best_match

render

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

parse

Retorna dados parseados 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 resultados para lojas específicas, locais de envio, 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

url

domain

Localização de 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. Valores disponíveis são: today, 2_days, anytime, tomorrow.

String

fulfillment_type

Defina o tipo de atendimento. Valores suportados: pickup, O local de envio do produto., shipping.

String

delivery_zip

Defina o local de envio.

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, O local de envio do produto., shipping

walmart.com.mx

pickup, O local de envio do produto.

walmart.ca

pickup, O local de envio do produto.

walmart.co.cr

pickup

Para listas internacionais, store_id veja 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á configurada corretamente. Caso não consigamos definir o delivery_zip - O Walmart retornará seus resultados padrão sem segmentação por loja.

Controles para gerenciar a paginação e a recuperação de resultados de pesquisa.

Parâmetro

Descrição

Valor padrão

Número da página inicial.

pages

1

saída estruturada

Pricing

Saída estruturada da página de busca do Walmart

{
    "content": {
        {
            "url": "https://www.amazon.com/gp/aod/ajax/ref=dp_aod_unknown_mbc?asin=B07VGRJDFY&pageno=1",
                "url": "https://www.walmart.com/search?q=adidas",
                "facets": [
                    {
                        "type": "sort",
                        "values": [
                            {
                                "name": "Best Match"
                            },
                            {
                                "name": "Price Low"
                            },
                            {
                                "name": "Price High"
                            },
                            {
                                "name": "Best Seller"
                            }
                        ],
                        "display_name": "Sort by"
                    },
                    ...
                ],
                "content": {
                    {
                        "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": "Results for \"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": "Black/White",
                                "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": "White",
                                "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": {
                    "title": "Nintendo Switch with Neon Blue and Neon Red Joy‑Con - HAC-001(-01)",
                    "total_results": 11524,
                    "last_visible_page": 25
                },
                "created_at": "2022-05-09 06:55:44",
            },
            "created_at": "2024-10-16 09:57:40",
            "updated_at": "2024-10-16 09:57:46",
            "title": "Nintendo Switch with Neon Blue and Neon Red Joy‑Con - HAC-001(-01)",
            "url": "https://www.walmart.com/search?q=adidas",
            "job_id": "7252256376867528705",
            "is_render_forced": false,
            "parser_type": ""
            "parser_type": "walmart_search_new"
        }
    ]
}

Exemplo HTML

fornece representação estruturada das informações de precificação para um produto específico disponível na Amazon. A tabela abaixo apresenta uma lista detalhada de cada campo que parseamos, junto com sua descrição e tipo de dado. A tabela também inclui alguns metadados.

Chave

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

Tipo

Descrição

url

A URL da página do produto na Amazon.

A URL da página de busca.

asin

facets

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

asin_in_url

results

Resultados da página de busca.

asin_in_url

results.general

Um objeto com detalhes gerais do produto.

object

results.price

Um objeto com detalhes de precificaçã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 (optional)

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

asin_in_url

results.fulfillment

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

object

location

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

object

page_details

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

object

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

created_at aqui.

title

O timestamp quando o job de scraping foi criado.

timestamp

update_at

updated_at

job_id

update_at

O número da página atual.

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

title

A URL da página do produto na Amazon.

A URL da página de busca.

asin

O ID do job associado ao job de scraping.

status_code

asin

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

parser_type aqui.

title

is_render_forced

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

boolean

O tipo de parser usado para parsear os dados.

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

asin

General

...
"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": "Results for \"adidas\""
},
...

Chave (general)

Descrição

url

pos

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

title

A URL da página do produto na Amazon.

A URL do produto.

asin

image

A URL da imagem principal do produto.

asin

O título do produto.

Título ou nome do produto.

asin

product_id

O ID do produto.

asin

sponsored

Identifica se o produto é patrocinado.

boolean

badge (optional)

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.

asin

out_of_stock

Indica se o item está fora de estoque.

boolean

Price

...
"price": {
    "price": 1149.99,
    "delivery": "Ships from Gamer Girlz Online",
    "price_min": 1149.99
    "price_max": 1399.00
},
...

Chave (price)

Descrição

url

O preço do produto.

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

seller

price_strikethrough(optional)

O preço riscado é ou um Preço Anterior, um Preço de Pacote, ou um Preço de Tabela.

seller

Define a moeda. Verifique os valores disponíveis

O código de três letras ISO 4217 da moeda.

asin

price_min(optional)

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

seller

price_max(optional)

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

seller

Rating

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

Chave (rating)

Descrição

url

rating

Avaliação média do produto.

seller

count

Número de avaliações do produto.

title

Seller

Dados não exibidos visualmente.

Chave (seller)

Descrição

url

name

Nome do vendedor.

asin

id

ID do vendedor.

asin

Variants

...
"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": "Gold",
        "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": "Silver",
        "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": "Space Gray",
        "product_id": "609040889"
    }
],
...

Chave (variants)

Descrição

url

A URL da página do produto na Amazon.

URL da variação do produto.

asin

O título do produto.

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

asin

product_id

O Id da variação do produto.

asin

image

A imagem da variação do produto.

asin

Fulfillment

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

Chave (fulfillment)

Descrição

url

pickup

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

boolean

O local de envio do produto.

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

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

boolean

shipping

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

boolean

free_shipping

Indica se o envio é gratuito.

boolean

Facets

... 
"facets": [
    {
        "type": "sort",
        "values": [
            {
                "name": "Best Match"
            },
            {
                "name": "Price Low"
            },
            {
                "name": "Price High"
            },
            {
                "name": "Best Seller"
            }
        ],
        "display_name": "Sort by"
    },
...

Chave (facets)

Descrição

url

display_name

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

asin

type

O tipo da faceta.

asin

values

O array de valores da faceta mostra os valores da faceta em questão.

asin_in_url

values.name

O nome do valor da faceta.

asin

values.item_count (optional)

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

title

Location

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

Chave (location)

Descrição

url

city

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

asin

state

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

asin

zip_code

O código postal em que a requisição foi executada.

asin

store_id

O ID da loja na qual a requisição foi executada.

asin

Detalhes da página

 ...
"page_details": {
    "title": "Nintendo Switch with Neon Blue and Neon Red Joy‑Con - HAC-001(-01)",
    "total_results": 11524,
    "last_visible_page": 25
},
...

Chave (page_details)

Descrição

Tipo

total_results

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

title

last_visible_page

Último número de página dos resultados de busca.

title

O número da página atual.

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

title

AnteriorWalmart PróximoProduct

Atualizado há 7 dias

Isto foi útil?

Boa tarde

hashtagExemplos de requisição

hashtagValores dos parâmetros de requisição

hashtagGenérico

hashtagLocalização

hashtagControles para gerenciar a paginação e a recuperação de resultados de pesquisa.

hashtagsaída estruturada

hashtagExemplo HTML

hashtagfornece representação estruturada das informações de precificação para um produto específico disponível na Amazon. A tabela abaixo apresenta uma lista detalhada de cada campo que parseamos, junto com sua descrição e tipo de dado. A tabela também inclui alguns metadados.

hashtagChave

hashtagGeneral

hashtagPrice

hashtagRating

hashtagSeller

hashtagVariants

hashtagFulfillment

hashtagFacets

hashtagLocation

hashtagDetalhes da página

Exemplos de requisição

Valores dos parâmetros de requisição

Genérico

Localização

Controles para gerenciar a paginação e a recuperação de resultados de pesquisa.

saída estruturada

Exemplo HTML

fornece representação estruturada das informações de precificação para um produto específico disponível na Amazon. A tabela abaixo apresenta uma lista detalhada de cada campo que parseamos, junto com sua descrição e tipo de dado. A tabela também inclui alguns metadados.

Chave

General

Price

Rating

Seller

Variants

Fulfillment

Facets

Location

Detalhes da página