50M products · 6-hour freshness

Walmart API — Product Data for 50 Million Items

Programmatic access to the largest non-Amazon US retail catalog. Title, price, sellers, 90-day history, sales rank, and reviews on every item. 1,000 free calls per month, no card.

Try:

1,000 people search Google every month for "walmart api" — $6.43 average CPC.

What the Walmart API returns

Walmart operates two official APIs: the Marketplace API (first-party sellers only) and the Affiliate API (approved publishers only). Neither is open to general developers. retailerapi closes that gap with a single REST endpoint, no eligibility check, and a 1,000 call free tier.

Every product response includes 14 structured fields. The 4 always-present fields are item_id, title, brand, and current_price. The 4 commonly-present fields are image_url, buy_box_seller, category, and gtin. The 3 conditional fields are sales_rank, mpn, and price_history. The 2 enrichment arrays are seller listings (up to 25 per product) and cross_retailer cells (6 US retailers).

The pipeline polls public Walmart product pages every 6 hours, captures 1.8 million daily price changes, and aggregates into per-item daily lows, highs, and averages. Marketplace seller data refreshes hourly during business hours. Sales rank refreshes daily. Reviews refresh weekly. All cache is per-item, so a popular item refreshes every 6 hours regardless of how many people query it.

Quick start

# Product
curl https://api.retailerapi.com/v1/products/19667262713 \
  -H "Authorization: Bearer rk_live_..."

# 90-day price history
curl "https://api.retailerapi.com/v1/products/19667262713/history?timeframe=90d&retailer=walmart" \
  -H "Authorization: Bearer rk_live_..."

# Reviews
curl https://api.retailerapi.com/v1/products/19667262713/reviews \
  -H "Authorization: Bearer rk_live_..."

# Seller profile
curl https://api.retailerapi.com/v1/sellers/101001 \
  -H "Authorization: Bearer rk_live_..."

Walmart API vs official APIs

FeatureretailerapiWalmart Marketplace APIWalmart Affiliate API
EligibilityAny developerActive sellerApproved publisher
Free tier1,000 calls / moNoneNone
Catalog accessAll 50M itemsYour listings onlyAffiliate-eligible items
Price history90 to 387 daysNoNo
Cross-retailer dataYes, 5 chainsNoNo
MCP serverYesNoNo

Frequently asked questions

Is there an official Walmart API?

Walmart operates two official APIs: the Walmart Marketplace API for first-party sellers and the Walmart Affiliate API for content publishers. Both have strict eligibility requirements (active seller account or approved affiliate). retailerapi is an unofficial third-party API that exposes the same Walmart catalog data with no eligibility check and a free tier.

How does retailerapi get Walmart data?

The data pipeline polls the public Walmart product catalog every 6 hours, captures price + seller + availability observations, and stores them in a 50 million row database. Walmart Marketplace API and Walmart Affiliate API supplement specific endpoints where they offer richer data than the public catalog.

How is the Walmart API priced?

Free tier: 1,000 calls per month, 5 calls per minute. Starter: $49 for 864,000 calls. Growth: $119 for 2.59 million calls. Pro: $429 for 10.8 million calls. Scale: $1,399 for 43.2 million calls. Each call returns the full product object (no per-field charging).

What is the response shape for the Walmart API?

Each /v1/products/{item_id} returns 14 fields: item_id, title, brand, image_url, current_price, currency, in_stock, seller_count, buy_box_seller, category, gtin, mpn, sales_rank, and the optional price_history + cross_retailer arrays. Field-level JSON Schema is published at api.retailerapi.com/openapi-gpt-actions.json.

Can I get Walmart marketplace seller data?

Yes. GET /v1/sellers/{seller_id} returns the seller name, marketplace ID, total listings count, average rating, and country. POST /v1/sellers/search filters sellers by name, country, rating, or listing count. Filters and exports are documented at docs.retailerapi.com.