Catalog / Retail, marketplaces & classifieds
RETAIL, MARKETPLACES & CLASSIFIEDS · UNITED STATES
Walmart - Search Results & Product Details
Search Walmart.com by keyword or paste search, browse or product links.
About this data
Search Walmart.com by keyword or paste search, browse or product links. Each product becomes one row with price, was-price, seller, availability, rating, reviews and image; add full details for description, specs, images, variants and reviews. Failures are not charged.
From the actor’s Apify Store listing. The per-call endpoint may return a bounded subset; its own description is below.
Buy per call over x402
One endpoint at api.ssh.autos. Each call is one JSON POST, paid in USDC with no account or API key, and answered in the same HTTP response.
Walmart.com Search Results
POST /v1/us/walmart/products
Up to three product cards from the first Walmart.com search page: product IDs, name/link, price/currency, marketplace seller, availability, aggregate ratings/counts, images, category and delivery text where published.
No product-page expansion or individual review content.
Confirmed zero-count search pages return no records.
Input
Send a JSON body to POST https://api.ssh.autos/v1/us/walmart/products.
| Field | Type | Required | Notes |
|---|---|---|---|
query | string | required | 1–150 characters |
maxResults | integer | optional | 1–3; default 3 |
Returned fields
The answer is JSON: records, a list of up to 3, and summary, the run status and counts. Each record has these 39 fields; a field the source does not publish comes back null.
39 fields per record
| Field | Type | Notes |
|---|---|---|
usItemId | string | Walmart item id (the number at the end of the product link). |
url | string | Product page link without tracking parameters. |
source | string | search: from a search or link; product: from a product link. one of search, product |
searchInput | string | The search words, link or product link this row came from. |
detailLevel | string | full when the product page was read. one of listing, full |
name | string | — |
brand | string | Often empty on search results; filled from the product page. |
price | number | Current price. |
wasPrice | number | Crossed-out earlier price, when Walmart shows one. |
minPrice | number | Lowest option price for items with options. |
maxPrice | number | Highest option price for items with options. |
unitPrice | string | Price per unit as shown, for example "33.3 ¢/oz". |
currency | string | — |
isSponsored | boolean | Sponsored placement in the search results (null for product links). |
sellerName | string | — |
sellerId | string | — |
sellerRating | number | Marketplace seller's average rating (product page). |
sellerReviewCount | integer | — |
availability | string | IN_STOCK, OUT_OF_STOCK, ... |
inStock | boolean | — |
rating | number | Average customer rating (1-5). |
reviewCount | integer | — |
imageUrl | string | — |
images | array of strings | Up to 30 image links (all images with full details). |
category | string | Category path, for example "Home > Appliances > Kitchen Appliances". |
badges | array of strings | Badges such as Rollback, Best seller, Clearance. |
deliveryText | string | Shipping or pickup line from the search result. |
position | integer | Position in this search's results (1-based, duplicates removed). |
searchPage | integer | — |
highlights | array of objects | — |
specifications | array of objects | — |
variants | array of objects | — |
model | string | — |
upc | string | — |
ratingBreakdown | object | Number of reviews per star, keys "5" to "1". |
recommendedPercentage | number | — |
reviews | array of objects | Up to 10 recent reviews from the product page: rating, title, text, date, author, positiveFeedback, negativeFeedback. |
scrapedAt | string | — |
error | null | Always null in the dataset; failures are in the run summary. |
Example call
npx agentcash@latest fetch https://api.ssh.autos/v1/us/walmart/products -m POST -b '{"query": "air fryer", "maxResults": 2}'The example values come from the API spec or the actor’s own sample input. Running it is a paid call.
What is and isn’t charged
You pay the call price for
- An answer, including a definitive “not found” or an empty result.
- Confirmed no matches returns records: [] (charged: it is an answer).
Free
- Invalid input (422), busy (503), source failure (502), timeout (504) and calls whose client hung up are never charged.
- Invalid input and source failures are not charged.
Prefer a subscription? Run it on Apify
This data source is a public actor on the Apify Store: Walmart Scraper - Search Results & Product Details. Run it with your Apify account and plan for larger, scheduled or exported runs; it may offer more input options than the per-call endpoint.
How x402 payment works
- Your client sends the request. The API answers
402 Payment Requiredwith the price and where to pay. - The client pays from its own wallet: USDC on Base or Solana over x402, or over MPP on Tempo. No account, sign-up or API key.
- The client retries with the payment attached and gets the JSON answer in the same call. You are only charged for answers.
The AgentCash CLI in the example does all three steps for you and pays from your AgentCash wallet. Any x402 or MPP client works the same way.
Machine-readable: openapi.json · llms.txt