Walmart

API de búsqueda de Walmart

Busca en Walmart y obtén productos estructurados en JSON: título, id del producto, precio, moneda, calificación, número de calificaciones, vendedor, marca de patrocinado, disponibilidad y formas de entrega por producto, además de la tienda de la que salen los precios. Envía store_id y delivery_zip para obtener el surtido y la disponibilidad de una tienda específica en walmart.com o walmart.ca. Cuesta 1 crédito con domain com o ca, 2 con com.mx y 2 en cualquier búsqueda dirigida a una tienda: el precio depende del cuerpo de la solicitud, no es fijo para la ruta.

POST/api/v1/walmart/search

Authorizations

Authorizationstringheaderrequired

Bearer authentication header of the form Bearer <token>, where <token> is your Scavio API key (e.g. Bearer sk_live_your_key).

Body

application/json

querystringrequired

Búsqueda de productos, de 1 a 500 caracteres.

Example: wireless headphones

domainenum<string>default:com

Marketplace en el que se busca. Es el parámetro que define el precio: com y ca cuestan 1 crédito, com.mx cuesta 2. También define la moneda y las URLs de producto de la respuesta.

com — walmart.com (Estados Unidos). 1 crédito.
ca — walmart.ca (Canadá). 1 crédito.
com.mx — walmart.com.mx (México). 2 créditos.

pageinteger

Página de resultados, empezando en 1. Una página por llamada. La respuesta indica max_page: pagina con base en ese valor; has_more_pages viene tal cual de Walmart y puede ser false o null aunque haya más páginas.

Example: 2

start_pageinteger

Alias obsoleto de page, que se mantiene para integraciones antiguas. Usa page.

sort_byenum<string>default:best_match

Orden de los resultados.

best_match — Relevancia de Walmart (predeterminado).
price_low — Precio, de menor a mayor.
price_high — Precio, de mayor a menor.
best_seller — Más vendidos primero.
rating_high — Mejor calificación de clientes primero.
new — Novedades primero.

min_pricenumber

Precio mínimo en la moneda del marketplace. Acepta decimales.

Example: 19.99

max_pricenumber

Precio máximo en la moneda del marketplace. Acepta decimales.

Example: 199.5

fulfillment_speedenum<string>

Filtro por rapidez de entrega. No existe el valor 2_days (el filtro de Walmart cuela productos de 3 a 4 días) ni el valor anytime: para cualquier plazo, omite el parámetro.

today — Entrega hoy.
tomorrow — Entrega a más tardar mañana.

fulfillment_typeenum<string>

Filtro por forma de entrega. in_store es el único valor aceptado: shipping, pickup y delivery no son opciones aquí; consulta el objeto fulfillment de cada producto en la respuesta.

in_store — Solo productos disponibles para recoger en tienda.

store_idstring

Tienda de Walmart en la que se busca, obtenida del endpoint de tiendas de Walmart en el mismo domain. Se envía junto con delivery_zip. Disponible con domain com y ca. Las búsquedas dirigidas a una tienda cuestan 2 créditos y tardan de 10 a 60 segundos. La tienda usada se repite en data.location.

Example: 1389

delivery_zipstring

Código postal del comprador: un ZIP de Estados Unidos de 5 dígitos, o un código postal canadiense como M5V 2T6 con domain ca. Obligatorio junto con store_id; store_id define de qué tienda son los resultados.

Example: 50036

Request

from scavio import ScavioClient

client = ScavioClient(api_key="sk_live_your_key")
results = client.walmart.search("wireless headphones", page=1, sort_by="price_low")
print(results)

# Surtido de una tienda: store_id de client.walmart.stores("50036")
store_results = client.walmart.search("whole milk", delivery_zip="50036", store_id="1389")
print(store_results["data"]["location"])

Response

"query": "wireless headphones",

"title": "Results for "wireless headphones"",

"url": "https://www.walmart.com/search?q=wireless+headphones",

"page": 1,

"total_results": 33001,

"max_page": 13,

"has_more_pages": false,

"products_count": 67,

"count": 67,

"breadcrumb": [],

"response_time": 5904,

"credits_used": 1,

"credits_remaining": 999

}

from scavio import ScavioClient client = ScavioClient(api_key="sk_live_your_key") results = client.walmart.search("wireless headphones", page=1, sort_by="price_low") print(results) # Surtido de una tienda: store_id de client.walmart.stores("50036") store_results = client.walmart.search("whole milk", delivery_zip="50036", store_id="1389") print(store_results["data"]["location"])