电商数据 · 数据 API

Walmart

Walmart API

围绕 Walmart 美国商城整理商品详情与买家评论,核对商品编号、价格币种、卖家名称及已验证购买标记,为商品比较和反馈阅读提供数据。 调用 POST /api/v1/social ;返回结构化 JSON,$1.39 / 千次;失败不计费。

4

个能力

$1.39 / 千次

能力价格

同步

调用模式

1 个

一把 Key 通用 89 个平台

Walmart 能力清单

action必填参数可选参数单次条数模式单价返回字段
searchkeywordlang—同步$1.39 / 千次item_id · name · url · brand · price · was_price · currency · rating · rating_scale · review_count · in_stock · availability · seller_name · category · condition · upc · image_url · platform
profileurllang—同步$1.39 / 千次item_id · name · url · brand · price · was_price · currency · rating · rating_scale · review_count · in_stock · availability · seller_name · category · condition · upc · image_url · platform · description · highlights · images · return_policy · is_returnable · badges
reviewsurl—默认 40 · 最多 300同步$1.39 / 千次review_id · title · text · rating · rating_scale · posted_at · author_name · helpful_count · negative_count · is_recommended · is_verified_purchase · product_id · product_name · seller_name · product_rating · product_review_count · platform · images
product_detailurl——同步$1.39 / 千次id · url · name · text · brand · price · original_price · currency · in_stock · rating · rating_scale · review_count · seller_name · category · image_url · platform

Walmart 每个接口分别做什么

下面逐个解释 action、必填参数、可选筛选项和允许值。 请求都发到 POST /api/v1/social, 切换 action 时,也要按对应接口调整参数。 同名参数在不同平台、不同接口中可能指向不同对象;请以该条说明中的格式和适用范围为准。

下方只展示平台官方资料,用于核对对象与术语,不表示平台对 EveryInfra 的授权或背书。 本接口接受的参数、字段与能力边界以各条说明为准,不与平台官方 API 直接等同。

怎么调用 Walmart 主页或对象详情 API?

profile

使用 platform="walmart"、action="profile" 调用“主页或对象详情”能力;返回单个对象,主要包含 item_id、name、url、brand、price、was_price 等 24 个字段。

Walmart profile 的参数分别是什么意思?

url必填
profile / reviews / product_detail 的 walmart.com/ip/ 商品链接。profile 与 product_detail 都是商品资料,不是买家账号;reviews 读取该商品评论。

Walmart 的字段说明区分 Item ID、卖家 SKU 和 UPC;Item ID 可在商品页面 URL 末尾找到。这里只解释标识,不表示本接口能下载卖家后台报表。官方来源:Walmart:Item ID、SKU 与商品链接来源核查:

lang可选
search / profile 的展示语言:en 英语、fr 法语,默认 en;不切换美国商城到加拿大,也不是评论语言过滤。
查看全部 2 个允许值

enfr

Walmart 特有返回字段与含义(8)
item_id
商品 ID。
brand
品牌。
upc
商品条码(UPC)。跨平台比价时用它做同款匹配最准。
was_price
此前售价(划线价)。
in_stock
是否有货。
availability
库存状态。
condition
成色。
seller_name
卖家名称(Walmart 也有第三方卖家)。

怎么调用 Walmart 评价 API?

reviews

使用 platform="walmart"、action="reviews" 调用“评价”能力;返回列表,默认 40 条、单次最多 300 条,主要包含 review_id、title、text、rating、rating_scale、posted_at 等 18 个字段。

Walmart reviews 的参数分别是什么意思?

url必填
profile / reviews / product_detail 的 walmart.com/ip/ 商品链接。profile 与 product_detail 都是商品资料,不是买家账号;reviews 读取该商品评论。

Walmart 的字段说明区分 Item ID、卖家 SKU 和 UPC;Item ID 可在商品页面 URL 末尾找到。这里只解释标识,不表示本接口能下载卖家后台报表。官方来源:Walmart:Item ID、SKU 与商品链接来源核查:

