Walmart API

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.

POST/v1/run/walmart.search
可用率
99.71%
30d · 2,063 次调用
请求数
2,063
30d · 按周,近 12 周
响应时间
3.4s
中位数 · 30d

价格与服务商

Walmart 搜索 API 价格:一个 API,2 个可互换的服务商

最便宜的服务商优先响应。如果它失败,下一个会在同一次调用中接手。

你需支付
US$9.00
US$0.90/千次请求,只为实际用量付费。没有月度套餐。
有了 US$0.10 的初始余额,你的前 111 次请求免费。

试一试

一个请求获取 Walmart 搜索

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.
打开于
获取免费密钥
示例响应
免费运行只返回前 3 条结果。为密钥充值即可获得完整响应。
{
  "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 请求体。显示的值只是示例,请换成你自己的。

响应

JSON,每个字段一个示例值。

each itemdata.items[]

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.

datadata

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.

top level
  • 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 次调用。

费用:每千次请求 US$0.90 起,以美元计价,无需订阅,也没有每月最低消费。你只需为一个美元钱包充值,每次调用从中扣费。部分由钱包付费的失败请求会产生处理费用,我们按成本原价转嫁,不加价;错误响应会显示收取的金额。

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.响应是统一格式的 JSON,外层结构与每个 AnyAPI 接口相同,所以解析另一个接口只需换一个 URL,别的都不用改。

过去 30 天,通过 AnyAPI 发起的 Walmart 搜索 API 调用中有 99.7% 成功,响应时间中位数为 3.4 秒,共测量 2,063 次调用。这些是 AnyAPI 对经过网关的流量的自有测量,持续重新计算,并非公开承诺的服务等级目标。

可以。新的 AnyAPI 账户自带 US$0.10 免费余额,无需绑卡,足够调用 111 次 Walmart 搜索,每次 US$0.0009。

AnyAPI 会在同一个请求中依次尝试它的 2 个数据源,从最便宜的开始,所以一个数据源宕机不会让你的调用失败。

向 https://api.getanyapi.com/v1/run/walmart.search 发送 POST 请求,在 “Authorization: Bearer” 请求头中放入你的 AnyAPI 密钥,并以 JSON 请求体传入参数。同一个密钥和同一个钱包适用于所有 AnyAPI 接口。

不需要。你向一个预付费的 AnyAPI 余额充值美元,每个请求从中扣费。没有月度套餐,也没有最低消费,同一个余额可用于所有 AnyAPI 接口。

有。TypeScript 用 npm 安装 @getanyapi/sdk,Python 用 pip 安装 getanyapi。两者都用同一个密钥调用所有 AnyAPI 接口,任何 HTTP 客户端也都可以。

可以。智能体可以连接 https://api.getanyapi.com/mcp 上的 AnyAPI MCP 服务器,或者向 https://api.getanyapi.com/agent/signup 发送一次无需认证的 POST 来创建自己的免费试用密钥,再通过 HTTP 调用这个接口。