We have just added the Walmart API to YepAPI and shipped a round of upgrades to the web scraping endpoints. `/v1/walmart/search` returns the full Walmart.com results page for any keyword, and `/v1/walmart/product` returns any item's price, stock, seller, UPC, specs, variants, and delivery options, both localized by ZIP code and both $0.01 per call. On the scraping side, `/v1/scrape` now escalates on its own until a page loads, the browser tiers can click, scroll, and fill forms before capture, screenshots can target a single element, and AI extraction can return exactly the fields you define.
What's new
- Walmart Search API: 40–60 products per page with price, rollback price, rating, seller, sponsored flag, stock, and fulfillment; sort, price, and delivery-speed filters
- Walmart Product API: look up any item by id or URL for price, stock, UPC, SKU, seller, specifications, variants, images, and delivery, pickup, and shipping details
- Both Walmart endpoints accept a US ZIP code or store id for local prices and stock, at $0.01 per call
- Smart mode on /v1/scrape: starts with the fastest fetch and escalates to JS rendering and premium proxies automatically, same $0.01 price
- Browser actions on /v1/scrape/js and /v1/scrape/stealth: click, scroll, fill, wait for elements, infinite scroll, and evaluate JavaScript, plus mobile rendering, ad blocking, and stealth proxy country
- Element screenshots via a CSS selector, and schema-typed AI extraction that returns exactly the fields you define
Walmart API
Walmart's own developer APIs are built for sellers, suppliers, and approved affiliates, and need an account plus signed requests. The YepAPI Walmart API returns public Walmart.com product data with one key and no approval. Search returns every product on the results page with its position, and product returns one item's full record. Search results are cached for 30 minutes and product data for 6 hours. Searches with no results and products that do not exist return a 404 and are free. US walmart.com only.
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":"price_low","zip":"84074"}'
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/14678059894"}'Smart mode on /v1/scrape
The standard scrape endpoint now tries the cheapest fetch first and automatically escalates, first to JavaScript rendering and then to premium residential proxies, until the page loads. You pay the same flat $0.01 whichever path it takes. If a site still blocks the request, you get a 502 UPSTREAM_ERROR suggesting /v1/scrape/stealth, and the call is free.
Browser actions, waits, and device options
The JavaScript and stealth tiers accept new options for driving the browser before the page is captured:
- `js_scenario`: a list of steps such as `{"click":"#load-more"}`, `{"scroll_y":1000}`, `{"fill":["#q","shoes"]}`, `{"wait_for_and_click":".tab"}`, `{"evaluate":"document.title"}`, and `{"infinite_scroll":{...}}` (JS tier only). Evaluate results come back in `evaluateResults`, with a per-step `jsScenarioReport`.
- `wait_for_selector`: capture as soon as an element appears; `wait_for` (milliseconds, up to 15,000) works on every tier.
- `device: "mobile"` and `block_ads: true` on the browser tiers, and `country` (any 2-letter code) on stealth.
- `selector` now accepts CSS or XPath and returns the first matching element: its HTML with format html, otherwise its text.
Element screenshots and typed AI extraction
`/v1/scrape/screenshot` takes an optional CSS `selector` to capture just one element, such as a chart or pricing table. `/v1/scrape/ai-extract` takes an optional `schema`, either a JSON Schema or a flat `{"field": "description"}` map, and returns an object with exactly those fields, typed when the schema says so. With a prompt alone, ask for JSON and you get JSON back.
Docs fix: the real scrape response
Our scraping docs and product pages previously showed `data.markdown`, `data.title`, and `data.metadata` fields that the API never returned. The real response is `url`, `statusCode`, `content`, and `format`, plus `evaluateResults` and `jsScenarioReport` when you send browser actions. Docs, examples, and product pages now match.
Pricing
Both Walmart endpoints cost $0.01 per call. Scraping prices are unchanged: $0.01 for /v1/scrape (including smart-mode escalation), $0.02 for /v1/scrape/js and screenshots, and $0.03 for stealth and AI extraction. Failed calls are free, there is no monthly minimum, and new accounts start with $5 of free credit.
Try the Walmart API
Open the hub, pick an endpoint, and run a live call against real Walmart data.
Explore the Walmart API