Docs / Walmart

Retailers

Walmart

Walmart price, list price, stock, seller, fulfilment and shipping by item id, 1 credit per item.

At a glance

PropertyValue
platformwalmart
Item idThe number at the end of a product URL: walmart.com/ip/<name>/931920073 → 931920073 (5 to 15 digits).
Marketplacesus
Tierstandard (the default), 1 credit per item
Ids per call100
Typical call3–10 s for 100 items

Example

curl -X POST "https://api.scrapelyserp.com/v1/products" \
  -H "Authorization: Bearer $SCRAPELY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "platform": "walmart",
    "ids": ["931920073", "5129928603", "1000000404"]
  }'
Response
{
  "platform": "walmart",
  "marketplace": "us",
  "tier": "standard",
  "results": [
    {
      "id": "931920073",
      "status": "ok",
      "fetchedAt": "2026-10-16T14:02:37.118Z",
      "title": "Mainstays 20\" 3-Speed Box Fan, White",
      "url": "https://www.walmart.com/ip/931920073",
      "price": {
        "amount": 30,
        "currency": "USD"
      },
      "availability": {
        "inStock": true,
        "message": "Available"
      },
      "seller": {
        "name": "Walmart.com"
      },
      "fulfillment": {
        "byPlatform": true,
        "name": "Walmart"
      },
      "images": [
        "https://i5.walmartimages.com/asr/box-fan-1.jpeg",
        "https://i5.walmartimages.com/asr/box-fan-2.jpeg"
      ],
      "walmart": {
        "brand": "Mainstays",
        "upc": "810004819238",
        "modelNumber": "FB50-16HW",
        "parentId": "931920073",
        "listPrice": {
          "amount": 24.99,
          "currency": "USD"
        },
        "offerId": "F8CF2B7A1E2D4C6A9B0E3D5F7A1C2B4D",
        "offerType": "ONLINE_AND_STORE",
        "thirdPartySeller": false,
        "onlineAvailable": true,
        "shipping": {
          "standard": {
            "amount": 0,
            "currency": "USD"
          },
          "twoDayEligible": true,
          "freeOverThreshold": true
        },
        "maxPerOrder": 12,
        "clearance": false,
        "preOrder": false,
        "condition": "New",
        "category": "Home Improvement/Heating, Cooling, & Air Quality/Fans/Box Fans",
        "rating": 4.4,
        "reviewsCount": 1250,
        "color": "White"
      }
    },
    {
      "id": "5129928603",
      "status": "ok",
      "fetchedAt": "2026-10-16T14:02:37.118Z",
      "title": "Stainless Steel Electric Kettle, 1.7 L",
      "url": "https://www.walmart.com/ip/5129928603",
      "availability": {
        "inStock": false,
        "message": "Not available"
      },
      "seller": {
        "name": "Kitchen Outlet LLC"
      },
      "fulfillment": {
        "byPlatform": false
      },
      "images": ["https://i5.walmartimages.com/asr/kettle-1.jpeg"],
      "walmart": {
        "brand": "Generic",
        "listPrice": {
          "amount": 39.99,
          "currency": "USD"
        },
        "offerType": "ONLINE_ONLY",
        "thirdPartySeller": true,
        "onlineAvailable": false,
        "condition": "New",
        "category": "Home/Kitchen & Dining/Small Appliances/Kettles"
      }
    },
    {
      "id": "1000000404",
      "status": "not_found",
      "fetchedAt": "2026-10-16T14:02:37.118Z"
    }
  ],
  "stats": {
    "requested": 3,
    "ok": 2,
    "partial": 0,
    "notFound": 1,
    "unavailable": 0,
    "elapsedMs": 1840
  },
  "credits": 3
}

Walmart fields

Besides the common fields, each result carries a walmart object. Every field in it is optional: left out when Walmart does not say.

FieldDescription
walmart.listPriceThe list ("was") price, { amount, currency }. It can be below price.
walmart.offerId, offerTypeThe current offer. A different offerId means another offer took over.
walmart.thirdPartySellerSold by a marketplace seller rather than Walmart.
walmart.onlineAvailableOffered online at all. Use availability.inStock for whether it can be bought now.
walmart.shippingstandard and twoDay costs, twoDayEligible, and freeOverThreshold.
walmart.brand, upc, modelNumber, parentIdIdentifiers. Variants of one product share parentId.
walmart.rating, reviewsCount, category, condition, size, colorCatalogue details.
walmart.maxPerOrder, clearance, preOrderOffer flags.

fulfillment.byPlatform is true when Walmart ships the item (its own stock, or a marketplace item fulfilled by Walmart). Walmart does not publish delivery dates, stock quantities or sibling variants.

Statuses on Walmart

  • ok includes out-of-stock items: availability.inStock: false, usually without a price.
  • partial: the title or stock is missing, or the item is in stock without a price. Ask again later.
  • not_found: Walmart says the item does not exist or was delisted.

For large catalogues, send calls one after another rather than many at once; items not answered in time come back unavailable (refunded) and can simply be sent again.

Watchlists

A watchlist with "platform": "walmart" reads each item once per run at standard and reports changes to price, listPrice, inStock, seller, byPlatform, thirdPartySeller, offerId, clearance.