Walmart 特有返回字段与含义(10)
seller_name
卖家名称(Walmart 也有第三方卖家)。
product_id
产品 ID。
product_name
商品名称。
product_rating
商品评分,5 分制。
product_review_count
商品评价数。
review_id
评价 ID。
is_verified_purchase
是否为已验证购买。
is_recommended
评价人是否推荐该商品。
helpful_count
评价被标有用次数。
negative_count
评价被标无用次数。

怎么调用 Walmart 商品详情 API?

product_detail

使用 platform="walmart"、action="product_detail" 调用“商品详情”能力;返回单个对象,主要包含 id、url、name、text、brand、price 等 16 个字段。

Walmart product_detail 的参数分别是什么意思?

url必填
profile / reviews / product_detail 的 walmart.com/ip/ 商品链接。profile 与 product_detail 都是商品资料,不是买家账号;reviews 读取该商品评论。

Walmart 的字段说明区分 Item ID、卖家 SKU 和 UPC;Item ID 可在商品页面 URL 末尾找到。这里只解释标识,不表示本接口能下载卖家后台报表。官方来源:Walmart:Item ID、SKU 与商品链接来源核查:

Walmart 特有返回字段与含义(4)
brand
品牌。
in_stock
是否有货。
seller_name
卖家名称(Walmart 也有第三方卖家)。
original_price
原价。
Walmart search 调用流程一次 Walmart search 调用的全过程:向 POST /api/v1/social 发送 platform="walmart"、action="search",以及必填参数 keyword;返回结构化 JSON,含 item_id、name、url、brand、price 等字段;返回列表,计费 $1.39 / 千次,失败与空结果不计费。1 · 请求POST /api/v1/socialplatform: "walmart"action: "search"keywordEveryInfra$1.39 / 千次2 · 响应 · 列表item_idnameurlbrandprice
一次 Walmart search 调用的全过程:向 POST /api/v1/social 发送 platform="walmart"、action="search",以及必填参数 keyword;返回结构化 JSON,含 item_id、name、url、brand、price 等字段;返回列表,计费 $1.39 / 千次,失败与空结果不计费。

Walmart 原始字段名

EveryInfra 统一字段名

左边是 Walmart 数据里原本的字段名,右边是我们统一后的。点任意一行看对应关系。89 个平台复用通用字段命名,减少重复适配; 切换平台仍需核对参数、字段集合、类型与空值含义。这里展示映射关系,不是目标的实时返回数据。

Walmart 的独有字段名(当前目录)

全站 89 个平台的当前目录中,这 7 个字段名只在 Walmart 出现。 这是字段命名的分布,不代表其他平台没有同类信息,也不保证每次响应都含这些字段;具体含义和返回条件仍需逐接口核对。

  • was_price
  • upc
  • return_policy
  • is_returnable
  • badges
  • negative_count
  • product_review_count

返回字段含义

通用字段采用统一命名;切换平台时仍需核对目标格式、字段是否存在、类型、空值与平台特有含义。 机器可读版:/api/v1/social/fields

