Track Walmart products and read their price history from your code with the REST API, or from your AI assistant with the MCP server. One API key works for both, and for the Chrome extension.
Every request carries your personal API key as a Bearer token. Create one key per tool or script in your dashboard: the key is shown once, and revoking it stops it right away. Keep keys on your server, never in browser code.
Header
Authorization: Bearer YOUR_API_KEY
Base URL: https://www.waltrack.dev/api/v1. Requests and responses are JSON. A missing or invalid key returns 401 with the code unauthorized.
Endpoints
Parameters, responses and code samples for each endpoint are in the API reference, where you can also try requests with your key.
Every product answer has the same fields: see the Product model in the API reference. Here are the values two of them can take.
last_error
Code
Meaning
email_not_verified
The account's email isn't confirmed yet, so it has no credits; the check runs as soon as it is.
insufficient_credits
The last check was skipped for lack of credits; it's retried every 6 hours.
store_unavailable
Walmart couldn't be read at the last check (refunded); retried within 30 minutes.
product_not_found
The item ID has no page on Walmart (refunded).
Marketplaces
marketplace
Store
Currency
com
walmart.com (United States)
USD
Product states
Checks run in the background, so a product's fields tell where it stands. Test them in this order: the first match is the state the app and the extension show as a badge.
States
State
When
What to do
Checking
checking is true
A check is due or running. Poll GET /products/{id} every few seconds, or pass wait.
Paused
status is "paused"
Not checked, not charged. PATCH paused: false to resume.
Confirm your email
last_error is "email_not_verified"
The free credits come with the email confirmation; checks start right after it.
Waiting for credits
last_error is "insufficient_credits"
The balance is empty; the check runs again by itself once credits are added (manage_url).
Not found on Walmart
last_error is "product_not_found"
No page for this item ID on Walmart (refunded).
Retrying soon
last_error is "store_unavailable"
Walmart couldn't be read (refunded). Retried automatically; nothing to do.
Queued
last_checked_at is null
Added, first check not done yet.
Out of stock
in_stock is false
Checked, but no offer: price is null. With alert_on_drop, the owner gets an email when it's back.
In stock
in_stock is true
Checked, with an offer at price (in currency).
filter on GET /products and list_products
filter
Products
all
Every tracked product (default).
drops
Cheaper now than when the product was added.
target
At or below its target price.
out_of_stock
No offer at the last check.
attention
The last check didn't go through (last_error is set): no credits, not found or Walmart unavailable.
paused
Paused by you: not checked, not charged.
Recipes
Common integrations, in JavaScript (Node 18+). The first one defines api(method, path, body), a small fetch wrapper the others reuse. Keep the key on your server.
Track a product and get its price in one call
wait: true answers once the first check is done (up to 45 seconds). If it took longer, checking is still true: read the product again a bit later.
JavaScript
async function api(method, path, body) {
const res = await fetch(`https://www.waltrack.dev/api/v1${path}`, {
method,
headers: {
Authorization: `Bearer ${process.env.WALTRACK_API_KEY}`,
"Content-Type": "application/json",
},
body: body && JSON.stringify(body),
});
const data = await res.json();
if (!res.ok) throw new Error(`${data.error.code}: ${data.error.message}`);
return data;
}
const product = await api("POST", "/products", { product: "https://www.walmart.com/ip/5129929197", wait: true });
console.log(product.title, product.price, product.currency);
Send a daily digest of price drops
The filter parameter gives the same lists as the app's tabs. Run this once a day: it reads your watchlist, nothing is charged.
filter=attention lists the products whose last check didn't go through. Only waiting for credits and not found need an action; Walmart errors retry by themselves.
Errors use the HTTP status and a JSON body with a stable code to branch on, and a message to show or log.
403 Forbidden
{
"error": {
"code": "product_limit",
"message": "You've reached your plan's product limit. The free plan tracks up to 50 products."
}
}
Error codes
HTTP
Code
When
400
invalid_product
product is neither a Walmart item ID (the number at the end of a walmart.com/ip/ link) nor a Walmart product link, or item_id isn't a Walmart item ID (the number at the end of a walmart.com/ip/ link).
400
unsupported_marketplace
The link is from a Walmart site other than walmart.com.
400
invalid_option
A setting isn't valid: marketplace (com), filter, interval_minutes (5, 30, 60, 360, 720, 1440), target_price, alert_on_drop or paused. Also when the body isn't a JSON object, a required argument is missing, or the product to check is paused.
401
unauthorized
The API key is missing, revoked or invalid.
402
insufficient_credits
Reading Walmart now costs 1 credit and the balance is empty.
402
email_not_verified
The account's email isn't confirmed yet, so it has no credits to read Walmart with.
403
paid_option
Checks faster than daily need a plan or a credit pack: every 60 minutes with a pack or Starter, 30 with Pro, 5 with Business.
403
product_limit
The account tracks as many products as its plan allows (50 on the free plan).
404
not_found
No tracked product with this id on your account, or no such endpoint.
404
product_not_found
Walmart has no product for this item ID. Refunded.
405
method_not_allowed
The endpoint doesn't take this HTTP method; the Allow header lists the ones it does.
429
rate_limited
More than 30 searches or 600 history reads in an hour, too many reads of Walmart at once, or too many different products read today: 200 a day on the free plan, 1,000 with a credit pack, then 1,000 with Starter, 3,000 with Pro, 10,000 with Business. Histories and new watchlist entries count, once per product; your watchlist and the products already read today stay available. Retry later, or after midnight UTC for the daily limit.
500
generic
Unexpected error on our side. Retry in a moment.
502
store_unavailable
Walmart couldn't be read right now (GET /search). Nothing is charged; retry in a moment.
Billing & limits
Each price check of a tracked product costs 1 credit; a product checked daily uses about 30 credits a month. The first check, when a product is added, counts too. A check that fails on Walmart's side is refunded and retried.
Without credits, checks pause (nothing is charged) and resume once credits are back. The product's last_error is then insufficient_credits.
The free plan tracks 50 products, checked daily (interval_minutes 1440). A credit pack or a plan unlocks more products. Checks faster than daily need a plan or a credit pack: every 60 minutes with a pack or Starter, 30 with Pro, 5 with Business. Accepted values: 5, 30, 60, 360, 720, 1440.
Searching Walmart (GET /search) is free, limited to 30 searches per hour per account. The history of any item ID (GET /history) is free too, limited to 600 reads per hour. 429 beyond.
MCP server
The MCP server lets Claude, ChatGPT, Cursor or any MCP client track products and read price histories for you. It uses Streamable HTTP with stateless JSON responses at https://www.waltrack.dev/api/mcp. Clients that support OAuth, like Claude and ChatGPT, only need this URL: you sign in and allow them once. Others take an API key in the Authorization header, or ?key= for clients that only accept a URL. Your dashboard has one-click setups for each client.
Current plan, remaining credits and how many products are tracked. Each price check of a tracked product costs 1 credit; a product checked daily uses about 30 credits a month.
Search Walmart by keywords to find products and their item ID, with the price, rating and reviews shown in the results. Free, limited to 30 searches per hour.
Add a Walmart product (item ID, link or short link) to the watchlist and check its price now (waits up to 45 seconds for the check). Each price check of a tracked product costs 1 credit; a product checked daily uses about 30 credits a month. Returns the current price; checking is still true if the check took longer, then read it later with get_price_history.
the tracked product: product_id, title, price, currency, lowest_price…
list_productsRead-only
The watchlist, newest first, with each product's latest price, lowest and highest price and recent trend. Use filter for questions like "what dropped?" (drops), "what reached my target?" (target), "what's out of stock?" (out_of_stock) or "anything wrong?" (attention).
Arguments
item_id?, marketplace?, filter?, page?, limit?
Returns
products (each with trend), total, page
get_price_historyRead-only
A tracked product with every price read of the period, oldest first, including reads made before it was added (created_at says when). A history of more than 5000 points is thinned evenly, keeping its first and last point. At most 2 price histories per request.
Arguments
product_id, days?
Returns
the product and history: price, in_stock, coupon, seller, checked_at
get_item_historyRead-only
Every price Waltrack read for an item ID on a marketplace, tracked by the user or not, with the lowest, highest and average of those prices. A history of more than 5000 points is thinned evenly, keeping its first and last point. Free and instant: nothing is read from Walmart, so an item ID nobody tracked yet has an empty history. Use it to judge a price before tracking. At most 2 price histories per request.
Set a target price, drop alerts, the check interval or pause a tracked product. Send only what changes. Checks faster than daily need a plan or a credit pack: every 60 minutes with a pack or Starter, 30 with Pro, 5 with Business.
Read the product's price on Walmart right away (1 credit), at most once per 5 minutes; earlier calls return it unchanged. A paused product has to be resumed first. Waits up to 45 seconds for the check. Read last_error if the check didn't go through.
Arguments
product_id
Returns
the product with its latest price
untrack_productDeletes data
Remove a product from the watchlist, with its price history.
Arguments
product_id
Returns
deleted, product_id
Arguments and results use the same names as the REST API, so the product object and states apply as-is. A failed tool call returns its message with the error code in parentheses, e.g. (product_limit).
Try asking
Track this for me and tell me when it drops under $50: https://www.walmart.com/ip/5129929197
Which of my products are cheaper than when I added them?
Show the price history of the AirPods over the last 3 months.
Anything out of stock or broken on my watchlist?
Check the PS5 price on walmart.com now.
Start tracking
Create an account, confirm your email and get 1500 free credits to try the API.