# Product Details

> Source: https://scrape.do/documentation/walmart-scraper-api/product/

Get one Walmart item's price, stock, and specifications at a specific store

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`](/documentation/walmart-scraper-api/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) |

> [!NOTE]
> 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](/documentation/walmart-scraper-api/search) |
| `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 |

> [!NOTE]
> 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

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

### Step 2: Read the Response

```json
{
  "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:

```bash
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](/documentation/contact) 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. |