item_id
商品 ID。
name
名称。用于账号/商品/商家类能力,指该对象本身的名字。
url
该记录在原平台上的可访问链接。
brand
品牌。
price
价格数值,不含货币符号;币种见 currency。
was_price
此前售价(划线价)。
currency
价格币种代码(如 CNY、USD)。price 存在但 currency 为 null 时不要假定币种。
rating
评分。分制随平台而异,同一行的 rating_scale 给出该平台满分 (多数是 5,Booking/豆瓣/爱奇艺/NAVER 是 10)。跨平台比较前必须先按 rating_scale 换算 —— 直接比数字会得出反的结论。
rating_scale
上一列 rating 的满分。5 表示五星制、10 表示十分制。只在该行有 rating 时出现。
review_count
评价条数,用于商品/商家类能力。null 表示不公开,不等于 0。
in_stock
是否有货。
availability
库存状态。
seller_name
卖家名称(Walmart 也有第三方卖家)。
category
分类名称,取值为原平台的分类体系,未做跨平台归一。
condition
成色。
upc
商品条码(UPC)。跨平台比价时用它做同款匹配最准。
image_url
图片链接。多图能力可能返回 image_urls 数组。
platform
数据来源平台标识,与请求里的 platform 一致(如 xiaohongshu、tiktok)。
description
简介或描述,通常比 text 短。
review_id
评价 ID。
title
标题。平台无标题概念时(如纯文本帖)为 null。
text
正文内容,已去除 HTML 标签。长文可能被截断。
posted_at
发布时间,ISO 8601 格式、UTC 时区(如 2026-08-07T12:34:56+00:00)。平台只给非标准字符串时原样透传,解析前建议做容错。null 表示平台未公开。
author_name
作者昵称(显示名)。
helpful_count
评价被标有用次数。
negative_count
评价被标无用次数。
is_recommended
评价人是否推荐该商品。
is_verified_purchase
是否为已验证购买。
product_id
产品 ID。
product_name
商品名称。
product_rating
商品评分,5 分制。
product_review_count
商品评价数。
id
该记录在原平台上的唯一标识。仅在同一平台内唯一,跨平台可能重复。
original_price
原价。

当前目录另列出 highlights · images · return_policy · is_returnable · badges,这些字段尚无逐项释义;请先核对 Walmart 对应接口的用例与实际响应,不按字段名猜测类型或含义。

请求填写示例

这里检索商品;价格筛选针对商品,不是 API 消费上限。

以下为填写格式示意,并非成功调用记录。请替换 API Key 和尖括号中的目标,确认可选筛选项后再调用;示例不保证目标当前有数据。

walmart_search.sh
curl -X POST https://api.everyinfra.com/api/v1/social \
  -H "Authorization: Bearer omg_你的KEY" \
  -H "Content-Type: application/json" \
  -d '{"platform":"walmart","action":"search","params":{"keyword":"air purifier"}}'

记录字段预览(非真实响应)

仅展示 search 的记录字段,不包含外层响应、计费或任务状态。null 只作展示占位,不表示字段类型或实际空值;完整响应须以接口文档与实际调用为准。

fields.preview.json
{
  "item_id": null,
  "name": null,
  "url": null,
  "brand": null,
  "price": null,
  "was_price": null,
  "currency": null,
  "rating": null,
  "rating_scale": null,
  "review_count": null,
  "in_stock": null,
  "availability": null,
  "seller_name": null,
  "category": null,
  "condition": null,
  "upc": null,
  "image_url": null,
  "platform": null
}

常见用例

以下是基于现有接口的接入思路,不是开箱即用的分析或告警功能。字段以实际返回为准,缺失值不按零处理。

在 Walmart 美国商城发现同类商品

按商品词搜索候选,再比较商品标识、卖家与价格。

查看 search 的 lang 参数 →
  • keyword 不是门店地址,结合 item_id、name、seller_name、price 和 currency 核对;lang 只选择展示语言。
  • 当前主路径固定美国商城且读取一页;不能把 lang=fr 理解为切换加拿大商城,也不提供附近门店实时库存。

按 Walmart 商品链接核对公开状态

用 profile 读取单品价格与状态,区分平台商品编号和条码。

查看 profile 的 url 参数 →
  • url 使用 walmart.com/ip/ 商品链接,结合 item_id、upc、availability、in_stock 和 review_count 核对。
  • item_id 不是 UPC,也不是卖家自编 SKU;in_stock 是状态而非库存件数,不代表已经为你预留商品。

整理 Walmart 商品评论与购买标记

用 reviews 分析实际取得的评价,保留购买标记和日期的不确定性。

查看 reviews 的 url 参数 →
  • url 定位商品,结合 review_id、text、rating、posted_at 与 is_verified_purchase 归档;product_review_count 是商品汇总数量。
  • 购买标记缺失不等于未购买;posted_at 可能保留无法转换的原始日期文本,评论结果也不保证按最新时间排序。

