Búsqueda

Extrae resultados de búsqueda de Walmart con datos analizados, incluidos precios, valoraciones, información del vendedor, variantes, opciones de cumplimiento y facetas, con filtros por rango de precios y ordenación.

La walmart_search source está diseñado para recuperar páginas de resultados de búsqueda de Walmart. Podemos devolver el HTML de cualquier página de Walmart que desees. Además, podemos entregar salida estructurada (analizada) para páginas de búsqueda de Walmart.

Ejemplos de solicitud

El siguiente ejemplo ilustra cómo obtener un resultado analizado de una página de búsqueda de 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


# Estructura del payload.
payload = {
    'source': 'walmart_search',
    'query': 'iphone',
    'parse': True,
}

# Obtener respuesta.
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();

Toda la cadena que envíes debe estar codificada en URL.

https://realtime.oxylabs.io/v1/queries?source=walmart_search&query=iphone&parse=true&access_token=12345abcde

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

{
    "source": "walmart_search", 
    "query": "iphone", 
    "parse": true
}

Usamos integración síncrona Realtime método de integración en nuestros ejemplos. Si deseas usar Proxy Endpoint o una integración asíncrona Push-Pull integración, consulta la métodos de integración sección.

Valores de los parámetros de solicitud

Genérico

Parámetro

Descripción

Valor predeterminado

source

Configura el scraper.

walmart_search

consulta

La palabra clave o frase para buscar productos.

min_price

Establece el precio mínimo.

max_price

Establece el precio máximo.

sort_by

Selecciona la ordenación de los productos. Los valores disponibles son: price_low, price_high, best_seller, best_match.

best_match

render

Habilita el renderizado de JavaScript cuando se establece en html. Más información.

parse

Devuelve datos analizados cuando se establece en true.

false

callback_url

URL para tu endpoint de callback. Más información

user_agent_type

Tipo de dispositivo y navegador. La lista completa se puede encontrar aquí.

desktop

- parámetro obligatorio

Localización

Adapta los resultados a tiendas específicas, ubicaciones de envío, etc. Encuentra la lista de IDs de tiendas de Walmart aquí:

www_walmart_com_stores.csv

294KB

Abrir

También puedes encontrar la página oficial de Walmart Stores aquí.

Parámetro

Descripción

Tipo

domain

Localización de dominio para Walmart. Valores disponibles: com, com.mx, ca, co.cr. Valor predeterminado: com.

cadena

fulfillment_speed

Establece la velocidad de cumplimiento. Los valores disponibles son: today, 2_days, anytime, tomorrow.

cadena

fulfillment_type

Establece el tipo de cumplimiento. Valores compatibles: pickup, delivery, envío.

cadena

delivery_zip

Establece la ubicación de envío.

cadena

store_id

Establece la ubicación de la tienda.

cadena

La disponibilidad del parámetro de tipo de cumplimiento varía según el dominio de Walmart:

Dominio

Tipos de cumplimiento compatibles

walmart.com

pickup, delivery, envío

walmart.com.mx

pickup, delivery

walmart.ca

pickup, delivery

walmart.co.cr

pickup

Para las listas internacionales store_id consulta los archivos a continuación:

www_walmart_com_mx_stores.csv

38KB

Abrir

www_walmart_ca_stores.csv

24KB

Abrir

walmart_co_cr_stores.json

126B

Abrir

Si la tienda de destino está demasiado lejos del código postal proporcionado, intentaremos usar el código postal de la tienda de destino; de lo contrario, la ubicación no se establecerá correctamente. En caso de que no podamos establecer la delivery_zip - Walmart devolverá sus resultados predeterminados sin segmentación por tienda.

Paginación

Parámetro

Descripción

Valor predeterminado

start_page

Número de página inicial.

1

Datos estructurados

En las siguientes secciones, los fragmentos de código JSON analizados se acortan cuando hay más de un elemento disponible para el tipo de resultado.

Salida estructurada de la página de búsqueda de Walmart

