Walmart API
Four modes over one of the largest US retail catalogues. Search returns products with price, was-price, rating and both ids you need downstream; product adds UPC, manufacturer number and the full rating breakdown; reviews returns the customer review text; sellers lists every marketplace offer on a listing with price, availability, delivery date and return policy. The sellers mode is the reliability wedge, since competing tools fail on it most.
Input parameters
| PARAMETER | TYPE | REQ | DEFAULT | DESCRIPTION |
|---|---|---|---|---|
| search_mode | enum | yes | search | search finds products and returns both ids; product returns full detail; reviews returns customer reviews; sellers lists every offer on a listing. |
| query | string | no | — | Required in search mode. A keyword such as 'laptop' or 'coffee maker'. |
| item_id | string | no | — | Required for product, reviews and sellers. The modes need different ids and every search row gives you both: product and sellers take the alphanumeric productId, reviews takes the all-digits usItemId. |
| store_id | string | no | — | Sellers mode only. Pricing and availability are store specific; copy the storeId from a search row to scope the offers. |
| max_results | integer | no | 100 | Rows to return before stopping. Search returns up to 50 products per upstream call, reviews 20, and paging is automatic. — drives your bill |
Worked examples
{
"search_mode": "search",
"query": "coffee maker",
"max_results": 20
}
{
"search_mode": "sellers",
"item_id": "34X621REEQZQ",
"store_id": "1932"
}
{
"search_mode": "product",
"item_id": "34X621REEQZQ"
}
{
"search_mode": "reviews",
"item_id": "414173778",
"max_results": 100
}
Coverage
n8n templates
Free n8n workflows that run this source. Import one, add your Apify token, and it runs on a schedule.
Code
curl
curl -X POST "https://api.apify.com/v2/acts/johnvc~walmart-api/run-sync-get-dataset-items" \
-H "Authorization: Bearer $APIFY_TOKEN" \
-H "Content-Type: application/json" \
-d '{"search_mode":"search","query":"coffee maker","max_results":20}'
Python
from apify_client import ApifyClient
client = ApifyClient("APIFY_TOKEN")
run = client.actor("johnvc/walmart-api").call(
run_input={"search_mode": "search", "query": "coffee maker", "max_results": 20}
)
for product in client.dataset(run.default_dataset_id).iterate_items():
print(product.get("title"), product.get("price"), product.get("sellerName"), product.get("productId"))
MCP
Apify's hosted MCP server loads this source from the URL below as the tool johnvc--walmart-api. Sign in to Apify when your client asks (OAuth), or send an Apify token as an Authorization: Bearer header.
https://mcp.apify.com/?tools=johnvc/walmart-api
What people use it for
- Price tracking and price history for a product set
- Buy-box and third-party seller monitoring
- Competitor assortment and catalogue mapping
- UPC and manufacturer number lookups for catalogue matching
- Review analysis for a product category
More sources for Product and price intelligence, Competitor and market monitoring, Reviews and reputation monitoring →
Alternatives
Questions people ask
How can I track Walmart prices with the Walmart API?
Run search mode with a keyword such as coffee maker to get products with price, was-price, rating and both ids, then repeat on a schedule to build a price history for a product set. Prices are point-in-time and store specific.
How do I look up a UPC with the Walmart API?
Use product mode with the alphanumeric productId from a search row. It returns the full listing with UPC, manufacturer number, category path, variants and the full rating breakdown, for catalogue matching.
Can the Walmart API list every seller offer on a listing?
Yes. Sellers mode lists every marketplace offer on a listing with price, availability, delivery date and return policy, 17 seller fields in all. It takes the alphanumeric productId and a store_id copied from a search row, since pricing and availability are store specific.
How much does the Walmart API cost per product?
The default Product returned edition is 0.0009 USD per product, reviews are 0.0009 USD per review, and product detail lookups and seller offers are 0.018 USD each. There is also a free tier on Apify.
Which item id does each Walmart API mode need?
Every search row returns both ids. Product and sellers modes take the alphanumeric productId; reviews mode takes the all-digits usItemId. The API rejects a mismatch before making the request, so a wrong id does not burn a paid call.
How does the Walmart API differ from the Google Shopping API?
The Walmart API covers one retail catalogue in depth: search, full product detail with UPC, customer reviews and every marketplace seller offer. The Google Shopping API gives cross-retailer price comparison rather than one catalogue.