# Walmart Details API (walmart.profile)

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

## Parameters

| name | type | required | default | description |
|---|---|---|---|---|
| url | not declared | yes | not declared | Specifies the full walmart.com/ip/ product URL for the profile, reviews, and product_detail actions. Note that profile and product_detail return product metadata rather than user account profiles, while reviews retrieves customer reviews for that product. |
| 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. |

## 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. |
| brand | platform-native meaning |
| 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 |
| availability | platform-native meaning |
| seller_name | platform-native meaning |
| category | Category name in the platform's own taxonomy, not normalized across platforms. |
| condition | platform-native meaning |
| upc | platform-native meaning |
| 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). |
| description | Summary or description, usually shorter than text. |
| highlights | platform-native meaning |
| images | Array of image links in the platform's display order; absent when there are no images. |
| return_policy | platform-native meaning |
| is_returnable | platform-native meaning |
| badges | 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": "profile",
  "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": "profile",
        "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. `id`, `billing` and `quota` differ on every call, so only their shape is shown.

```text
{
  "id": "req_…",
  "platform": "walmart",
  "action": "profile",
  "results": {
    "item_id": "1752657021",
    "name": "Restored Apple AirPods Pro (2nd Generation) Lightning Wireless Bluetooth In-Ear Earbuds, White",
    "url": "https://www.walmart.com/ip/Apple-AirPods-Pro-2nd-Generation-Lightning/1752657021",
    "brand": "Apple",
    "price": 149.95,
    "currency": "USD",
    "rating": 4.6,
    "review_count": 11634,
    "in_stock": false,
    "availability": "OUT_OF_STOCK",
    "category": "Electronics > Audio > Headphones > Shop Headphones by Brand > Apple AirPods > AirPods Pro",
    "condition": "New",
    "upc": "•••",
    "platform": "walmart",
    "description": "Experience an unparalleled audio journey with the Apple AirPods Pro (2nd Generation). These advanced in-ear earbuds feature up to two times more Active Noise Cancellation, allowing you to immerse yourself fully in your audio. Adaptive Transparency lets you comfortably hear your s…",
    "highlights": {
      "Noise control technology": "Active Noise Cancellation",
      "Battery life": "6 h",
      "Features": "Inner Ear",
      "Ip code": "IPX4",
      "Inputs/Outputs": "Lightning",
      "Wireless technology": "Bluetooth"
    },
    "return_policy": "Free 30-day returns",
    "is_returnable": true,
    "rating_scale": 5
  },
  "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
