# Walmart 关键词搜索 API (walmart.search)

- Canonical page: https://everyinfra.com/walmart-api/search
- Endpoint: POST https://api.everyinfra.com/api/v1/social with {"platform": "walmart", "action": "search", "params": {...}}
- Price: $0.001389 per call ($1.39 per 1,000 requests); failed calls and empty results are not charged
- Returns: list
- 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=search

## Parameters

| name | type | required | default | description |
|---|---|---|---|---|
| keyword | not declared | yes | not declared | search 的商品检索词，在美国商城搜索，每次返回一页结果；不是门店位置或评论关键词。 |
| lang | enum: en / fr | no | not declared | search / profile 的展示语言：en 英语、fr 法语，默认 en；不切换美国商城到加拿大，也不是评论语言过滤。 |
| limit | integer (1–) | no | not declared | 这次调用最多返回的条数，整数，至少为 1；不传按默认值，实际返回可能少于这个数。 |

## Response fields (items in `results`)

| field | meaning |
|---|---|
| item_id | 商品 ID。 |
| name | 名称。用于账号/商品/商家类能力，指该对象本身的名字。 |
| url | 该记录在原平台上的可访问链接。 |
| 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 | 是否有货。 |
| seller_name | 卖家名称（Walmart 也有第三方卖家）。 |
| category | 分类名称，取值为原平台的分类体系，未做跨平台归一。 |
| image_url | 图片链接。多图能力可能返回 image_urls 数组。 |
| platform | 数据来源平台标识，与请求里的 platform 一致（如 xiaohongshu、tiktok）。 |
| brand | 品牌。 |
| availability | 库存状态。 |
| condition | 成色。 |
| upc | 商品条码(UPC)。跨平台比价时用它做同款匹配最准。 |

## 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": "search",
  "params": {
    "keyword": "air purifier"
  }
}'
```

```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": "search",
        "params": {
            "keyword": "air purifier",
        },
    },
    timeout=120,
)
print(response.status_code)
print(response.json())
```

## Response example

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

```text
{
  "id": "req_…",
  "platform": "walmart",
  "action": "search",
  "results": [
    {
      "item_id": "944548256",
      "name": "Winix C535 True HEPA Air Purifier with PlasmaWave Technology, White",
      "url": "https://www.walmart.com/ip/944548256",
      "price": 158,
      "currency": "USD",
      "rating": 4.6,
      "rating_scale": 5,
      "review_count": 3064,
      "in_stock": true,
      "seller_name": "Walmart.com",
      "category": "Air Purifiers",
      "image_url": "https://i5.walmartimages.com/seo/Winix-C535-True-HEPA-Air-Purifier-with-PlasmaWave-Technology-White_68d3092b-f50e-4cc2-bd91-8905dedb5c4c.be1e3cf1e5006ceba37a7bf0a4d0b645.jpeg?odnHeight=180&odnWidth=180&odnBg=FFFFFF",
      "platform": "walmart"
    },
    {
      "item_id": "10643216361",
      "name": "DREO Air Purifier for Large Room, 1726 ft²/2H Coverage Smart Purificador with HEPA Sleep Mode for Pet Hair, Smoke, Dust & Pollen, 3-in-1 Filtration, PM2.5 Display, 116 CFM, 18W Energy-Saving DC Motor",
      "url": "https://www.walmart.com/ip/10643216361",
      "price": 69.99,
      "was_price": 125.99,
      "currency": "USD",
      "rating": 4.5,
      "rating_scale": 5,
      "review_count": 5950,
      "in_stock": true,
      "seller_name": "DREO",
      "category": "Air Purifiers",
      "image_url": "https://i5.walmartimages.com/seo/DREO-Air-Purifier-Large-Room-1726-ft-2H-Coverage-Smart-Purificador-HEPA-Sleep-Mode-Pet-Hair-Smoke-Dust-Pollen-3-in-1-Filtration-PM2-5-Display-116-CFM_2824a8a3-69ed-4f6a-bcb1-f576e1a30ce7.b7083723ded3c7f428e4dff4462a7a3e.jpeg?odnHeight=180&odnWidth…",
      "platform": "walmart"
    }
  ],
  "count": 20,
  "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