API de Walmart

La API de Walmart te permite buscar productos y obtener informacion detallada de productos por ID de producto. Ambos endpoints soportan emulacion de dispositivo, localizacion de entrega y filtros de cumplimiento.

Endpoints

Endpoint	Descripcion
`POST /api/v1/walmart/search`	Buscar productos de Walmart con ordenamiento, paginacion, filtros de precio y cumplimiento
`POST /api/v1/walmart/product`	Obtener informacion detallada de un producto por ID de producto de Walmart

Autenticacion

Cabecera	Valor	Requerido
`Authorization`	`Bearer YOUR_API_KEY`	Si
`Content-Type`	`application/json`	Si

Busqueda de Productos

Bash

POST https://api.scavio.dev/api/v1/walmart/search

Busca productos en Walmart y obtiene resultados estructurados incluyendo precios, calificaciones y disponibilidad.

Cuerpo de la Solicitud

Parametro	Tipo	Por defecto	Descripcion
`query`	`string`	--	Requerido. Consulta de busqueda (1-500 caracteres).
`domain`	`string`	`""`	Dominio de Walmart.
`device`	`string`	`desktop`	Tipo de dispositivo. Uno de: `desktop`, `mobile`, `tablet`
`sort_by`	`string`	`best_match`	Orden de clasificacion. Uno de: `best_match`, `price_low`, `price_high`, `best_seller`
`start_page`	`integer`	`1`	Numero de pagina inicial (indexado desde 1).
`min_price`	`integer`	--	Filtro de precio minimo (en dolares).
`max_price`	`integer`	--	Filtro de precio maximo (en dolares).
`fulfillment_speed`	`string`	--	Filtro de velocidad de entrega. Uno de: `today`, `tomorrow`, `2_days`, `anytime`
`fulfillment_type`	`string`	--	Filtro de tipo de cumplimiento. Actualmente soporta: `in_store`
`delivery_zip`	`string`	--	Codigo postal de entrega para resultados y disponibilidad localizados.
`store_id`	`string`	--	ID de tienda Walmart para disponibilidad en tienda.

Ejemplo

curl -X POST 'https://api.scavio.dev/api/v1/walmart/search' \
  -H 'Authorization: Bearer sk_live_your_key' \
  -H 'Content-Type: application/json' \
  -d '{
    "query": "wireless headphones",
    "sort_by": "best_seller",
    "min_price": 20,
    "max_price": 100
  }'

Ejemplo de Respuesta

JSON

{
  "data": {
    "page": 1,
    "products_count": 40,
    "location": {
      "city": "Jacksonville",
      "state": "FL",
      "store_id": "5054",
      "zipcode": "32246"
    },
    "products": [
      {
        "id": "123456789",
        "title": "Sony WH-1000XM5 Wireless Noise Canceling Headphones",
        "url": "/ip/Sony-WH-1000XM5/123456789",
        "image": "https://i5.walmartimages.com/...",
        "price": 248.0,
        "price_strikethrough": null,
        "currency": "USD",
        "rating": 4.7,
        "rating_count": 8230,
        "sponsored": false,
        "out_of_stock": false,
        "seller_name": "Walmart.com",
        "seller_id": "F55CDC31AB754BB68FE0B39041159D63",
        "fulfillment": {
          "delivery": true,
          "free_shipping": true,
          "pickup": true,
          "shipping": true
        },
        "pos": 1,
        "variants": []
      }
    ],
    "url": "https://www.walmart.com/search?q=...",
    "html": "",
    "screenshot": ""
  },
  "response_time": 1920,
  "credits_used": 1,
  "credits_remaining": 999
}

Detalles del Producto

Bash

POST https://api.scavio.dev/api/v1/walmart/product

Obtiene informacion detallada de un producto especifico de Walmart por su ID de producto. Devuelve precios, descripcion, especificaciones, imagenes, calificaciones e informacion del vendedor.

Cuerpo de la Solicitud

Parametro	Tipo	Por defecto	Descripcion
`product_id`	`string`	--	Requerido. ID de producto de Walmart (ej. `123456789`).
`domain`	`string`	--	Dominio de Walmart.
`device`	`string`	`desktop`	Tipo de dispositivo. Uno de: `desktop`, `mobile`, `tablet`
`delivery_zip`	`string`	--	Codigo postal de entrega para precios localizados.
`store_id`	`string`	--	ID de tienda Walmart para disponibilidad en tienda.

Ejemplo

curl -X POST 'https://api.scavio.dev/api/v1/walmart/product' \
  -H 'Authorization: Bearer sk_live_your_key' \
  -H 'Content-Type: application/json' \
  -d '{"product_id": "123456789"}'

