Product Details

The Product endpoint returns full detail for a single Walmart item as sold at one store: its price and stock at that location, plus the description and specification table that only the product page carries.

Endpoint

GET https://api.scrape.do/plugin/walmart/product

Each successful request costs 10 credits. Failed requests are never charged.

Input Parameters

Parameter	Type	Required	Description
`token`	string	*	Your Scrape.do API authentication token
`item`	string	*	Walmart's numeric item id. You can get these from `/plugin/walmart/search` results or from a product URL
`store`	integer	*	Walmart store id to scope the response to. Provide exactly one of `store` or `zipcode`.
`zipcode`	string	*	5-digit US ZIP code to scope the response to. Provide exactly one of `store` or `zipcode`.
`timeout`	integer		Per-request timeout in milliseconds (default: system maximum)

The item id is the number at the end of a Walmart product URL: walmart.com/ip/HP-14-N150-4-128-Pink/18611919209

Response Parameters

Field	Type	Description
`store`	object	The store this response reflects — same shape as the search endpoint
`product`	object	The product detail

Product Object Fields

Field	Type	Description
`item_id`	string	Walmart item id
`name`	string	Product title
`brand`	string	Brand name
`url`	string	Product page URL
`images`	array	Product image URLs, full size
`price`	number	Current price at this store. `null` when Walmart shows no price
`list_price`	number	Pre-discount price, present only when discounted
`currency`	string	Currency code (`USD`)
`availability`	string	Stock status at this store, e.g. `IN_STOCK`, `OUT_OF_STOCK`
`order_limit`	number	Maximum quantity per order, when Walmart sets one
`seller`	string	Who sells the item
`seller_type`	string	`INTERNAL` when Walmart sells it directly; marketplace sellers carry their own type
`fulfillment`	array	Fulfillment methods offered, lowercased
`rating`	number	Average customer rating
`reviews_count`	number	Number of reviews
`category`	string	Walmart's category path
`condition`	string	Item condition, e.g. `New`
`upc`	string	UPC barcode
`gtin`	string	GTIN barcode
`model_number`	string	Manufacturer's model number
`return_policy`	string	Return policy summary as Walmart states it
`short_description`	string	Short marketing description
`long_description`	string	Full description. Contains Walmart's HTML markup, not plain text
`highlights`	array	Key attributes as `{ "name", "value" }` pairs
`specifications`	array	Full specification table as `{ "name", "value" }` pairs

Fields Walmart does not supply for a given item are omitted from the response rather than returned empty, so check for a key's presence rather than for an empty string. price and reviews_count are the exceptions and are always present.

Example Usage

Step 1: Request an Item at a Store

curl "https://api.scrape.do/plugin/walmart/product?item=18611919209&store=1735&token=YOUR_TOKEN"

Step 2: Read the Response

{
  "store": {
    "store_id": "1735",
    "city": "Deer Park",
    "state": "IL",
    "postal_code": "60074"
  },
  "product": {
    "item_id": "18611919209",
    "name": "HP 14 inch HD Windows Laptop Intel Processor N150 4GB 128GB UFS Tranquil Pink",
    "brand": "HP",
    "url": "https://www.walmart.com/ip/HP-14-N150-4-128-Pink/18611919209",
    "images": [
      "https://i5.walmartimages.com/seo/HP-14-N150-4-128-Pink.jpeg"
    ],
    "price": 259,
    "list_price": 379,
    "currency": "USD",
    "availability": "IN_STOCK",
    "order_limit": 2,
    "seller": "Walmart.com",
    "seller_type": "INTERNAL",
    "fulfillment": ["delivery"],
    "rating": 4.1,
    "reviews_count": 687,
    "category": "Home Page/Electronics/Computers, Laptops and Tablets/Laptops",
    "condition": "New",
    "upc": "199764359179",
    "gtin": "00199764359179",
    "model_number": "CQ5J5UA#ABA",
    "return_policy": "Free 30-day returns",
    "short_description": "The HP 14 inch Laptop PC has it all to get it done with an Intel processor...",
    "long_description": "<ul><li><strong>Intel N150 processor:</strong> Improved graphics and performance...</li></ul>",
    "highlights": [
      { "name": "Proc. speed", "value": "3.7 GHz" },
      { "name": "Battery life", "value": "11.25 h" }
    ],
    "specifications": [
      { "name": "RAM memory", "value": "4 GB" },
      { "name": "Screen size", "value": "14 in" },
      { "name": "OS", "value": "Windows 11" }
    ]
  }
}

Comparing Prices Across Stores

Because the price and stock come from whichever store you target, requesting the same item id against different stores is how you measure regional differences:

for STORE in 1735 5021 3081; do
  curl -s "https://api.scrape.do/plugin/walmart/product?item=18611919209&store=$STORE&token=YOUR_TOKEN" \
    | jq '{store: .store.store_id, city: .store.city, price: .product.price, stock: .product.availability}'
done

Error Responses

Status	Body	Cause
400	`{"error":"token is required"}`	Missing token
400	`{"error":"item (usItemId) is required"}`	Missing `item`
400	`{"error":"item must be a numeric usItemId"}`	`item` is not numeric
400	`{"error":"exactly one of store or zipcode is required"}`	Both or neither of `store` / `zipcode` were provided
400	`{"error":"store must be numeric"}`	`store` is not numeric
400	`{"error":"zipcode must be a 5-digit US zip"}`	`zipcode` is not a valid 5-digit US ZIP
400	`{"error":"timeout is invalid"}`	`timeout` is not an integer
400	Unsupported store id	This endpoint does not cover that store id. Pass `zipcode` instead, or contact support to have your store added.
502	`{"error":"walmart-product plugin failure.","message":"…"}`	Could not get a valid response for this store or ZIP. Not charged.