API 文档

BASE URLhttps://redfox.hk

暂无可用的 API 平台

Walmart商品评论

最低 ¥0.2/次起即将上线

通过productId获取评论（正文、星级、作者、日期、有用票、验证购买、配图，默认附带情感/问题标签）

单价随接口累计调用量阶梯调整

POSThttps://redfox.hk/story/api/walmart/reviews

API 密钥获取与配置

获取密钥

调用 API 前，请先在控制台生成 API 密钥并完成配置。在 HTTP 请求头中添加API Key 字段，密钥用于身份校验与额度计费。

获取步骤

前往控制台页面，进入 API 密钥管理模块。
若无已生成的密钥，点击生成新密钥，复制并妥善保存密钥。
在请求头中添加 REDFOX_API_KEY或X-API-KEY字段并填入密钥后即可调用。

API说明

Method：POST

Host：https://redfox.hk

Path：/story/api/walmart/reviews

请求头

名称	类型	必填	说明	示例
REDFOX_API_KEY	string	是	平台鉴权令牌，每次请求必填	ak_xxxxxx
Content-Type	string	是	请求体数据类型	application/json

请求参数

参数	类型	必填	说明	示例
productId	string	是	商品ID（必填，商品URL结尾的数字，如17835006350；字母目录id如34J2GQ9D9TFM亦可）从search接口结果的productId字段获取	5689919121
country	string	否	站点国家码（非必填，默认US）可选：US（walmart.com）、CA（walmart.ca）；product id 分站点不可跨用	US
limit	integer	否	每页评论数（非必填，1~50，默认10）	50
page	integer	否	分页页码（非必填）
sort	string	否	排序方式（非必填，仅做筛选非严格排序，需要顺序时自行排序）
rating	integer	否	按星级筛选（非必填，精确匹配单个星值）
label	string	否	附加智能标签（非必填），例如 label=reports
judgments	string	否	是否关闭默认情感/问题标签（非必填）传 off 返回不带 computed.labels 的精简评论页；默认开启（不额外计费）
cursor	string	否	分页cursor（非必填）从上一次响应的paginationToken获取，用于翻页

返回值与结构

统一包装一般为 `code`、`message`/`msg`、`data`（以实际服务为准）。

响应字段

字段	类型	说明	示例
code	integer	业务状态码，2000表示成功	2000
msg	string	状态描述	成功
data	object
count	integer	本次返回的评价数量，数值型	50
hasMore	boolean	是否还有更多评价，布尔型	true
items	array	评价列表
helpfulVotes	integer	有用票数，数值型	0
images	array	无晒图，空数组
issueConfidence	number	问题标签置信度（0-1），数值型，可能为null	0.58
issueLabel	string	问题标签=产品缺陷	none
isVerified	boolean	是否已验证购买	true
productId	string	所属商品ID，字符串型	5689919121
publishedAt	string	评价发布时间，ISO 8601 UTC格式字符串	2025-05-21T00:00:00.000Z
ratingMax	integer	评分上限，数值型	5
ratingMismatch	boolean	评分与情感是否背离（如高分但负面文本），布尔型，可能为null	false
ratingValue	integer	低分差评	5
reviewerAvatar	null	评价人头像URL，通常为null
reviewerLocation	null	评价人所在地，通常为null
reviewerName	string	评价人昵称（anonymous=匿名）	Beatrice
reviewerUrl	null	评价人主页URL，通常为null
reviewId	string	评价ID，字符串型	386200357
sentimentConfidence	number	情感判定置信度（0-1），数值型	0.75
sentimentLevel	integer	情感等级低（负面）	4
sentimentScore	number	情感得分低	0.93
text	string	评价正文，可能为null	Great Air pods best version that's out in my opinion...
title	string	标题为null	Air Pods Pro Soft Foam Earbuds
url	null	评价详情URL，通常为null
paginationToken	string	翻页游标（sc.前缀Base64编码），下一页请求时回传	sc.eyJ2IjoyLCJjIjoiMiIsImUiOiJ3YWxtYXJ0L3Jldmlld3MiLCJwIjoicGFnZSJ9
total	integer	评价总数，数值型（上游计数不可靠，不能作分页依据，翻页须翻到空页为止）	7518

请求示例

{
    "productId": "5689919121",
    "country": "US",
    "limit": 50,
    "judgments": null
}

响应示例

{
  "code": 2000,
  "msg": "成功",
  "data": {
    "count": 50,
    "hasMore": true,
    "total": 7518,
    "items": [
      {
        "reviewId": "386200357",
        "productId": "5689919121",
        "title": "Air Pods Pro Soft Foam Earbuds",
        "text": "Great Air pods best version that's out in my opinion...",
        "ratingValue": 5,
        "ratingMax": 5,
        "publishedAt": "2025-05-21T00:00:00.000Z",
        "reviewerName": "Beatrice",
        "reviewerAvatar": null,
        "reviewerLocation": null,
        "reviewerUrl": null,
        "isVerified": true,
        "helpfulVotes": 0,
        "images": [
          "https://i5.walmartimages.com/dfw/6e29e393-5855/k2-_298854c9-84d7-4ccb-9198-2b207f143a8b.v1.jpg",
          "https://i5.walmartimages.com/dfw/6e29e393-de38/k2-_aeb70a1b-8d73-4ac7-b513-130bd87ccfd1.v1.jpg"
        ],
        "url": null,
        "sentimentLevel": 4,
        "sentimentScore": 0.93,
        "sentimentConfidence": 0.75,
        "ratingMismatch": false,
        "issueLabel": "none",
        "issueConfidence": 0.58
      },
      {
        "reviewId": "444599334",
        "productId": "5689919121",
        "title": null,
        "text": "not working good, i think manufacturing defect, showing warranty coverage the date i open and connected",
        "ratingValue": 1,
        "ratingMax": 5,
        "publishedAt": "2026-10-17T00:00:00.000Z",
        "reviewerName": "Mihir",
        "reviewerAvatar": null,
        "reviewerLocation": null,
        "reviewerUrl": null,
        "isVerified": true,
        "helpfulVotes": 0,
        "images": [],
        "url": null,
        "sentimentLevel": 1,
        "sentimentScore": 0.15,
        "sentimentConfidence": 0.67,
        "ratingMismatch": false,
        "issueLabel": "product_defect",
        "issueConfidence": 1
      }
    ],
    "paginationToken": "sc.eyJ2IjoyLCJjIjoiMiIsImUiOiJ3YWxtYXJ0L3Jldmlld3MiLCJwIjoicGFnZSJ9"
  }
}

