Walmart

API de categorías de Walmart

Explora una categoría de Walmart y obtén sus productos en JSON, con exactamente la misma estructura que la búsqueda de Walmart (id, título, precio, calificación, vendedor, disponibilidad, formas de entrega y variantes), además de la ruta de la categoría. Cuesta 1 crédito con domain com o ca, y 2 créditos con com.mx: el precio depende del cuerpo de la solicitud, no es fijo para la ruta.

POST/api/v1/walmart/category

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

category_idstringrequired

Id de categoría de Walmart. Se aceptan las dos formas: el id final solo, o la ruta completa unida con guiones bajos de una URL /browse/.

Example: 3944_133251_1095191

domainenum<string>default:com

Marketplace que se explora. 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 llega como null en las páginas de categoría.

Example: 2

limitinteger

Recorta los productos devueltos a este número como máximo. Se aplica después de obtener la página, así que reduce el tamaño de la respuesta pero nunca el costo en créditos.

Example: 10

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.

Request

from scavio import ScavioClient

client = ScavioClient(api_key="sk_live_your_key")
results = client.walmart.category("3944_133251_1095191", page=1, sort_by="best_seller")
print(results)

Response

"query": null,

"title": "Results for "Headphones"",

"url": "https://www.walmart.com/browse/3944_133251_1095191",

"page": 1,

"total_results": 82717,

"max_page": 25,

"has_more_pages": null,

"products_count": 20,

"count": 20,

"related_searches": []

"response_time": 5516,

"credits_used": 1,

"credits_remaining": 999

}