# Walmart Search API (walmart.search)

- Canonical page: https://everyinfra.com/en/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 | Specifies the product search term for the search action. The search targets the US Walmart storefront and fetches a single page of results. It does not search store locations or product reviews. |
| lang | enum: en / fr | no | not declared | Sets the display language for the search and profile actions. Allowed values are en (English, default) and fr (French). This parameter changes only the interface language, not the storefront region or review filtering. |
| limit | integer (1–) | no | not declared | The most rows to return in this call, an integer of 1 or more. The default applies when you leave it out, and a call can return fewer rows. |

## Response fields (items in `results`)

| field | meaning |
|---|---|
| item_id | platform-native meaning |
| name | Name of the object itself, for account, product and business capabilities. |
| url | Link to the record on the platform. |
| price | Price as a number without a currency symbol; see currency. |
| was_price | platform-native meaning |
| currency | Currency code of the price (for example CNY, USD). If price is present but currency is null, do not assume a currency. |
| rating | Rating. **The scale varies by platform**: rating_scale on the same row gives the maximum (usually 5; Booking, Douban, iQIYI and NAVER use 10). Convert with rating_scale before comparing across platforms, or the comparison can come out backwards. |
| rating_scale | Maximum of rating in the same row: 5 for five-star scales, 10 for ten-point scales. Present only when the row has a rating. |
| review_count | Number of reviews, for product and business capabilities. null means not disclosed, not 0. |
| in_stock | platform-native meaning |
| seller_name | platform-native meaning |
| category | Category name in the platform's own taxonomy, not normalized across platforms. |
| image_url | Image link. Capabilities with several images may return an image_urls array. |
| platform | Source platform identifier, the same as platform in the request (for example xiaohongshu, tiktok). |
| brand | platform-native meaning |
| availability | platform-native meaning |
| condition | platform-native meaning |
| upc | platform-native meaning |

## 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