常见状态码说明

调用接口时，响应体中的 code 字段对应以下状态码。完整列表请查看 API 状态码说明页。

状态码	说明	排查建议
`400`	请求参数错误	检查请求体、Query 参数是否与文档一致，必填项是否齐全。
`401`	鉴权失败	确认请求头已添加 REDFOX_API_KEY 或 X-API-KEY，且密钥有效、未禁用。
`403`	无权限访问	当前密钥或账号无权调用该接口，请检查密钥状态与接口权限。
`500`	系统内部错误	服务端异常，请稍后重试；持续出现请联系技术支持。
`503`	服务暂不可用	服务维护或短暂过载，请间隔一段时间后重试。
`1001`	缺少必要参数	对照「请求参数」表，补全必填字段。
`1002`	参数格式不正确	检查字段类型与格式（如 URL、日期、枚举值）是否符合说明。
`1003`	参数类型错误	确认 JSON 中数字、字符串、布尔等类型与文档定义一致。
`3103`	密钥不存在	密钥可能已删除或填写错误，请前往控制台核对并重新复制。
`3105`	API Key 已禁用	在控制台启用该密钥，或创建新密钥后替换请求头中的值。
`3201`	积分不足	账户余额不足以支付本次调用，请前往控制台充值后再试。
`3202`	积分账户不存在	账号积分账户异常，请登录控制台确认账户状态。
`4004`	操作过于频繁，请稍后再试	触发频率限制，降低请求频率或增加调用间隔后重试。

调用步骤

在请求头配置REDFOX_API_KEY或X-API-KEY
按 API 说明示例构造请求参数或请求体。
发起请求。
解析 JSON 响应中的 code、message 与 data 字段。

Request（示例代码，仅供参考）

bash

curl -X POST "https://redfox.hk/story/api/walmart/reviews" \
  -H "REDFOX_API_KEY: your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
  "productId": "5689919121",
  "country": "US",
  "limit": 50,
  "page": "",
  "sort": "",
  "rating": "",
  "label": "",
  "judgments": "",
  "cursor": ""
}'

Response（示例代码，仅供参考）

json

{
  "code": 2000,
  "msg": "成功",
  "data": {
    "count": 50,
    "hasMore": true,
    "total": 7518,
    "items": [
      {
        "reviewId": "386200357",
        "productId": "5689919121",
        "title": "Air Pods Pro Soft Foam Earbuds",
        "text": "Great Air pods best version that's out in my opinion...",
        "ratingValue": 5,
        "ratingMax": 5,
        "publishedAt": "2025-05-21T00:00:00.000Z",
        "reviewerName": "Beatrice",
        "reviewerAvatar": null,
        "reviewerLocation": null,
        "reviewerUrl": null,
        "isVerified": true,
        "helpfulVotes": 0,
        "images": [
          "https://i5.walmartimages.com/dfw/6e29e393-5855/k2-_298854c9-84d7-4ccb-9198-2b207f143a8b.v1.jpg",
          "https://i5.walmartimages.com/dfw/6e29e393-de38/k2-_aeb70a1b-8d73-4ac7-b513-130bd87ccfd1.v1.jpg"
        ],
        "url": null,
        "sentimentLevel": 4,
        "sentimentScore": 0.93,
        "sentimentConfidence": 0.75,
        "ratingMismatch": false,
        "issueLabel": "none",
        "issueConfidence": 0.58
      },
      {
        "reviewId": "444599334",
        "productId": "5689919121",
        "title": null,
        "text": "not working good, i think manufacturing defect, showing warranty coverage the date i open and connected",
        "ratingValue": 1,
        "ratingMax": 5,
        "publishedAt": "2026-10-17T00:00:00.000Z",
        "reviewerName": "Mihir",
        "reviewerAvatar": null,
        "reviewerLocation": null,
        "reviewerUrl": null,
        "isVerified": true,
        "helpfulVotes": 0,
        "images": [],
        "url": null,
        "sentimentLevel": 1,
        "sentimentScore": 0.15,
        "sentimentConfidence": 0.67,
        "ratingMismatch": false,
        "issueLabel": "product_defect",
        "issueConfidence": 1
      }
    ],
    "paginationToken": "sc.eyJ2IjoyLCJjIjoiMiIsImUiOiJ3YWxtYXJ0L3Jldmlld3MiLCJwIjoicGFnZSJ9"
  }
}