Walmart Product API Docs: Price, Stock & Specs by Item ID

Walmart Product API — get any Walmart product by item ID or URL with price, sale price, UPC, specs, images, variants, seller, stock, and delivery/pickup info as JSON. $0.01 per call.

POST/v1/walmart/product

$0.01/call

The Walmart Product API returns a Walmart product page as structured JSON: title, current price and strikethrough (rollback / sale) price, UPC, rating, images, full specifications, variants, seller, stock status, and delivery, pickup, and shipping availability. Pass the item ID or paste the walmart.com product URL. Add a zip or store_id to get the price and availability for a specific area or store — handy as a Walmart price API for price tracking and repricing.

Find item IDs with the Walmart Search API.

Usage

const res = await fetch('https://api.yepapi.com/v1/walmart/product', {
  method: 'POST',
  headers: {
    'x-api-key': 'YOUR_API_KEY',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({ product: '14678059894', zip: '84074' }),
});
const { data } = await res.json();
console.log(data.title, data.price, data.fulfillment);

curl -X POST https://api.yepapi.com/v1/walmart/product \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"product": "https://www.walmart.com/ip/Chefman-Air-Fryer-1500W-6-Quart-4-Functions-with-Touch-Controls-Stainless-Steel/14678059894"}'

import requests

res = requests.post(
    "https://api.yepapi.com/v1/walmart/product",
    headers={"x-api-key": "YOUR_API_KEY"},
    json={"product": "14678059894", "zip": "84074"},
)
print(res.json()["data"])

Request Body

Parameter	Type	Required	Description	Default
`product`	`string`	Yes	Walmart item ID (`14678059894`) or a product URL (`https://www.walmart.com/ip/<slug>/14678059894`)	—
`zip`	`string`	No	5-digit US ZIP code — localizes price, stock, and fulfillment	—
`store_id`	`string`	No	Numeric Walmart store ID	—

Response

{
  "ok": true,
  "data": {
    "id": "14678059894",
    "sku": "14678059894",
    "gtin": "810170920660",
    "title": "Chefman Air Fryer 1500W, 6 Quart, 4 Functions with Touch Controls, Stainless Steel",
    "url": "https://www.walmart.com/ip/Chefman-Air-Fryer-1500W-6-Quart-4-Functions-with-Touch-Controls-Stainless-Steel/14678059894",
    "price": 64.97,
    "price_strikethrough": null,
    "currency": "USD",
    "rating": 4.6,
    "rating_count": 13300,
    "image": "https://i5.walmartimages.com/seo/Chefman-Air-Fryer-1500W-6-Quart-4-Functions-with-Touch-Controls-Stainless-Steel_0ccae75c-daa2-4d52-a1d4-63b5f20f42c3.52b088aed447be6063d85850d455ebd5.jpeg?odnHeight=573&odnWidth=573&odnBg=FFFFFF",
    "images": [
      "https://i5.walmartimages.com/asr/6be8aefc-2525-4c51-8d0a-6d9fc5241427.2c00dbe92bdf832ea76c89e5dd3709b0.jpeg?odnHeight=117&odnWidth=117&odnBg=FFFFFF",
      "https://i5.walmartimages.com/asr/c509d374-ea53-457a-a894-dc14183f04d6.96ee957a6892ddc8841d2f0cfe16c3ce.jpeg?odnHeight=117&odnWidth=117&odnBg=FFFFFF"
    ],
    "out_of_stock": false,
    "seller_id": "F55CDC31AB754BB68FE0B39041159D63",
    "seller_name": "Walmart.com",
    "seller_url": null,
    "specifications": [
      { "key": "Brand", "value": "Chefman" },
      { "key": "Volume capacity", "value": "6 qt" },
      { "key": "Watts", "value": "1500 Watts" },
      { "key": "Model", "value": "RJ38-SS-6T" }
    ],
    "variants": [],
    "fulfillment": {
      "delivery": true,
      "pickup": true,
      "shipping": true,
      "free_shipping": false,
      "out_of_stock": false,
      "fulfilled_by": "",
      "delivery_information": "As soon as 2pm tomorrow",
      "pickup_information": "As soon as 2pm tomorrow Free",
      "shipping_information": "Arrives tomorrow Free"
    }
  }
}

Response Fields

Field	Type	Description
`ok`	`boolean`	Whether the request succeeded
`data.id`	`string`	Walmart item ID
`data.sku`	`string`	Walmart SKU / US item ID
`data.gtin`	`string`	GTIN / UPC barcode — use it to match the same product on other stores
`data.title`	`string`	Product title
`data.url`	`string`	Product page URL
`data.price`	`number`	Current price
`data.price_strikethrough`	`number \| null`	Previous / list price when the item is on rollback or sale, else `null`
`data.currency`	`string`	Currency code, `USD`
`data.rating`	`number`	Average star rating, 0–5
`data.rating_count`	`number`	Number of ratings
`data.image`	`string`	Main product image URL
`data.images`	`string[]`	All product image URLs
`data.out_of_stock`	`boolean`	Whether the item is out of stock
`data.seller_id`	`string`	Walmart seller ID
`data.seller_name`	`string`	Seller name (`Walmart.com` for first-party items)
`data.seller_url`	`string \| null`	Seller page URL, for marketplace sellers
`data.specifications`	`object[]`	Specification rows as `{ key, value }`
`data.variants`	`object[]`	Other variants (size, color…): `product_id`, `price` (`{ price, currency }`), and `selected_options[]` (`{ key, value }`)
`data.fulfillment.delivery`	`boolean`	Home delivery available
`data.fulfillment.pickup`	`boolean`	Store pickup available
`data.fulfillment.shipping`	`boolean`	Shipping available
`data.fulfillment.free_shipping`	`boolean`	Ships free
`data.fulfillment.out_of_stock`	`boolean`	Out of stock for this location
`data.fulfillment.fulfilled_by`	`string`	Who fulfils the order, when Walmart shows it (may be empty)
`data.fulfillment.delivery_information`	`string \| null`	Delivery promise as shown, e.g. `As soon as 2pm tomorrow`; `null` when empty
`data.fulfillment.pickup_information`	`string \| null`	Pickup promise, e.g. `As soon as 2pm tomorrow Free`; `null` when empty
`data.fulfillment.shipping_information`	`string \| null`	Shipping promise, e.g. `Arrives tomorrow Free` or `Out of stock`; `null` when empty

Caching

Product pages are cached for 6 hours per item and location.

Errors

Status	Code	When
`400`	`VALIDATION_ERROR`	`product` is missing or not a Walmart item ID / walmart.com URL; `zip` is not 5 digits; `store_id` is not numeric
`404`	`NOT_FOUND`	Walmart product not found
`429`	`RATE_LIMITED_UPSTREAM`	Too many requests in flight — retry in a few seconds
`502`	`UPSTREAM_ERROR`	Temporary problem fetching data from Walmart — retry
`503`	`UPSTREAM_TIMEOUT`	Walmart took too long to respond — retry

Failed calls are not charged.

Walmart Search API — find products and item IDs by keyword
Amazon Product API — the same details for Amazon ASINs
AI Scraping API — typed JSON from any other store's product page

Walmart Product API