---
title: "Walmart"
description: "通过统一的商品平台结构提供 Walmart 美国站的数据。价格为 USD。"
---

## 操作

| 操作 | 端点 | 返回 | 价格 |
|---|---|---|---|
| [Search](/docs/api-reference/walmart/search) | `GET \| POST /v1/walmart/search` | `SearchResult` | $0.001 |
| [Browse](/docs/api-reference/walmart/browse) | `GET \| POST /v1/walmart/browse` | `SearchResult` | $0.001 |
| [Categories](/docs/api-reference/walmart/categories) | `GET \| POST /v1/walmart/categories` | `CategoryList` | $0.001 |
| [Product](/docs/api-reference/walmart/product) | `GET \| POST /v1/walmart/product` | `Product` | $0.001 |
| [Reviews](/docs/api-reference/walmart/reviews) | `GET \| POST /v1/walmart/reviews` | `ReviewPage` | $0.001 |

没有 `image-search`：Walmart 不提供以图搜索。

包括 `reviews` 在内，全部五个操作均按每次调用一次计费。

## 实际会返回什么

**搜索条目**

| 字段 | 填充率 |
|---|---|
| `title` `url` | 100% |
| `price` `imageUrl` `seller.name` | ~85% |
| `delivery` | ~80% |
| `badges` | ~35% |

**商品**

| 字段 | 填充率 |
|---|---|
| `title` | 100% |
| `price` `media.images` `attributes` | ~90% |
| `brand` `rating.average` `seller.name` `description` `category` | ~85% |
| `brandUrl` `returnsPolicy` | ~80% |
| `reviews` | ~70% |
| `reviewAspects` | ~50% |

**评价**

| 字段 | 填充率 |
|---|---|
| `rating` | 100% |
| `id` `date` `author` `helpfulCount` | ~85% |

搜索中 `price` 不是 100%，是因为 Walmart 第三方卖家的商品有时显示的是价格区间而不是单一价格。`badges`
偏低，是因为大多数商品根本没有徽章。

Walmart 是这里仅有的两个返回 `reviewAspects` 的平台之一（另一个是 Amazon），并且它提供
`returnsPolicy` 和 `brandUrl` 比其他任何平台都更稳定。

## 筛选栏

每次 Walmart 搜索都会返回 `facets`——该站点针对此查询自带的筛选分组——而且分面是免费的。一次袜子搜索就带有
25 个分组：Price、Brand 和 Customer Rating 对应到有类型的参数，其余的（Sock Rise、Sleeve Length、
Fabric Material、Colour……）只能通过 `facets` 使用。参见
[筛选](/docs/api-reference/marketplaces/filters#facets--the-marketplaces-own-filter-rail)。

## Walmart 特有之处

**变体不能单独获取。** 尺码和颜色是同一个商品内的 SKU，因此没有 `variant.productId`。

**Walmart 自营与第三方卖家都会出现。** 用 `seller.name` 区分；Walmart 履约的商品与第三方商品的配送承诺不同。

**食品杂货商品带有 `unitPrice`。** 只有 Walmart 和 Amazon 会标明每计量单位的价格，这是比较 12 件装与
24 件装的唯一方法。