docs / walmart

Walmart API scraper

base /walmart/v14 endpoints

post/walmart/v1/search2 credits

Search Walmart.com by keyword → a paginated, sortable list of products with item id, name, brand, current & list price, savings, star rating + review count, availability, seller, category, image and the product link. Narrow with min_price/max_price and sort.

Parameter		Allowed / range	Description
query	required	—	What to search for on Walmart.com (product keywords, brand, or model).
sort = best_match	optional	best_match · price_low · price_high · best_seller · rating_high · new	Result ordering.
page = 1	optional	1–	Result page (~40 products per page; paginate with page += 1).
min_price	optional	0–	Lowest price to include (USD).
max_price	optional	0–	Highest price to include (USD).
facet	optional	—	Advanced: a raw Walmart facet token (e.g. a brand/department filter from a category page) appended to the search as &facet=. Escape hatch for power users; omit for a plain keyword search.

Try in playground →

post/walmart/v1/product_detail2 credits

Full product record by Walmart item id (or product URL): name, brand, model, manufacturer, current & list price, availability, seller, average rating + review count, short & long descriptions, the full specification table, product highlights, variant ids and gallery images.

Parameter		Allowed / range	Description
item_id	optional	—	Walmart item id — the number in a walmart.com/ip/<id> URL, or a search result's `item_id`. Provide item_id OR url.
url	optional	—	Full walmart.com product page URL (alternative to item_id; the id is parsed from /ip/<id>).

Try in playground →

post/walmart/v1/reviews1 credit

Customer reviews for a Walmart product by item id (or product URL): the average rating, total review count, recommended-percentage, the 5★→1★ rating distribution, and the review texts (rating, title, body, date, helpful counts).

Parameter		Allowed / range	Description
item_id	optional	—	Walmart item id — the number in a walmart.com/ip/<id> URL, or a search result's `item_id`. Provide item_id OR url.
url	optional	—	Full walmart.com product page URL (alternative to item_id; the id is parsed from /ip/<id>).
max_results = 20	optional	1–100	How many review texts to return (the rating distribution is always the full-catalog total).

Try in playground →

post/walmart/v1/category2 credits

Browse a Walmart category / department by its query term (e.g. 'coffee maker', '4k tv') → the same product grid as search, but framed as a category browse with the available facet filters surfaced. Paginated and sortable.

Parameter		Allowed / range	Description
query	required	—	The category/department to browse (a Walmart department name or product-class keyword).
sort = best_match	optional	best_match · price_low · price_high · best_seller · rating_high · new	Result ordering.
page = 1	optional	1–	Result page (~40 products per page; paginate with page += 1).
min_price	optional	0–	Lowest price to include (USD).
max_price	optional	0–	Highest price to include (USD).

Try in playground →

Example request · search

curl -X POST https://api.reefapi.com/walmart/v1/search \
  -H "x-api-key: $REEF_KEY" \
  -H "content-type: application/json" \
  -d '{"query":"laptop"}'

Response shape

{
  "ok": true,
  "data": { /* the result */ },
  "meta": {
    "latency_ms": 240,
    "record_count": 12,
    "completeness_pct": 100
  },
  "error": null
}