Walmart 搜索 API
Search Walmart by keyword with optional sort, price-range, facet, and page filters and get title, price, rating, seller, and availability for each product in one normalized response.
价格与服务商
Walmart 搜索 API 价格:一个 API,2 个可互换的服务商
最便宜的服务商优先响应。如果它失败,下一个会在同一次调用中接手。
试一试
一个请求获取 Walmart 搜索
{
"data": {
"items": [
{
"availability": "example",
"brand": "Acme Inc",
"currency": "USD",
"image": "https://example.com/image.jpg",
"inStock": true,
"isSponsored": true,
"itemId": "a1b2c3d4",
"listPrice": 19.99,
"position": 1,
"price": 19.99,
"rating": 4.6,
"reviewsCount": 12500,
"sellerId": "a1b2c3d4",
"sellerName": "Example title",
"title": "Example title",
"url": "https://example.com/page"
}
],
"totalPages": 12500,
"totalResults": 12500
},
"found": true,
"reason": "not_found"
}完整的参数与响应参考:这个接口的每个字段、类型和示例。
参考
一个请求,一种响应结构。
你发送的每个字段和收到的每个字段,都附有真实示例。
最近验证于 2026-11-21 · 可用率和延迟按 30d 统计
请求体
JSON,POST 到这个接口。
- querystring
airpods
Search keywords, e.g. "airpods" or "paper towels".
- facetstring
Optional Walmart facet filter token, e.g. brand:HP to keep only HP products.
- maxPricenumber
Optional maximum product price in USD.
- minPricenumber
Optional minimum product price in USD.
- pageinteger
1-based results page of about 40 to 60 products; Walmart serves no products past page 10. Each page is billed as one request. Walmart re-ranks between requests, so consecutive pages can repeat a product: deduplicate on itemId.
- requireFieldsarray
Optional; omit it and routing is unchanged, with the cheapest source serving. Name the output fields this request must be able to return, for example `totalPages`, and it is served only by a source that returns every one of them. Fields you do not name are still returned whenever the serving source has them. This can raise your price: when the cheapest source cannot return a named field, a dearer source serves, and you are quoted and charged its price. Naming a combination that no single source returns together is refused as invalid input, with no charge.
- sortenum
best_seller
Result sort order; omit for Walmart's Best Match (e.g. price_low sorts by lowest price first).
响应
JSON,每个字段一个示例值。
Matching Walmart product records for the requested page. Populated whenever the provider has data for the entity.
- availabilitystring
Stock status as Walmart reports it, e.g. "IN_STOCK" or "OUT_OF_STOCK".
- brandstring
Brand name, or null when Walmart omits it from the search grid (it publishes brand on clothing-style grids and on no row elsewhere; the Walmart Product SKU always carries it).
- currencystring
Price currency code, e.g. "USD"; empty when no price is shown.
- imagestring
Primary product image URL. Populated whenever the provider has data for the entity.
- inStockboolean
True when the product is in stock, false when it is not, or null when not reported.
- isSponsoredboolean
True when the result is a sponsored placement.
- itemIdstring
Walmart US item id (usItemId), the number in a walmart.com/ip/ URL; use the product URL with the Walmart Product or Walmart Reviews SKU. Populated whenever the provider has data for the entity.
- listPricenumber
Pre-discount "was" price when the product is on sale, or null when it is not discounted.
- positioninteger
1-based position of the result in this page.
- pricenumber
Current price in USD as a number, or null when the result shows no current price. Populated whenever the provider has data for the entity.
- ratingnumber
Average customer rating, 0-5, or null when the product is unrated.
- reviewsCountinteger
Number of customer ratings, or null when the product has none.
- sellerIdstring
Identifier of the seller fulfilling the shown offer.
- sellerNamestring
Name of the seller fulfilling the shown offer.
- titlestring
Product title. Populated whenever the provider has data for the entity.
- urlstring
Walmart product page URL with tracking query parameters removed. Populated whenever the provider has data for the entity.
Search result wrapper, or null when nothing matched.
- totalPagesinteger可设为必填
Highest page number available for the query; request pages 1 through this value. Absent or null when the serving source does not report it.
- totalResultsinteger
Total number of matching products Walmart reports for the query, or null when not reported.
- foundboolean
True when the search returned at least one product.
- reason"not_found"
Present only when `found` is false, and says why there is no result. `not_found`: the source states the target does not exist, or returned nothing for it. A `found: false` answer is a successful call, not an error, and `costUsd` is what it actually cost.
常见问题
关于 Walmart 搜索 API
AnyAPI 的 Walmart 搜索 API 只需一次 POST 请求 /v1/run/walmart.search,就以统一格式的 JSON 返回 Walmart 数据。Search Walmart by keyword with optional sort, price-range, facet, and page filters and get title, price, rating, seller, and availability for each product in one normalized response.AnyAPI 会在 2 个数据源之间路由每个请求,某个数据源失败时自动切换。费用:每千次请求 US$0.90 起,以美元计价,无需订阅,也没有每月最低消费。过去 30 天,通过 AnyAPI 发起的 Walmart 搜索 API 调用中有 99.7% 成功,响应时间中位数为 3.4 秒,共测量 2,063 次调用。