Skip to main content

Walmart Product Details and Pricing API

Overview​

The Walmart Product Details and Pricing API allows you to extract product details, pricing, reviews, ratings, and more from Walmart programmatically. This API provides real-time access to comprehensive product data, making it an essential tool for e-commerce platforms, price comparison sites, and market analysts.

Authentication​

Visit our Authentication Docs on learning how to get started on integrating this API in your application.

Endpoint​

GET https://get.scrapehero.com/wmt/product-details/?x-api-key=XXXXXXXXXXXXXX&product_id=953027241

Request Parameters​

ParameterTypeRequiredDescription
product_idstringYesProduct ID from walmart
product_urlstringYesProduct URL from walmart

Either product_id or product_url must be provided. At least one is mandatory.

Response Format​

The API returns data in JSON format. Here's an example of the response structure:

{
	"name": "Nostalgia PCM205PK Hard & Sugar-Free Candy Cotton Candy Maker",
	"brand": "Nostalgia",
	"regular_price": "29.99",
	"sale_price": "22.99",
	"currency": "USD",
	"images": [
		"https://i5.walmartimages.com/asr/9064672e-3957-43fb-9d8b-35663af28562_1.c36862d7cb7811a5c608d0d26e2d6eb3.jpeg",
		"https://i5.walmartimages.com/asr/c55388da-08bd-471e-b8be-c4ce340dbe26_1.6ee6e3588b58aada61bc61ef21b02a6c.jpeg",
		"https://i5.walmartimages.com/asr/83668887-2e4e-4047-9f12-b3980a4ed80b_1.3e5f98ccb26f26e675d48230055cb833.jpeg",
		"https://i5.walmartimages.com/asr/0e936b32-2b8b-4ea9-9ea0-4d2349d0bb28_1.55bd998098472a0d3ea3d7b76181f41d.jpeg",
		"https://i5.walmartimages.com/asr/b93934c8-90cd-4398-811d-e0450976e857_1.44aa8fba5a064bdfe4468f0326f9ca5c.jpeg",
		"https://i5.walmartimages.com/asr/c11f6d83-5d7b-4dba-be1a-3e8a799475f0_1.5fb1031269817ef4db661d8d42dfb959.jpeg",
		"https://i5.walmartimages.com/asr/7def12e4-23fd-487a-99ee-c30c481d3f2b_1.d463a35327bbb24b7b1eef9389c055fe.jpeg"
	],
	"seller": "Walmart.com",
	"availability_status": "In Stock.",
	"rating_histogram": {
		"five_star": "55%",
		"four_star": "5%",
		"three_star": "10%",
		"two_star": "5%",
		"one_star": "25%"
	},
	"rating": "3.6",
	"product_reviews": [{
		"reviewed_date": "June 24, 2019",
		"review_title": null,
		"review_text": "It works great! My kids and I love it!",
		"rating": "5",
		"author_name": "WorksGreatWithJollys",
		"badge": null,
		"review_url": "https://www.walmart.com/reviews/product/953027241",
		"review_likes": "0",
		"review_dislikes": "0"
	}],
	"review_count": "20",
	"product_information": {
		"Brand": "Nostalgia",
		"Manufacturer Part Number": "pcm205pk",
		"Assembled Product Weight": "2.85 oz",
		"Assembled Product Dimensions (L x W x H)": "11.25 x 11.25 x 9.00 Inches"
	},
	"product_category": "Home > Appliances > Kitchen Appliances > Ice Cream & Dessert Makers > Cotton Candy & Candy Makers",
	"model": "082677010001",
	"item_id": "953027241",
	"walmart_item_number": "576142105",
	"detailed_description": "Make every occasion a little sweeter with the Nostalgia PCM205PK Hard & Sugar Free Candy Cotton Candy Maker. Few treats are as delightful as cotton candy or as long-lasting as hard candy. With this hard candy cotton candy maker from Nostalgia, you can create both in the comfort of your own kitchen, with a special extractor head that makes candy creation easy. The maker features a specialty extractor head to create hard candy, sugar-free hard candy and flossing sugar, yielding sweet, pretty treats that are ideal for everything from gifts to occasional indulgences. The unit's clear bowl guard acts keeps ingredients neatly contained while allowing you to watch your creations come to life; four suction-cup feet keep it stable on countertop and table surfaces. It can be used with Nostalgia cotton candy and hard candy party kits for effortless use. The Nostalgia cotton candy maker comes with two reusable cotton candy cones, a sugar scoop and an extractor head; kits sold separately. Nostalgia PCM205PK Hard & Sugar-Free Candy Cotton Candy Maker: Speciality extractor head works with hard candy, sugar-free hard candy or flossing sugar Perfect for use with Nostalgia Cotton Candy Kits; Cotton Candy Flossing Sugar - CCFS300, Cotton Candy Party Kit - FSCC8, Hard Candy Party Kit - HCK800 Clear rim guard allows for easy viewing of cotton candy making Unit disassembles for easy cleaning Suction cup feet for stability Includes 2 reusable plastic cones, 1 sugar scoop, and 1 extractor head Hard candy cotton candy maker only; Nostalgia Cotton Candy and Hard Candy Party Kits sold separately",
	"attributes": "Pink",
	"variation_item_id": [
		"953027241",
		"370814713"
	],
	"product_variations": [{
		"Actual Color": [
			"Aqua",
			"Pink"
		]
	}],
	"url": "https://www.walmart.com/ip/Nostalgia-PCM205PK-Hard-Sugar-Free-Candy-Cotton-Candy-Maker/953027241?selected=true"
}

Response Fields​

FieldTypeDescription
namestringproduct name
brandstringproduct brand
regular_pricestringlisting price
sale_pricestringdiscounted price
currencystringprice currency
imageslistproduct images
sellerstringseller name
availability_statusstringproduct availability status
rating_histogramdictrating histogram for product
ratingstringproduct rating
product_reviewsdicthighlighted product reviews
review_countstringproduct review count
product_informationdictproduct information
product_categorystringproduct category
modelstringmodel number
item_idstringitem id
gtinstringgtin id
walmart_item_numberstringwalmart item number
detailed_descriptionstringproduct Description from walmart
attributesstringproduct attributes
variation_item_iddictproduct variation id's
product_variationsdictproduct variations from walmart
urlstringproduct url from walmart

Usage Example​

Here's an example of how to use the API with Python:

const http = require("https");

const options = {
  "method": "GET",
  "hostname": "get.scrapehero.com",
  "port": null,
  "path": "/wmt/product-details/?x-api-key=XXXXXXXXXXXXXX&product_id=953027241&product_url=https%3A%2F%2Fwww.walmart.com%2Fip%2FNostalgia-PCM205PK-Hard-Sugar-Free-Candy-Cotton-Candy-Maker%2F953027241%3Fselected%3Dtrue",
  "headers": {}
};

const req = http.request(options, function (res) {
  const chunks = [];

  res.on("data", function (chunk) {
    chunks.push(chunk);
  });

  res.on("end", function () {
    const body = Buffer.concat(chunks);
    console.log(body.toString());
  });
});

req.end();

This API uses 10 data credit per API call. Learn more about data credits.

Rate Limits​

Rate limits are based off the plan that you have subscribed to. To learn more about the plan specification vist our Plans page.

Response Codes​

Check out the response codes here.

Best Practices​

  1. Use appropriate error handling in your code.
  2. Implement exponential backoff for rate limiting.
  3. Cache results when possible to minimize API calls.

Support​

If you encounter any issues or have questions, please contact our API support team at cloud-support@scrapehero.com or visit our API documentation at https://docs.scrapehero.com/api.