Búsqueda

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

El walmart_search la fuente está diseñada para recuperar páginas de resultados de búsqueda de Walmart. Podemos devolver el HTML de cualquier página de Walmart que desee. Además, podemos entregar salida estructurada (analizada) para páginas de búsqueda de Walmart.

Ejemplos de solicitudes

El siguiente ejemplo ilustra cómo puede obtener un resultado de página de búsqueda de Walmart analizado.

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


# Estructurar la carga útil.
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,
)

# En lugar de una respuesta con el estado del trabajo y la URL de resultados, esto devolverá el
# JSON de respuesta con el 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 el método de integración síncrono Realtime en nuestros ejemplos. Si desea usar Proxy Endpoint o la integración asíncrona Push-Pull consulte los métodos de integración sección.

Valores de parámetros de solicitud

Genérico

Parámetro

Descripción

Valor Predeterminado

source

Establece el scraper.

walmart_search

query

La palabra clave o frase para buscar productos.

min_price

Establezca el precio mínimo.

max_price

Establezca el precio máximo.

sort_by

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

best_match

render

Habilita la renderización de JavaScript cuando se establece en html. Más información.

parse

Devuelve datos analizados cuando se establece en true.

false

callback_url

URL de su 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

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

294KB

www_walmart_com_stores.csv

Abrir

También puede encontrar la página oficial de las tiendas de Walmart aquí.

Parámetro

Descripción

Tipo

domain

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

String

fulfillment_speed

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

String

fulfillment_type

Establezca el tipo de cumplimiento. Valores compatibles: pickup, delivery, shipping.

String

delivery_zip

Establezca la ubicación de envío.

String

store_id

Establezca la ubicación de la tienda.

String

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, shipping

walmart.com.mx

pickup, delivery

walmart.ca

pickup, delivery

walmart.co.cr

pickup

Para listas internacionales, store_id consulte los archivos a continuación:

38KB

www_walmart_com_mx_stores.csv

Abrir

24KB

www_walmart_ca_stores.csv

Abrir

126B

walmart_co_cr_stores.json

Abrir

Si la tienda objetivo está demasiado lejos del código postal proporcionado, intentaremos usar el código postal de la tienda objetivo; de lo contrario, la ubicación no se establecerá correctamente. En el caso de que no podamos establecer el 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 secciones siguientes, 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": "Best Match"
                            },
                            {
                                "name": "Price Low"
                            },
                            {
                                "name": "Price High"
                            },
                            {
                                "name": "Best Seller"
                            }
                        ],
                        "display_name": "Sort by"
                    },
                    ...
                ],
                "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": "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": {
                    "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 HTML

Estructura JSON

La tabla a continuación 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.

string

facets

Un array que contiene detalles de los filtros de búsqueda disponibles (refinamientos) que se muestran en la página de resultados de búsqueda.

array

results

Resultados de la página de búsqueda.

array

results.general

Un objeto con detalles generales del producto.

object

results.price

Un objeto con detalles de precios del producto.

object

results.rating

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

object

results.seller

El objeto contiene información del vendedor.

object

results.variants (opcional)

El array contiene una lista de variantes del producto.

array

results.fulfillment

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

object

location

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

object

page_details

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

object

parse_status_code

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

integer

created_at

La marca de tiempo cuando se creó el trabajo de scraping.

timestamp

updated_at

La marca de tiempo cuando se terminó el trabajo de scraping.

timestamp

page

Número de página desde el cual se extrajeron los datos

integer

url

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

string

job_id

El ID del trabajo asociado con el trabajo de scraping.

string

status_code

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

integer

is_render_forced

Identifica si se ha forzado la renderización para esta solicitud.

boolean

parser_type

Tipo de parser utilizado para extraer los datos (por ejemplo, "walmart_search_new").

string

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\""
},
...

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.

integer

url

La URL del producto.

string

image

La URL de la imagen principal del producto.

string

title

Título o nombre del producto.

string

product_id

El ID del producto.

string

sponsored

Identifica si el producto es patrocinado.

boolean

badge (opcional)

Oferta, selección popular, más vendido, 100+ comprados desde ayer

lista de strings

section_title

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

string

out_of_stock

Indica si el artículo está agotado.

boolean

Price

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

Clave (precio)

Descripción

Tipo

price

El precio actual del producto sin deducciones.

float

price_strikethrough(opcional)

El precio tachado es ya sea un precio anterior (Was Price), un precio de paquete (Bundle Price) o un precio de lista (List Price).

float

currency

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

string

price_min(opcional)

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

float

price_max(opcional)

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

float

Rating

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

Key (rating)

Descripción

Tipo

rating

Calificación promedio del producto.

float

count

Número de valoraciones del producto.

integer

Seller

Datos no mostrados visualmente.

Key (seller)

Descripción

Tipo

name

Nombre del vendedor.

string

id

ID del vendedor.

string

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"
    }
],
...

Key (variants)

Descripción

Tipo

url

URL de la variación del producto.

string

title

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

string

product_id

El Id de la variación del producto.

string

image

La imagen de la variación del producto.

string

Fulfillment

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

Key (fulfillment)

Descripción

Tipo

pickup

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

boolean

delivery

Indica si el producto está disponible para entrega desde la tienda.

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

boolean

shipping

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

boolean

free_shipping

Indica si el envío es gratuito.

boolean

Facets

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

Key (facets)

Descripción

Tipo

display_name

El nombre que se muestra de la faceta (p. ej., el nombre visible para el usuario).

string

type

El tipo de faceta.

string

values

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

array

values.name

El nombre del valor de la faceta.

string

values.item_count (opcional)

El número de artículos disponibles para la faceta específica.

integer

Location

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

Key (location)

Descripción

Tipo

city

La ciudad en la que se ejecutó la solicitud.

string

state

El estado en el que se ejecutó la solicitud.

string

zip_code

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

string

store_id

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

string

Page details

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

Key (page_details)

Descripción

Clave

total_results

El número total de resultados de búsqueda que se muestran como disponibles.

integer

last_visible_page

Último número de página de los resultados de búsqueda.

integer

page

Número de página desde el cual se extrajeron los datos del producto

integer

AnteriorWalmart SiguienteProducto

Última actualización hace 6 días

¿Te fue útil?

Buenas tardes

hashtagEjemplos de solicitudes

hashtagValores de parámetros de solicitud

hashtagGenérico

hashtagLocalización

hashtagPaginación

hashtagDatos estructurados

hashtagDiccionario de datos de salida

hashtagEjemplo HTML

hashtagEstructura JSON

hashtagGeneral

hashtagPrice

hashtagRating

hashtagSeller

hashtagVariants

hashtagFulfillment

hashtagFacets

hashtagLocation

hashtagPage details

Ejemplos de solicitudes

Valores de parámetros de solicitud

Genérico

Localización

Paginación

Datos estructurados

Diccionario de datos de salida

Ejemplo HTML

Estructura JSON

General

Price

Rating

Seller

Variants

Fulfillment

Facets

Location

Page details