Spaces:
Sleeping
Download README.md from bugrahans/walmart-scraper: direct link, hf CLI and curl.
- Browser
- Download file 3.35 kB
-
https://huggingface.co/spaces/bugrahans/walmart-scraper/resolve/main/README.md
- Command line
-
hf download hf://spaces/bugrahans/walmart-scraper/README.md
-
curl -L -o README.md https://huggingface.co/spaces/bugrahans/walmart-scraper/resolve/main/README.md
A newer version of the Gradio SDK is available: 6.32.0
title: Walmart Scraper
short_description: Walmart products, details and price-by-ZIP as CSV/JSON
emoji: 🛒
colorFrom: blue
colorTo: yellow
sdk: gradio
sdk_version: 6.0.2
app_file: app.py
pinned: false
tags:
- walmart
- walmart-scraper
- walmart-api
- price-monitoring
- price-comparison
- ecommerce
- retail
- product-data
- web-scraping
- scraper
- data-extraction
- smolagents
- tool
- scrape.do
Walmart Scraper — Powered by Scrape.do
Walmart prices and stock change from store to store. This Space ties every request to a real store, picked by ZIP code or store number, so the numbers match what a shopper there would see.
🔑 Get your free API token
👉 Sign up free on Scrape.do — 1,000 free credits per month, no credit card required. Every Walmart call costs 10 credits and failed calls are free, so that's about 100 calls.
Three tabs
| Tab | Input | Output |
|---|---|---|
| Search products | A keyword + your store | Product cards with price, sale price, rating, stock, pickup/delivery; a table and a CSV |
| Product details | A Walmart link, item id or product name | Price and savings, stock, seller, images, highlights, specifications, UPC/GTIN, model number, description |
| Compare prices by ZIP | A product + up to 5 ZIP codes | The same product's price and stock at each store, with the cheapest highlighted and a CSV |
Any product from the search results can be sent to the other two tabs with one click.
What you can paste
- a Walmart product link (
walmart.com/ip/...) - the numeric item id, e.g.
17221971947 - just the product name, e.g.
great value whole milk gallon(costs one extra search to find it)
For the store, use a 5-digit US ZIP code (Walmart picks the nearest store) or a
Walmart store number such as 3520.
Why an API instead of scraping walmart.com directly
Walmart sits behind aggressive bot protection, and its prices depend on store cookies that are tedious to manage. This Space uses the Scrape.do Walmart API, which handles the proxies, the bot checks and the store session, and returns clean JSON.
Use as a smolagents Tool
from smolagents import CodeAgent, InferenceClientModel
from tool import ScrapeDoWalmartTool
agent = CodeAgent(
tools=[ScrapeDoWalmartTool(api_token="YOUR_SCRAPEDO_TOKEN")],
model=InferenceClientModel(),
)
agent.run("Find the cheapest gallon of whole milk at the Walmart nearest ZIP 60074, then compare its price in Dallas and Los Angeles.")
You can also set SCRAPE_DO_API_TOKEN in your environment and instantiate
ScrapeDoWalmartTool() with no arguments.
Inputs
mode(required) —search,productorcompare.query(required) — Forsearch: the keyword. Forproductandcompare: a Walmart product link, item id or product name.location(optional) — A 5-digit US ZIP code or Walmart store number. Forcompare, a comma-separated list of up to 5. Defaults to07094(Secaucus, NJ), or four cities across the US forcompare.
Learn more at scrape.do · Documentation · Walmart scraping guide