YepAPI
Walmart API

Walmart Search API

Walmart Search API — search Walmart products by keyword and get prices, ratings, sellers, sponsored flags, and stock as JSON. Sort, price and delivery filters, ZIP targeting. $0.01 per call.

Pricing, live playground and use cases: Walmart Search API on YepAPI

POST/v1/walmart/search
$0.01/call

The Walmart Search API returns the Walmart search results page for any keyword as structured JSON — about 40–60 products per page, each with title, price, sale price, rating, review count, seller, image, sponsored flag, and stock status. Sort by best match, price, or best sellers, filter by price range and delivery speed, and localize prices and availability with a ZIP code or store ID.

For the full product page — specs, images, variants, and fulfillment details — pass a result's id to the Walmart Product API.

Usage

const res = await fetch('https://api.yepapi.com/v1/walmart/search', {
  method: 'POST',
  headers: {
    'x-api-key': 'YOUR_API_KEY',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({ query: 'air fryer', sort: 'best_seller', max_price: 100 }),
});
const { data } = await res.json();
console.log(data.products);
curl -X POST https://api.yepapi.com/v1/walmart/search \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query": "air fryer", "sort": "best_seller", "max_price": 100}'
import requests

res = requests.post(
    "https://api.yepapi.com/v1/walmart/search",
    headers={"x-api-key": "YOUR_API_KEY"},
    json={"query": "air fryer", "sort": "best_seller", "max_price": 100},
)
print(res.json()["data"]["products"])

Request Body

ParameterTypeRequiredDescriptionDefault
querystringYesSearch keywords (max 200 characters)—
pagenumberNoResults page, 1–251
sortstringNoOne of: best_match, price_low, price_high, best_sellerbest_match
min_pricenumberNoMinimum price in whole USD—
max_pricenumberNoMaximum price in whole USD—
deliverystringNoDelivery-speed filter. One of: today, tomorrow, 2_days, anytimeanytime
zipstringNo5-digit US ZIP code — localizes prices, stock, and fulfillment—
store_idstringNoNumeric Walmart store ID—

Response

{
  "ok": true,
  "data": {
    "query": "air fryer",
    "page": 1,
    "count": 59,
    "location": {
      "city": "Lake Point",
      "state": "UT",
      "zip": "84074",
      "store_id": "1440"
    },
    "products": [
      {
        "position": 1,
        "id": "14678059894",
        "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",
        "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=180&odnWidth=180&odnBg=FFFFFF",
        "price": 64.97,
        "currency": "USD",
        "rating": 4.6,
        "rating_count": 13359,
        "seller_id": "F55CDC31AB754BB68FE0B39041159D63",
        "seller_name": "Walmart.com",
        "sponsored": true,
        "out_of_stock": false,
        "fulfillment": {
          "delivery": false,
          "free_shipping": false,
          "pickup": false,
          "shipping": false
        },
        "variants": [],
        "section": "Results for \"air fryer\""
      },
      {
        "position": 2,
        "id": "3469548303",
        "title": "Chefman 12 Qt. Air Fryer 5 Functions w/ Integrated Smart Thermometer, 28 Presets, Black",
        "url": "https://www.walmart.com/ip/Chefman-12-Qt-Air-Fryer-5-Functions-w-Integrated-Smart-Thermometer-28-Presets-Black/3469548303",
        "image": "https://i5.walmartimages.com/seo/Chefman-12-Qt-Air-Fryer-5-Functions-w-Integrated-Smart-Thermometer-28-Presets-Black_d14da98a-29c8-4155-abf7-0a915de33dd2.27649cb1666286c40ecc62541364d6e0.jpeg?odnHeight=180&odnWidth=180&odnBg=FFFFFF",
        "price": 109,
        "currency": "USD",
        "rating": 4.5,
        "rating_count": 5556,
        "seller_id": "F55CDC31AB754BB68FE0B39041159D63",
        "seller_name": "Walmart.com",
        "sponsored": true,
        "out_of_stock": false,
        "fulfillment": {
          "delivery": false,
          "free_shipping": false,
          "pickup": false,
          "shipping": false
        },
        "variants": [],
        "section": "Results for \"air fryer\""
      }
    ]
  }
}

Response Fields

FieldTypeDescription
okbooleanWhether the request succeeded
data.querystringThe search query
data.pagenumberThe page returned
data.countnumberNumber of products on this page
data.locationobject | nullLocation Walmart used for prices and stock: city, state, zip, store_id
data.productsobject[]Products in the order Walmart shows them
data.products[].positionnumberPosition on the page, starting at 1
data.products[].idstringWalmart item ID — pass it to /v1/walmart/product
data.products[].titlestringProduct title
data.products[].urlstringProduct page URL on walmart.com (tracking parameters removed)
data.products[].imagestringProduct thumbnail URL
data.products[].pricenumberCurrent price
data.products[].price_strikethroughnumberPrevious / list price — only present when the item is on rollback or sale
data.products[].currencystringCurrency code, USD
data.products[].ratingnumberAverage star rating, 0–5
data.products[].rating_countnumberNumber of ratings
data.products[].seller_idstringWalmart seller ID
data.products[].seller_namestringSeller name (Walmart.com for first-party items)
data.products[].sponsoredbooleanPaid (sponsored) placement
data.products[].out_of_stockbooleanWhether the item is out of stock
data.products[].fulfillmentobjectAvailability flags: delivery, pickup, shipping, free_shipping
data.products[].variantsarrayVariant options shown on the result card (often empty)
data.products[].sectionstring | nullResults section the product appeared in, e.g. Results for "air fryer"

Fields Walmart does not show for a product are omitted from that product.

Pagination

Send the same request with page set to 2, 3, … up to 25. Each page is a separate $0.01 call.

Caching

Results are cached for 30 minutes per query and filter set.

Errors

StatusCodeWhen
400VALIDATION_ERRORquery is missing or over 200 characters; page is outside 1–25; sort or delivery is invalid; min_price is above max_price; zip is not 5 digits; store_id is not numeric
404NOT_FOUNDNo Walmart results for this query
429RATE_LIMITED_UPSTREAMToo many requests in flight — retry in a few seconds
502UPSTREAM_ERRORTemporary problem fetching data from Walmart — retry
503UPSTREAM_TIMEOUTWalmart took too long to respond — retry

Failed calls are not charged.

Overview

Walmart API for developers — search Walmart products and get product details, prices, stock, ratings, sellers, and fulfillment as JSON. A Walmart scraper API with no setup, $0.01 per call.

Product Details

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.

On this page

UsageRequest BodyResponseResponse FieldsPaginationCachingErrorsRelated Endpoints