{
    "results": [
        {
            "content": {
                "url": "https://www.walmart.com/search?q=adidas",
                "facets": [
                    {
                        "type": "sort",
                        "values": [
                            {
                                "name": "Mejor coincidencia"
                            },
                            {
                                "name": "Precio más bajo"
                            },
                            {
                                "name": "Precio más alto"
                            },
                            {
                                "name": "Más 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": "Camiseta Adidas para hombre California 2.0 de cuello redondo y manga corta",
                            "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": "Negro/Blanco",
                                "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": "Blanco",
                                "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"
        }
    ]
}

Diccionario de datos de salida

Ejemplo en HTML

Estructura JSON

La tabla siguiente presenta una lista detallada de cada elemento de la página de búsqueda que analizamos, junto con su descripción y tipo de dato. La tabla también incluye algunos metadatos.

Clave

Descripción

Tipo

url

La URL de la página de búsqueda.

cadena

facetas

Un arreglo que contiene detalles de cualquier faceta de búsqueda disponible (refinamientos) que se muestran en la página de resultados de búsqueda.

arreglo

results

Resultados de la página de búsqueda.

arreglo

results.general

Un objeto con detalles generales del producto.

objeto

results.price

Un objeto con detalles de precios del producto.

objeto

results.rating

El objeto contiene detalles sobre la valoración del producto.

objeto

results.seller

El objeto contiene información del vendedor.

objeto

results.variants (opcional)

El arreglo contiene una lista de variantes del producto.

arreglo

results.fulfillment

El objeto contiene detalles sobre las opciones de cumplimiento del producto.

objeto

location

Proporciona información sobre la ubicación desde la que se ejecutó la solicitud.

objeto

page_details

El objeto contiene datos sobre la página de resultados de la consulta de búsqueda.

objeto

parse_status_code

El código de estado del trabajo de análisis. Puedes ver los códigos de estado del parser descritos aquí.

entero

creado_en

La marca de tiempo en que se creó el trabajo de scraping.

marca_de_tiempo

actualizado_en

La marca de tiempo en que terminó el trabajo de scraping.

marca_de_tiempo

page

Número de página del que se extrajeron los datos

entero

url

La URL de la página de búsqueda.

cadena

id_del_trabajo

El ID del trabajo asociado con el trabajo de scraping.

cadena

código_de_estado

El código de estado del trabajo de scraping. Puedes ver los códigos de estado del scraper descritos aquí.

entero

is_render_forced

Identifica si el renderizado se ha forzado para esta solicitud.

booleano

parser_type

Tipo de analizador usado para extraer los datos (p. ej., "walmart_search_new").

cadena

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": "Camiseta Adidas para hombre California 2.0 de cuello redondo y manga corta",
    "sponsored": true,
    "product_id": "833623567",
    "out_of_stock": false,
    "section_title": "Resultados para \"adidas\""
},
...

Clave (general)

Descripción

Tipo

pos

Un indicador que denota la posición de un elemento dado dentro de la sección a la que se atribuye el producto.

entero

url

La URL del producto.

cadena

image

La URL de la imagen principal del producto.

cadena

title

Título o nombre del producto.

cadena

product_id

El ID del producto.

cadena

sponsored

Identifica si el producto es patrocinado.

booleano

insignia (opcional)

Oferta, opción popular, más vendido, más de 100 comprados desde ayer

lista de cadenas

section_title

El nombre de la sección a la que se atribuye el producto en la página de búsqueda.

cadena

out_of_stock

Indica si el artículo está agotado.

booleano

Precio

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

Clave (precio)

Descripción

Tipo

precio(opcional)

El precio actual del producto sin descuentos.

flotante

precio_tachado(opcional)

El precio tachado es, según corresponda, un precio anterior, un precio de paquete o un precio de lista.

flotante

moneda

El código de tres letras ISO 4217 de la moneda.

cadena

price_min(opcional)

El precio mínimo del producto en caso de precios por rango.

flotante

price_max(opcional)

El precio máximo del producto en caso de precios por rango.

flotante

Calificación

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

Clave (calificación)

Descripción

Tipo

rating

Calificación promedio del producto.

flotante

cantidad

Número de calificaciones del producto.

entero

Vendedor

Datos no mostrados visualmente.

Clave (vendedor)

Descripción

Tipo

nombre

Nombre del vendedor.

cadena

id

ID del vendedor.

cadena

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": "Dorado",
        "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": "Plata",
        "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": "Gris espacial",
        "product_id": "609040889"
    }
],
...

Clave (variantes)

Descripción

Tipo

url

La URL de la variación del producto.

cadena

title

El título de la variación del producto.

cadena

product_id

El ID de la variación del producto.

cadena

image

La imagen de la variación del producto.

cadena

Cumplimiento

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

Clave (cumplimiento)

Descripción

Tipo

pickup

Indica si el producto está disponible para cumplimiento mediante recogida en tienda.

booleano

delivery

Indica si el producto está disponible para ser entregado mediante envío desde la tienda.

La entrega proviene de tu tienda local, si está disponible.

booleano

envío

Indica si el producto está disponible para cumplimiento mediante envío a domicilio.

booleano

free_shipping

Indica si el envío es gratuito.

booleano

Facetas

... 
"facets": [
    {
        "type": "sort",
        "values": [
            {
                "name": "Mejor coincidencia"
            },
            {
                "name": "Precio más bajo"
            },
            {
                "name": "Precio más alto"
            },
            {
                "name": "Más vendido"
            }
        ],
        "display_name": "Ordenar por"
    },
...

Clave (facetas)

Descripción

Tipo

display_name

El nombre visible de la faceta (es decir, el nombre que ve el usuario).

cadena

type

El tipo de faceta.

cadena

values

El arreglo de valores de la faceta muestra los valores de la faceta dada.

arreglo

values.name

El nombre del valor de la faceta.

cadena

values.item_count (opcional)

La cantidad de artículos disponibles para la faceta específica.

entero

Ubicación

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

Clave (ubicación)

Descripción

Tipo

ciudad

La ciudad desde la que se ejecutó la solicitud.

cadena

estado

El estado desde el que se ejecutó la solicitud.

cadena

código postal

El código postal desde el que se ejecutó la solicitud.

cadena

store_id

El ID de la tienda desde la que se ejecutó la solicitud.

cadena

Detalles de la página

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

Clave (page_details)

Descripción

Clave

total_results

El número total de resultados de búsqueda mostrados como disponibles.

entero

last_visible_page

Número de la última página de resultados de búsqueda.

entero

page

Número de página de la que se extrajeron los datos del producto

entero

AnteriorWalmart

SiguienteProducto

Última actualización hace 18 días

¿Te fue útil?