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

> Walmart API: 5 endpoints covering product detail, up to 50 reviews per call, keyword search, category browsing, and every marketplace seller offering an item. Store-level pricing via ZIP, state, or store id, across walmart.com and walmart.ca. Same canonical product and review shapes as our Amazon and Google Shopping endpoints, so one parser covers all three.

TL;DR: SocialCrawl's Walmart API exposes 5 endpoints, 5 credits per call, all returning one unified JSON schema with AI-enriched fields. Single x-api-key auth, 100 free credits on signup.

## Endpoints

| Endpoint | Method | Path | Credits | Description |
| --- | --- | --- | --- | --- |
| Product | GET | `/v1/walmart/product` | 5 | Get a Walmart product by id |
| Reviews | GET | `/v1/walmart/reviews` | 5 | Get Walmart product reviews |
| Search | GET | `/v1/walmart/search` | 5 | Search Walmart products by keyword |
| Category | GET | `/v1/walmart/category` | 5 | Browse Walmart products in a category |
| Offers | GET | `/v1/walmart/offers` | 5 | Get every seller offering a Walmart product |

## Code example

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

Every response shares one JSON envelope: `{ success, platform, endpoint, data, credits_used, credits_remaining }`.

## SocialCrawl vs Walmart affiliate / partner feeds

| Feature | SocialCrawl | Walmart affiliate / partner feeds |
| --- | --- | --- |
| Access | API key, working in a minute | Partner application and approval |
| Customer reviews | Up to 50 per call with full text and photos | Not exposed |
| Marketplace seller offers | Every seller, price, and condition per item | Not exposed |
| Store-level pricing | ZIP, state, or store id | National catalogue only |
| Response shape | Same canonical product and review objects as Amazon and Google Shopping | Walmart-specific feed format |

## FAQ

### What data can I get from the SocialCrawl Walmart API?

Product detail (title, brand, model, UPC, price, list price, rating with its full 1-5 star breakdown, image gallery, specifications, availability, seller, and return policy), written customer reviews up to 50 per call, keyword search, category listings, and every marketplace seller offering a given item with their price and condition.

### Do Walmart search results include prices?

No, and we return null rather than a misleading zero. Walmart's search surface does not expose prices, so the price field on search results is null by design. Use search to resolve a keyword to a product id, then call the product endpoint for the price. The category endpoint does return real prices if you need pricing across a product set.

### Can I get store-level Walmart prices?

Yes. Search and category accept a ZIP code, a US state code, or a specific Walmart store id, so you can see the availability, pickup options, and assortment for one location. Walmart pricing and stock are genuinely store-level, so this is the difference between a national list price and what a shopper actually sees.

### Does the Walmart API cover walmart.ca?

Yes. Every endpoint takes a country parameter of US or CA, which selects walmart.com or walmart.ca. Product ids are marketplace-specific, so an id from walmart.com will not resolve against walmart.ca and will correctly return a not-found rather than the wrong product.

### How many Walmart reviews can I pull per request?

Up to 50 written reviews per call, sortable by relevancy, recency, or star rating, and filterable to a single rating. Each review carries the full text, star rating, author, date, helpful-vote count, verified-purchase flag, and any reviewer photos. Paging past the last review returns an empty list and costs you nothing.

### What does the Walmart API cost?

Every Walmart endpoint is 5 credits per call. For reviews that works out at 0.1 credit per review at the 50-row maximum. Empty results are never billed: if a product has no data or a page runs past the end, the credits are refunded automatically.

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

- What is the SocialCrawl Walmart API?
- How to get Walmart product prices and reviews with an API
- Compare SocialCrawl vs Walmart scrapers for e-commerce price tracking