Skip to content

Walmart Category Search API

Scrape Walmart category, department, or search result pages instantly with a simple API call

🆕: May 30, 2025

New! Comprehensive Category & Search Support

Our Walmart Category Search API now supports any search URL, department page, or category listing with pagination. Extract product data from filtered searches, brand pages, and category hierarchies with ease.

A GET request to our /api/getter/?platform="walmart_category" endpoint allows you to scrape category, department, or search result pages from Walmart.com in real-time.

Example

Here's an example showcasing how you can scrape product listings from Walmart's Eye Makeup category. We're using a filtered URL that includes specific parameters:

1
curl 'https://data.unwrangle.com/api/getter/?platform=walmart_category&url=https%3A%2F%2Fwww.walmart.com%2Fbrowse%2Fbeauty%2Feye-makeup%2F1085666_1007040_6659232%3Fpovid%3DBeauty_MakeupCP_Hubspokes_ShopByCat_Eyes_122624&page=1&api_key=API_KEY'

1
2
3
4
5
import requests

url = 'https://data.unwrangle.com/api/getter/?platform=walmart_category&url=https%3A%2F%2Fwww.walmart.com%2Fbrowse%2Fbeauty%2Feye-makeup%2F1085666_1007040_6659232%3Fpovid%3DBeauty_MakeupCP_Hubspokes_ShopByCat_Eyes_122624&page=1&api_key=API_KEY'
response = requests.get(url)
print(response.json())

1
2
3
const response = await fetch('https://data.unwrangle.com/api/getter/?platform=walmart_category&url=https%3A%2F%2Fwww.walmart.com%2Fbrowse%2Fbeauty%2Feye-makeup%2F1085666_1007040_6659232%3Fpovid%3DBeauty_MakeupCP_Hubspokes_ShopByCat_Eyes_122624&page=1&api_key=API_KEY')
const data = await response.json()
console.log(data)

1
2
3
4
5
6
<?php
$url = 'https://data.unwrangle.com/api/getter/?platform=walmart_category&url=https%3A%2F%2Fwww.walmart.com%2Fbrowse%2Fbeauty%2Feye-makeup%2F1085666_1007040_6659232%3Fpovid%3DBeauty_MakeupCP_Hubspokes_ShopByCat_Eyes_122624&page=1&api_key=API_KEY';
$response = file_get_contents($url);
$data = json_decode($response, true);
print_r($data);
?>

1
2
3
4
5
6
require 'net/http'
require 'uri'

uri = URI.parse('https://data.unwrangle.com/api/getter/?platform=walmart_category&url=https%3A%2F%2Fwww.walmart.com%2Fbrowse%2Fbeauty%2Feye-makeup%2F1085666_1007040_6659232%3Fpovid%3DBeauty_MakeupCP_Hubspokes_ShopByCat_Eyes_122624&page=1&api_key=API_KEY')
response = Net::HTTP.get(uri)
puts response

Query Parameters

As you can see in the example above, our endpoint needs the following query parameters:

Category or Search URL

url

Required

The URL of the Walmart category, department, or search results page you want to scrape. This can be:

• Category pages (e.g., /browse/beauty/eye-makeup/...)
• Search results (e.g., /search?q=mascara&...)
• Department pages with any filters applied
• Brand-specific category pages

The URL must be properly encoded before passing it as a query parameter.

page

Optional

The page number for which you want the results. Default value is 1.

Walmart typically shows 40-50 products per page. Use this parameter to paginate through all results.

Working with Walmart URLs

  • Any Walmart URL that displays a list of products with pagination can be used
  • You can apply filters (price, brand, ratings, etc.) on Walmart's website and then copy the filtered URL
  • The API preserves all filters and sorting options from your URL
  • Search queries, category browsing, and department pages are all supported

Other Required Parameters

platform

Required

Specifies the scraping engine you wish to invoke. In this case, the value should be walmart_category.

api_key

Required

Your account's token—which can be obtained by signing up here.

URL Encoding

The value of the query parameter url must be URL or percent encoded. If you're using Python, this can be done with the function urllib.parse.quote().

Results