Ejemplo de Respuesta

JSON

{
  "data": {
    "id": "123456789",
    "sku": "123456789",
    "gtin": "012345678901",
    "price": 248.0,
    "price_strikethrough": 349.99,
    "currency": "USD",
    "rating": 4.7,
    "rating_count": 8230,
    "out_of_stock": false,
    "seller_name": "Walmart.com",
    "seller_id": "F55CDC31AB754BB68FE0B39041159D63",
    "seller_url": null,
    "image": "https://i5.walmartimages.com/...",
    "images": [
      "https://i5.walmartimages.com/..."
    ],
    "fulfillment": {
      "delivery": true,
      "delivery_information": "Arrives today",
      "free_shipping": true,
      "fulfilled_by": "",
      "out_of_stock": false,
      "pickup": true,
      "pickup_information": "Pickup today",
      "shipping": true,
      "shipping_information": "Free shipping"
    },
    "specifications": [
      { "key": "Brand", "value": "Sony" },
      { "key": "Wireless technology", "value": "Bluetooth" }
    ],
    "html": "",
    "screenshot": ""
  },
  "response_time": 2310,
  "credits_used": 1,
  "credits_remaining": 998
}

Formato de Respuesta

Ambos endpoints devuelven un envoltorio de respuesta consistente:

Campo	Tipo	Descripcion
`data`	`object \| null`	El payload de la respuesta. `null` si la solicitud fallo en el upstream. La busqueda devuelve `{page, products, location, ...}`; el producto devuelve el objeto del producto directamente.
`response_time`	`number`	Tiempo de respuesta del servidor en milisegundos
`credits_used`	`number`	Numero de creditos consumidos
`credits_remaining`	`number`	Creditos restantes en tu periodo de facturacion actual

Respuestas de Error

Estado	Descripcion
`401`	No autorizado -- clave API faltante o invalida
`429`	Limite de tasa o uso excedido para tu plan
`502`	Error del upstream -- reintentar despues de un breve retraso
`503`	Upstream no disponible -- reintentar mas tarde

Consulta Errores para la referencia completa de errores y mejores practicas de reintento.

Relacionados

Inicio Rapido -- obtener tu clave API y hacer tu primera solicitud
API de Google Search -- buscar en Google con datos SERP estructurados
YouTube API -- buscar videos y extraer metadatos
API de Amazon -- buscar productos de Amazon en 12 marketplaces
Limites de Tasa -- limites por nivel de plan

API de Walmart

Endpoints

Endpoint	Descripcion
`POST /api/v1/walmart/search`	Buscar productos de Walmart con ordenamiento, paginacion, filtros de precio y cumplimiento
`POST /api/v1/walmart/product`	Obtener informacion detallada de un producto por ID de producto de Walmart

Autenticacion

Cabecera	Valor	Requerido
`Authorization`	`Bearer YOUR_API_KEY`	Si
`Content-Type`	`application/json`	Si

Busqueda de Productos

Bash

POST https://api.scavio.dev/api/v1/walmart/search

Busca productos en Walmart y obtiene resultados estructurados incluyendo precios, calificaciones y disponibilidad.

Cuerpo de la Solicitud

Parametro	Tipo	Por defecto	Descripcion
`query`	`string`	--	Requerido. Consulta de busqueda (1-500 caracteres).
`domain`	`string`	`""`	Dominio de Walmart.
`device`	`string`	`desktop`	Tipo de dispositivo. Uno de: `desktop`, `mobile`, `tablet`
`sort_by`	`string`	`best_match`	Orden de clasificacion. Uno de: `best_match`, `price_low`, `price_high`, `best_seller`
`start_page`	`integer`	`1`	Numero de pagina inicial (indexado desde 1).
`min_price`	`integer`	--	Filtro de precio minimo (en dolares).
`max_price`	`integer`	--	Filtro de precio maximo (en dolares).
`fulfillment_speed`	`string`	--	Filtro de velocidad de entrega. Uno de: `today`, `tomorrow`, `2_days`, `anytime`
`fulfillment_type`	`string`	--	Filtro de tipo de cumplimiento. Actualmente soporta: `in_store`
`delivery_zip`	`string`	--	Codigo postal de entrega para resultados y disponibilidad localizados.
`store_id`	`string`	--	ID de tienda Walmart para disponibilidad en tienda.

Ejemplo

curl -X POST 'https://api.scavio.dev/api/v1/walmart/search' \
  -H 'Authorization: Bearer sk_live_your_key' \
  -H 'Content-Type: application/json' \
  -d '{
    "query": "wireless headphones",
    "sort_by": "best_seller",
    "min_price": 20,
    "max_price": 100
  }'

