# Walmart Product API (https://www.socialcrawl.dev/platforms/walmart/product)

> Returns full product detail for a Walmart item: title, brand, model, UPC, both descriptions, current and list price, rating with its 1-5 star breakdown, recommended percentage, image gallery, specifications, availability, seller, condition, and return-policy window. Accepts either the numeric item id from a walmart.com/ip/ URL or Walmart's alphanumeric catalog id. For this product's written reviews call GET /v1/walmart/reviews with the same id; for every seller offering it, GET /v1/walmart/offers.

TL;DR: `GET /v1/walmart/product` costs 5 credits per call and returns SocialCrawl's unified JSON schema. Single x-api-key auth, 100 free credits on signup.

## Parameters

| Parameter | Required | Description |
| --- | --- | --- |
| `product_id` | yes | Walmart product id. Either the numeric item id from the product URL (walmart.com/ip/<name>/17835006350) or the alphanumeric catalog id (34J2GQ9D9TFM). Both resolve to the same product. |
| `country` | no | Walmart marketplace as a two-letter country code: US (walmart.com, default) or CA (walmart.ca). A product id from one marketplace will not resolve in the other. (US \| CA) |

## Code example

```bash
curl "https://www.socialcrawl.dev/v1/walmart/product?product_id=17835006350" \
  -H "x-api-key: sc_YOUR_API_KEY"
```

## FAQ

### Which Walmart product id should I use?

Either works. The endpoint accepts the numeric item id from a product URL, for example the 17835006350 in walmart.com/ip/AirPods-Pro-3/17835006350, or Walmart's alphanumeric catalog id. Both resolve to the same product, and the response returns both so you can join on whichever your system already stores.

### Does the response include the star rating breakdown?

Yes. Alongside the average rating and the total ratings count, you get the full distribution across five, four, three, two and one star, plus the percentage of reviewers who recommend the product. That is enough to compute sentiment skew without pulling a single review.

### How do I get this product's reviews?

Call the reviews endpoint with the same product id. The two are deliberately separate so you only pay for reviews when you want them, and the reviews response carries the reviewed product id on every row as a join key.

### What happens if the product id does not exist?

You get a 404 with a clear not-found error, and the credits are refunded automatically. A wrong id never costs you anything, and it never returns a placeholder record of empty strings.

### Is the price the national price or my local store price?

The product endpoint returns Walmart's listed online price. For store-level pricing and stock, use the search or category endpoints with a ZIP code, state, or store id, which localise availability and pickup options to one location.

See the full Walmart API: https://www.socialcrawl.dev/platforms/walmart

## Pricing

- Standard endpoints: 1 credit per call
- Advanced endpoints: 5 credits per call
- Premium endpoints: 10 credits per call
- 100 free credits on signup, no credit card required. Cached responses cost 0 credits. Credit packs never expire.
- Full pricing: https://www.socialcrawl.dev/pricing

## Explore with AI

Questions this API answers, phrased for an AI assistant:

- How to get Walmart product details by item id
- Walmart API to look up a product price and UPC