读取 Walmart 单品描述与卖家信息

用 product_detail 保存指定商品资料,按该接口自己的字段解析。

查看 product_detail 的 url 参数 →
  • url 指向具体商品,结合 id、name、text、price、currency 与 seller_name;这里使用 id/text,不是 profile 的 item_id。
  • in_stock 可能是状态字符串或布尔值,不直接按布尔值强转;当前路径不展开全部商品变体,也不承诺每个卖家的所有报价。

Walmart API 常见问题

Walmart API 怎么调用?

调用 POST /api/v1/social,请求体传 platform="walmart"、action 和 params。以 search 为例,必填 keyword,可选 lang。这里检索商品;价格筛选针对商品,不是 API 消费上限。 Walmart 共 4 个 action,鉴权用 Authorization: Bearer <API Key>,同一把 Key 通 89 个平台。

Walmart API 怎么收费?

$1.39 / 千次,Walmart 全部 4 个能力同价。按本页最高能力单价、每次单目标估算,$1 免费额度约可用于 719 次 Walmart 调用。费用按所选能力与目标数量计算,多目标请求不要按单目标估算;参数错误、鉴权失败和空结果不计费。

Walmart API 一次能返回多少条数据?

Walmart 有 2 个列表接口,包括 search、reviews。其余 2 个接口返回单个对象;对象内仍可能包含数组。数量参数要逐接口区分目标数、页数和记录数,不能将目录数值直接当作保证返回的条数;具体限制见对应参数与用例,不保证完整历史。

Walmart API 返回哪些字段?

当前目录为 search 列出 item_id、name、url、brand、price、was_price 等 18 个字段名。按全站当前目录统计,7 个字段名只在 Walmart 出现;这不表示其他平台没有同类信息。字段不保证每次齐全,嵌套位置、类型与空值须按各接口说明核对,同名字段不代表语义可互换。

「在 Walmart 美国商城发现同类商品」怎样接入 Walmart API?

按商品词搜索候选,再比较商品标识、卖家与价格。 keyword 不是门店地址,结合 item_id、name、seller_name、price 和 currency 核对;lang 只选择展示语言。 当前主路径固定美国商城且读取一页;不能把 lang=fr 理解为切换加拿大商城,也不提供附近门店实时库存。

「按 Walmart 商品链接核对公开状态」怎样接入 Walmart API?

用 profile 读取单品价格与状态,区分平台商品编号和条码。 url 使用 walmart.com/ip/ 商品链接,结合 item_id、upc、availability、in_stock 和 review_count 核对。 item_id 不是 UPC,也不是卖家自编 SKU;in_stock 是状态而非库存件数,不代表已经为你预留商品。

「整理 Walmart 商品评论与购买标记」怎样接入 Walmart API?

用 reviews 分析实际取得的评价,保留购买标记和日期的不确定性。 url 定位商品,结合 review_id、text、rating、posted_at 与 is_verified_purchase 归档;product_review_count 是商品汇总数量。 购买标记缺失不等于未购买;posted_at 可能保留无法转换的原始日期文本,评论结果也不保证按最新时间排序。

「读取 Walmart 单品描述与卖家信息」怎样接入 Walmart API?

用 product_detail 保存指定商品资料,按该接口自己的字段解析。 url 指向具体商品,结合 id、name、text、price、currency 与 seller_name;这里使用 id/text,不是 profile 的 item_id。 in_stock 可能是状态字符串或布尔值,不直接按布尔值强转;当前路径不展开全部商品变体,也不承诺每个卖家的所有报价。

可以先免费试用 Walmart API 吗?

可以。注册免费,加微信领邀请码可得 $1 免费额度(≈720 次数据调用)。请先选择 Walmart 的目标接口,用单目标请求核对结果;实际可调用次数取决于能力价格与目标数量,不保证覆盖全部 4 个能力。无需信用卡。

开始调用 Walmart API

加微信领 $1 免费额度,先选一个 Walmart 接口验证结果。实际可调用次数取决于能力价格与目标数量。

免费开始