Ejemplo de Respuesta

JSON

{
  "data": {
    "page": 1,
    "products_count": 40,
    "location": {
      "city": "Jacksonville",
      "state": "FL",
      "store_id": "5054",
      "zipcode": "32246"
    },
    "products": [
      {
        "id": "123456789",
        "title": "Sony WH-1000XM5 Wireless Noise Canceling Headphones",
        "url": "/ip/Sony-WH-1000XM5/123456789",
        "image": "https://i5.walmartimages.com/...",
        "price": 248.0,
        "price_strikethrough": null,
        "currency": "USD",
        "rating": 4.7,
        "rating_count": 8230,
        "sponsored": false,
        "out_of_stock": false,
        "seller_name": "Walmart.com",
        "seller_id": "F55CDC31AB754BB68FE0B39041159D63",
        "fulfillment": {
          "delivery": true,
          "free_shipping": true,
          "pickup": true,
          "shipping": true
        },
        "pos": 1,
        "variants": []
      }
    ],
    "url": "https://www.walmart.com/search?q=...",
    "html": "",
    "screenshot": ""
  },
  "response_time": 1920,
  "credits_used": 1,
  "credits_remaining": 999
}

Detalles del Producto

Bash

POST https://api.scavio.dev/api/v1/walmart/product

Obtiene informacion detallada de un producto especifico de Walmart por su ID de producto. Devuelve precios, descripcion, especificaciones, imagenes, calificaciones e informacion del vendedor.

Cuerpo de la Solicitud

Parametro	Tipo	Por defecto	Descripcion
`product_id`	`string`	--	Requerido. ID de producto de Walmart (ej. `123456789`).
`domain`	`string`	--	Dominio de Walmart.
`device`	`string`	`desktop`	Tipo de dispositivo. Uno de: `desktop`, `mobile`, `tablet`
`delivery_zip`	`string`	--	Codigo postal de entrega para precios localizados.
`store_id`	`string`	--	ID de tienda Walmart para disponibilidad en tienda.

Ejemplo

curl -X POST 'https://api.scavio.dev/api/v1/walmart/product' \
  -H 'Authorization: Bearer sk_live_your_key' \
  -H 'Content-Type: application/json' \
  -d '{"product_id": "123456789"}'

Ejemplo de Respuesta

JSON

{
  "data": {
    "id": "123456789",
    "sku": "123456789",
    "gtin": "012345678901",
    "price": 248.0,
    "price_strikethrough": 349.99,
    "currency": "USD",
    "rating": 4.7,
    "rating_count": 8230,
    "out_of_stock": false,
    "seller_name": "Walmart.com",
    "seller_id": "F55CDC31AB754BB68FE0B39041159D63",
    "seller_url": null,
    "image": "https://i5.walmartimages.com/...",
    "images": [
      "https://i5.walmartimages.com/..."
    ],
    "fulfillment": {
      "delivery": true,
      "delivery_information": "Arrives today",
      "free_shipping": true,
      "fulfilled_by": "",
      "out_of_stock": false,
      "pickup": true,
      "pickup_information": "Pickup today",
      "shipping": true,
      "shipping_information": "Free shipping"
    },
    "specifications": [
      { "key": "Brand", "value": "Sony" },
      { "key": "Wireless technology", "value": "Bluetooth" }
    ],
    "html": "",
    "screenshot": ""
  },
  "response_time": 2310,
  "credits_used": 1,
  "credits_remaining": 998
}

Formato de Respuesta

Ambos endpoints devuelven un envoltorio de respuesta consistente:

Campo	Tipo	Descripcion
`data`	`object \| null`	El payload de la respuesta. `null` si la solicitud fallo en el upstream. La busqueda devuelve `{page, products, location, ...}`; el producto devuelve el objeto del producto directamente.
`response_time`	`number`	Tiempo de respuesta del servidor en milisegundos
`credits_used`	`number`	Numero de creditos consumidos
`credits_remaining`	`number`	Creditos restantes en tu periodo de facturacion actual

Respuestas de Error

Estado	Descripcion
`401`	No autorizado -- clave API faltante o invalida
`429`	Limite de tasa o uso excedido para tu plan
`502`	Error del upstream -- reintentar despues de un breve retraso
`503`	Upstream no disponible -- reintentar mas tarde

Consulta Errores para la referencia completa de errores y mejores practicas de reintento.

Relacionados

Inicio Rapido -- obtener tu clave API y hacer tu primera solicitud
API de Google Search -- buscar en Google con datos SERP estructurados
YouTube API -- buscar videos y extraer metadatos
API de Amazon -- buscar productos de Amazon en 12 marketplaces
Limites de Tasa -- limites por nivel de plan