Each request returns detailed product information for items displayed on the page. The response will include the following attributes for each product:

Attributes Returned Data Type Information Represented
id string Walmart product ID
name string Product name/title
url string Full URL to product page
price float Current selling price
price_reduced float/null Original price if on sale
currency string Currency code (e.g., USD)
currency_symbol string Currency symbol (e.g., $)
offer_msg string Special offer message if any
rating float Average customer rating
total_reviews integer Number of customer reviews
in_stock boolean Stock availability status
model_no string Product model number
description string Brief product description
image_url string Main product image URL
thumbnail string Thumbnail image URL
seller_name string Name of the seller
is_sponsored boolean Whether the listing is sponsored
variants object Product variants with details
est_delivery_date string/null Estimated delivery date

Variant Information

The variants field contains detailed information about product variations (colors, sizes, etc.). For example:

  • actual_color: Different color options with images, stock status, prices, and URLs
  • size: Size variations with availability
  • pack_size: Multi-pack options

Each variant includes: - name: Variant option name - images: Array of image URLs - swatch_image: Small preview image - in_stock: Availability status - price: Variant-specific pricing - id: Unique variant ID - model_no: Model number - url: Direct link to variant

Response Example

Here's the response you can expect to receive for the request showcased above:

{
    "success": true,
    "platform": "walmart_category",
    "url": "https://www.walmart.com/browse/beauty/eye-makeup/1085666_1007040_6659232?povid=Beauty_MakeupCP_Hubspokes_ShopByCat_Eyes_122624",
    "page": 1,
    "total_results": 88264,
    "no_of_pages": 2207,
    "result_count": 47,
    "results": [
        {
            "id": "320040053",
            "name": "Maybelline Lash Sensational Sky High Washable Mascara, Blackest Black",
            "url": "https://www.walmart.com/ip/Maybelline-Lash-Sensational-Sky-High-Washable-Mascara-Makeup-Blackest-Black-0-24-fl-oz/320040053?classType=VARIANT&athbdg=L1300",
            "price_reduced": null,
            "price": 8.32,
            "currency": "USD",
            "currency_symbol": "$",
            "offer_msg": "Options from $8.32 – $16.64",
            "rating": 4.6,
            "total_reviews": 18252,
            "in_stock": true,
            "model_no": "30WW0TFV6A7R",
            "description": "<li>Maybelline Lash Sensational Sky High delivers lightweight lashes. No flaking or smudging. Brush reaches every lash for full volume and limitless length.</li>",
            "image_url": "https://i5.walmartimages.com/seo/Maybelline-Lash-Sensational-Sky-High-Washable-Mascara-Makeup-Blackest-Black-0-24-fl-oz_32dd629e-479b-403b-831e-183c9ed90dee.15adcfd5465c05cd39a130b52e06248d.jpeg",
            "thumbnail": "https://i5.walmartimages.com/seo/Maybelline-Lash-Sensational-Sky-High-Washable-Mascara-Makeup-Blackest-Black-0-24-fl-oz_32dd629e-479b-403b-831e-183c9ed90dee.15adcfd5465c05cd39a130b52e06248d.jpeg?odnHeight=180&odnWidth=180&odnBg=FFFFFF",
            "seller_name": "Walmart.com",
            "is_sponsored": false,
            "variants": {
                "actual_color": [
                    {
                        "name": "BURGUNDY HAZE",
                        "images": [
                            "https://i5.walmartimages.com/asr/f6390965-a803-4d63-802a-faaeacd0c6ce.b40ab5a959ba53fa2f997afd37c51a01.png?odnHeight=180&odnWidth=180&odnBg=ffffff"
                        ],
                        "swatch_image": "https://i5.walmartimages.com/asr/9ba588e2-3e45-4fb8-b35d-11cfc5a9b1e7.3174ec4988ab936cc66750a3b533aa39.jpeg?odnHeight=30&odnWidth=30&odnBg=ffffff",
                        "in_stock": "BURGUNDY HAZE",
                        "price": null,
                        "id": "3764104657",
                        "model_no": "70FGXG32MRUV",
                        "url": "https://www.walmart.com/ip/Maybelline-Lash-Sensational-Sky-High-Washable-Mascara-Burgundy-Haze/3764104657?classType=undefined"
                    },
                    {
                        "name": "Black",
                        "images": [
                            "https://i5.walmartimages.com/asr/9b304e41-afa2-4934-8559-4b4c0c951ced.d05cc6977fa6ca4f512bbe9279692908.jpeg?odnHeight=180&odnWidth=180&odnBg=ffffff"
                        ],
                        "swatch_image": "https://i5.walmartimages.com/asr/ecb3d4b3-f328-4648-814c-50867788977c.443bda8277d935399b201d83e451cd46.jpeg?odnHeight=30&odnWidth=30&odnBg=ffffff",
                        "in_stock": "Black",
                        "price": null,
                        "id": "2730496708",
                        "model_no": "1PP0I1TGS6Y0",
                        "url": "https://www.walmart.com/ip/Maybelline-Lash-Sensational-Sky-High-Mascara-Tinted-Primer-Kit-Blackest-Black/2730496708?classType=undefined"
                    }
                ]
            },
            "est_delivery_date": null
        },
        {
            "id": "861565441",
            "name": "L'Oreal Paris Telescopic Original Washable Mascara, Blackest Black 2 Pack",
            "url": "https://www.walmart.com/ip/L-Oreal-Paris-Telescopic-Original-Washable-Mascara-Blackest-Black-2-Pack/861565441?classType=VARIANT&athbdg=L1600",
            "price_reduced": null,
            "price": 17.98,
            "currency": "USD",
            "currency_symbol": "$",
            "offer_msg": "Options from $11.12",
            "rating": 4.3,
            "total_reviews": 5169,
            "in_stock": true,
            "model_no": "6B3X6R2UIO03",
            "description": "L'Oreal Paris Telescopic Original Washable Intense Lengthening Mascara, Blackest Black, 0.54 fl. oz.",
            "image_url": "https://i5.walmartimages.com/seo/L-Oreal-Paris-Telescopic-Original-Washable-Mascara-Blackest-Black-2-Pack_1078c201-f032-412b-b961-943c31204fe1.c36a36069e12324e36db1189a425478f.jpeg",
            "thumbnail": "https://i5.walmartimages.com/seo/L-Oreal-Paris-Telescopic-Original-Washable-Mascara-Blackest-Black-2-Pack_1078c201-f032-412b-b961-943c31204fe1.c36a36069e12324e36db1189a425478f.jpeg?odnHeight=180&odnWidth=180&odnBg=FFFFFF",
            "seller_name": "Walmart.com",
            "is_sponsored": false,
            "variants": {
                "actual_color": [
                    {
                        "name": "Black",
                        "images": [
                            "https://i5.walmartimages.com/asr/9645949a-7d9e-44f8-8bf3-8e446329f8db.a98c00831f544e23ecaac86d619510ca.jpeg?odnHeight=180&odnWidth=180&odnBg=ffffff"
                        ],
                        "swatch_image": "https://i5.walmartimages.com/asr/08efc5f9-d54f-4d9a-b114-591809ea86e0.5244be578fce777727d5466bfdea4f78.jpeg?odnHeight=30&odnWidth=30&odnBg=ffffff",
                        "in_stock": "Black",
                        "price": null,
                        "id": "15553607178",
                        "model_no": "3MILNGL1LET1",
                        "url": "https://www.walmart.com/ip/L-Oreal-Paris-Telescopic-Original-Washable-Intense-Lengthening-Mascara-Black-0-27-fl-oz/15553607178?classType=undefined"
                    }
                ]
            },
            "est_delivery_date": null
        }
    ],
    "meta_data": [
        {}
    ],
    "remaining_credits": 1770464.0,
    "credits_used": 2.5
}

Response Fields

  • total_results: Total number of products matching your search/category
  • no_of_pages: Total pages available for pagination
  • result_count: Number of products returned in this response (typically 40-50)
  • results: Array containing detailed product information
  • meta_data: Additional metadata about the search results

Request Cost

2.5 credits is deducted for each successful request

Support

If you want to add a parameter to our response, or have any question or feedback, please write to us at support@unwrangle.com