# Walmart 评价 API (walmart.reviews)

- Canonical page: https://everyinfra.com/walmart-api/reviews
- Endpoint: POST https://api.everyinfra.com/api/v1/social with {"platform": "walmart", "action": "reviews", "params": {...}}
- Price: $0.001389 per call ($1.39 per 1,000 requests); failed calls and empty results are not charged
- Returns: list, default 40, max 300 per call
- Mode: sync; add "mode": "async" for slow tasks

## Health

- Live health (24h percent, hourly and daily trends): https://api.everyinfra.com/api/v1/social/availability?platform=walmart&action=reviews

## Parameters

| name | type | required | default | description |
|---|---|---|---|---|
| url | not declared | yes | not declared | profile / reviews / product_detail 的 walmart.com/ip/ 商品链接。profile 与 product_detail 都是商品资料，不是买家账号；reviews 读取该商品评论。 |
| limit | integer (1–300) | no | 40 | 这次调用最多返回的条数，整数，1–300；不传按默认值，实际返回可能少于这个数。超过上限会在扣费前返回 422。 |

## Response fields (items in `results`)

| field | meaning |
|---|---|
| review_id | 评价 ID。 |
| title | 标题。平台无标题概念时（如纯文本帖）为 null。 |
| text | 正文内容，已去除 HTML 标签，全文返回、不截断（个别平台的列表结果本身只有摘要，以该平台的字段说明为准）。 |
| rating | 评分。**分制随平台而异**，同一行的 `rating_scale` 给出该平台满分 (多数是 5，Booking/豆瓣/爱奇艺/NAVER 是 10)。跨平台比较前必须先按 rating_scale 换算。直接比数字会得出反的结论。 |
| rating_scale | 上一列 `rating` 的满分。5 表示五星制、10 表示十分制。只在该行有 rating 时出现。 |
| 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 | 商品名称。 |
| seller_name | 卖家名称（Walmart 也有第三方卖家）。 |
| product_rating | 商品评分，5 分制。 |
| product_review_count | 商品评价数。 |
| platform | 数据来源平台标识，与请求里的 platform 一致（如 xiaohongshu、tiktok）。 |
| images | 图片链接数组，按平台展示顺序；没有图片时不出现这个字段。 |

## Example

```bash
curl -X POST 'https://api.everyinfra.com/api/v1/social' \
  -H "Authorization: Bearer $EVERYINFRA_API_KEY" \
  -H 'Content-Type: application/json' \
  --data-raw '{
  "platform": "walmart",
  "action": "reviews",
  "params": {
    "url": "https://www.walmart.com/ip/Apple-AirPods-Pro-2nd-Generation/1752657021"
  }
}'
```

```python
import os
import requests

response = requests.post(
    "https://api.everyinfra.com/api/v1/social",
    headers={"Authorization": f"Bearer {os.environ['EVERYINFRA_API_KEY']}"},
    json={
        "platform": "walmart",
        "action": "reviews",
        "params": {
            "url": "https://www.walmart.com/ip/Apple-AirPods-Pro-2nd-Generation/1752657021",
        },
    },
    timeout=120,
)
print(response.status_code)
print(response.json())
```

## Response example

Real response to the example request above, captured 2026-09-26T08:56:04Z. `results` and `count` are real with personal information (names, handles, avatars, profile links, contact details) removed; the list keeps the first 2 of 40. `id`, `billing` and `quota` differ on every call, so only their shape is shown.

```text
{
  "id": "req_…",
  "platform": "walmart",
  "action": "reviews",
  "results": [
    {
      "review_id": "•••",
      "title": "Great Airpods",
      "text": "i love these airpods, amazing noise cancellation and bass for music. There’s a XS earbud tip and they fit better in my smaller ears. but they’re kinda identical to the 1st generation, so unless you want to have slightly better, slightly fancier airpods then these are your go to. …",
      "rating": 5,
      "posted_at": "2023-01-24",
      "helpful_count": 3,
      "negative_count": 0,
      "is_recommended": false,
      "is_verified_purchase": true,
      "product_id": "1752657021",
      "product_name": "Apple AirPods Pro 2 White In Ear Headphones MQD83AM/A",
      "product_rating": 4.6,
      "product_review_count": 11634,
      "platform": "walmart",
      "rating_scale": 5
    },
    {
      "review_id": "•••",
      "title": "Best gift I've ever bought myself",
      "text": "Every other set of headphones I've tried hurt within an hour. I can wear these all day. I have inner ear issues, and using these while playing music or even just background noise helps so much. They also motivate me to clean and do other tasks around the house more often because …",
      "rating": 5,
      "posted_at": "2023-07-30",
      "helpful_count": 3,
      "negative_count": 0,
      "is_recommended": true,
      "is_verified_purchase": true,
      "product_id": "1752657021",
      "product_name": "Apple AirPods Pro 2 White In Ear Headphones MQD83AM/A",
      "product_rating": 4.6,
      "product_review_count": 11634,
      "platform": "walmart",
      "rating_scale": 5
    }
  ],
  "count": 40,
  "billing": {
    "charged": …,
    "charged_usd": …,
    "balance_after_usd": …,
    …
  },
  "quota": { … }
}
```

## Also

- Capability catalog (no key): https://api.everyinfra.com/api/v1/social/catalog?platform=walmart
- OpenAPI: https://everyinfra.com/openapi.json · Agents guide: https://everyinfra.com/agents.md