Walmart

You can get Walmart results by providing your own URLs to our service. We can return the HTML for any Walmart page you like. Additionally, we can deliver structured (parsed) output for Walmart product and search pages.

We’ve developed new parsers for Walmart product and search pages. To use the updated layouts, include the parser_type parameter in your requests, set to either walmart_product_new or walmart_search_new. Starting from November 18th, these new layouts will become the default when using the parse: true parameter.

Request samples

The example below illustrates how you can get a parsed Walmart product page result.

curl 'https://realtime.oxylabs.io/v1/queries' \
--user 'USERNAME:PASSWORD' \
-H 'Content-Type: application/json' \
-d '{
        "source": "universal", 
        "url": "https://www.walmart.com/ip/Adidas-Moves-Body-Spray-for-Men-2-5-Oz/710726462", 
        "geo_location": "United States",
        "parse": true
    }'

import requests
from pprint import pprint


# Structure payload.
payload = {
    'source': 'universal',
    'url': 'https://www.walmart.com/ip/Adidas-Moves-Body-Spray-for-Men-2-5-Oz/710726462',
    'geo_location': 'United States',
    'parse': True,
}

# Get response.
response = requests.request(
    'POST',
    'https://realtime.oxylabs.io/v1/queries',
    auth=('USERNAME', 'PASSWORD'),
    json=payload,
)

# Instead of response with job status and results url, this will return the
# JSON response with the result.
pprint(response.json())

const https = require("https");

const username = "USERNAME";
const password = "PASSWORD";
const body = {
    source: "universal",
    url: "https://www.walmart.com/ip/Adidas-Moves-Body-Spray-for-Men-2-5-Oz/710726462",
    geo_location: "United States",
    parse: true,
};

const options = {
    hostname: "realtime.oxylabs.io",
    path: "/v1/queries",
    method: "POST",
    headers: {
        "Content-Type": "application/json",
        Authorization:
            "Basic " + Buffer.from(`${username}:${password}`).toString("base64"),
    },
};

const request = https.request(options, (response) => {
    let data = "";

    response.on("data", (chunk) => {
        data += chunk;
    });

    response.on("end", () => {
        const responseData = JSON.parse(data);
        console.log(JSON.stringify(responseData, null, 2));
    });
});

request.on("error", (error) => {
    console.error("Error:", error);
});

request.write(JSON.stringify(body));
request.end();

# The whole string you submit has to be URL-encoded.

https://realtime.oxylabs.io/v1/queries?source=universal&url=https%3A%2F%2Fwww.walmart.com%2Fip%2FAdidas-Moves-Body-Spray-for-Men-2-5-Oz%2F710726462&geo_location=United%20States&parse=true&access_token=12345abcde

<?php

$params = array(
    'source' => 'universal',
    'url' => 'https://www.walmart.com/ip/Adidas-Moves-Body-Spray-for-Men-2-5-Oz/710726462',
    'geo_location' => 'United States',
    'parse' => true
);

$ch = curl_init();

curl_setopt($ch, CURLOPT_URL, "https://realtime.oxylabs.io/v1/queries");
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($params));
curl_setopt($ch, CURLOPT_POST, 1);
curl_setopt($ch, CURLOPT_USERPWD, "USERNAME" . ":" . "PASSWORD");

$headers = array();
$headers[] = "Content-Type: application/json";
curl_setopt($ch, CURLOPT_HTTPHEADER, $headers);

$result = curl_exec($ch);
echo $result;

if (curl_errno($ch)) {
    echo 'Error:' . curl_error($ch);
}
curl_close($ch);

package main

import (
	"bytes"
	"encoding/json"
	"fmt"
	"io/ioutil"
	"net/http"
)

func main() {
	const Username = "USERNAME"
	const Password = "PASSWORD"

	payload := map[string]interface{}{
		"source":       "universal",
		"url":          "https://www.walmart.com/ip/Adidas-Moves-Body-Spray-for-Men-2-5-Oz/710726462",
		"geo_location": "United States",
		"parse":        true,
	}

	jsonValue, _ := json.Marshal(payload)

	client := &http.Client{}
	request, _ := http.NewRequest("POST",
		"https://realtime.oxylabs.io/v1/queries",
		bytes.NewBuffer(jsonValue),
	)

	request.SetBasicAuth(Username, Password)
	response, _ := client.Do(request)

	responseText, _ := ioutil.ReadAll(response.Body)
	fmt.Println(string(responseText))
}

using System;
using System.Collections.Generic;
using System.Net.Http;
using System.Net.Http.Json;
using System.Threading.Tasks;

namespace OxyApi
{
    class Program
    {
        static async Task Main()
        {
            const string Username = "USERNAME";
            const string Password = "PASSWORD";

            var parameters = new {
                source = "universal",
                url = "https://www.walmart.com/ip/Adidas-Moves-Body-Spray-for-Men-2-5-Oz/710726462",
                geo_location = "United States",
                parse = true
            };

            var client = new HttpClient();

            Uri baseUri = new Uri("https://realtime.oxylabs.io");
            client.BaseAddress = baseUri;

            var requestMessage = new HttpRequestMessage(HttpMethod.Post, "/v1/queries");
            requestMessage.Content = JsonContent.Create(parameters);

            var authenticationString = $"{Username}:{Password}";
            var base64EncodedAuthenticationString = Convert.ToBase64String(System.Text.ASCIIEncoding.UTF8.GetBytes(authenticationString));
            requestMessage.Headers.Add("Authorization", "Basic " + base64EncodedAuthenticationString);

            var response = await client.SendAsync(requestMessage);
            var contents = await response.Content.ReadAsStringAsync();

            Console.WriteLine(contents);
        }
    }
}

package org.example;

import okhttp3.*;
import org.json.JSONObject;
import java.util.concurrent.TimeUnit;

public class Main implements Runnable {
    private static final String AUTHORIZATION_HEADER = "Authorization";
    public static final String USERNAME = "USERNAME";
    public static final String PASSWORD = "PASSWORD";

    public void run() {
        JSONObject jsonObject = new JSONObject();
        jsonObject.put("source", "universal");
        jsonObject.put("url", "https://www.walmart.com/ip/Adidas-Moves-Body-Spray-for-Men-2-5-Oz/710726462");
        jsonObject.put("geo_location", "United States");
        jsonObject.put("parse", true);

        Authenticator authenticator = (route, response) -> {
            String credential = Credentials.basic(USERNAME, PASSWORD);
            return response
                    .request()
                    .newBuilder()
                    .header(AUTHORIZATION_HEADER, credential)
                    .build();
        };

        var client = new OkHttpClient.Builder()
                .authenticator(authenticator)
                .readTimeout(180, TimeUnit.SECONDS)
                .build();

        var mediaType = MediaType.parse("application/json; charset=utf-8");
        var body = RequestBody.create(jsonObject.toString(), mediaType);
        var request = new Request.Builder()
                .url("https://realtime.oxylabs.io/v1/queries")
                .post(body)
                .build();

        try (var response = client.newCall(request).execute()) {
            if (response.body() != null) {
                try (var responseBody = response.body()) {
                    System.out.println(responseBody.string());
                }
            }
        } catch (Exception exception) {
            System.out.println("Error: " + exception.getMessage());
        }

        System.exit(0);
    }

    public static void main(String[] args) {
        new Thread(new Main()).start();
    }
}

{
    "source": "universal", 
    "url": "https://www.walmart.com/ip/Adidas-Moves-Body-Spray-for-Men-2-5-Oz/710726462", 
    "geo_location": "United States",
    "parse": true
}

We use synchronous Realtime integration method in our examples. If you would like to use Proxy Endpoint or asynchronous Push-Pull integration, refer to the integration methods section.

Request parameter values

Generic

Parameter Description Default Value

Parameter	Description	Default Value
source	Sets the scraper.	`universal`
url	Direct URL (link) to any page.	-
`render`	Enables JavaScript rendering when set to `html`. More info.	-
`parse`	Returns parsed data when set to `true`.	`false`
`parser_type`	Select parsing template.	`walmart_product_new`, `walmart_search_new`
`callback_url`	URL to your callback endpoint. More info.	-
`user_agent_type`	Device type and browser. The full list can be found here.	`desktop`
`geo_location`	See our guide to using this parameter here.	-

source

Sets the scraper.

universal

url

Direct URL (link) to any page.

render

Enables JavaScript rendering when set to html. More info.

parse

Returns parsed data when set to true.

false

parser_type

Select parsing template.

walmart_product_new,

walmart_search_new

callback_url

URL to your callback endpoint. More info.

user_agent_type

Device type and browser. The full list can be found here.

desktop

geo_location

See our guide to using this parameter here.

- mandatory parameter

Please note that you will scrape Walmart by employing the universal source. To learn about all the various ways you can fine-tune this source, please visit this page.

Structured data

In the following sections, parsed JSON code snippets are shortened where more than one item for the result type is available.

NEW! Walmart product page structured output

{
    "results": [
        {
            "content": {
                "price": {
                    "price": 157.97,
                    "currency": "USD",
                    "price_strikethrough": 199.99
                },
                "rating": {
                    "count": 94,
                    "rating": 4.5
                },
                "seller": {
                    "id": "ED6F630F4BA94318A00A1D0BAACD0A48",
                    "url": "/seller/7648?itemId=701606028&pageName=item&returnUrl=%2Fip%2FApple-iPhone-Xs-64GB-Unlocked-GSM-CDMA-4G-LTE-Phone-w-Dual-12MP-Camera-Gold-Fair-Cosmetics-Fully-Functional%2F701606028",
                    "name": "Kiss Electronics Inc",
                    "catalog_id": "7648",
                    "official_name": "Kiss Electronics Inc"
                },
                "general": {
                    "url": "https://www.walmart.com/ip/Apple-iPhone-Xs-64GB-Unlocked-GSM-CDMA-4G-LTE-Phone-w-Dual-12MP-Camera-Gold-Fair-Cosmetics-Fully-Functional/701606028",
                    "meta": {
                        "sku": "701606028",
                        "gtin": "683346585136"
                    },
                    "badge": "Best seller",
                    "brand": "Apple",
                    "title": "Pre-Owned Apple iPhone XS - Carrier Unlocked - 64GB Gold",
                    "images": [
                        "https://i5.walmartimages.com/seo/Apple-iPhone-Xs-64GB-Unlocked-GSM-CDMA-4G-LTE-Phone-w-Dual-12MP-Camera-Gold-Fair-Cosmetics-Fully-Functional_d6dacc88-10c1-46e0-b528-c626915adadc.4c6907ee5896ccbc68382cb59470a6d8.jpeg?odnHeight=117&odnWidth=117&odnBg=FFFFFF"
                    ],
                    "main_image": "https://i5.walmartimages.com/seo/Apple-iPhone-Xs-64GB-Unlocked-GSM-CDMA-4G-LTE-Phone-w-Dual-12MP-Camera-Gold-Fair-Cosmetics-Fully-Functional_d6dacc88-10c1-46e0-b528-c626915adadc.4c6907ee5896ccbc68382cb59470a6d8.jpeg?odnHeight=640&odnWidth=640&odnBg=FFFFFF",
                    "description": "<p>Super Retina. In Big and Bigger. An all-screen design gives you a large, beautiful canvas for everything you love to do. Custom-built OLED. The OLED panels in iPhone Xs allow for an HDR display with the industry's best color accuracy, true blacks, and remarkable brightness and contrast. They're the sharpest displays, with the highest pixel density, on any Apple device. A new level of water resistance. The most durable glass in a smartphone, sealed and precision-fitted with surgical-grade stainless steel band, helps create a more water-resistant enclosure - up to 2 meters for 30 minutes. iPhone Xs even resists spills from Coffee, Tea, Soda, and more. A whole new level of intelligence. The A12 Bionic, with our next-generation Neural Engine, delivers incredible performance. It uses real-time machine learning to transform the way you experience photos, gaming, augmented reality, and more. Sensors, processors, algorithms, and you. An innovative dual-camera system integrates the ISP, the Neural Engine, and advanced algorithms to unlock new creative possibilities and help you capture incredible photos. A picture is worth a trillion operations. The iPhone Xs dual-camera system harnesses the unprecedented power of the Neural Engine and its ability to perform five trillion operations per second. Together with the Apple-designed ISP, it works like the world's fastest photographer's assistant to help turn your pictures into showstoppers. Security made simple. Face ID reinvent the way we unlock, log in, and pay. Some of our most sophisticated technologies - the True Depth camera system, the Secure Enclave, and the Neural Engine - make it the most secure facial authentication ever in a smartphone. And even faster and easier to use.</p><ul>   <li>Phone is tested, working and functional. May have scruff, scratched, cracks or other minor issues that don’t affect the functionality of phone.</li>   <li>5.8-inch Super AMOLED Capacitive Touchscreen, 1125 x 2436 pixels</li>   <li>iOS, Apple A12 Bionic, Hexa-Core, Apple GPU (4-Core Graphics)</li>   <li>Dual 12MP(f/1.8, 28mm, OIS) &amp; 12MP(f/2.4, 52mm, 2x optical Zoom) Cameras with Quad-LED Dual-Tone Flash &amp; 7MP Front Camera with f/2.2, 32mm</li>   <li>Internal Memory: 64GB, 4GB RAM</li>   <li>IP68 Dust/Water Resistant (Up to 2m for 30 mins), Scratch-Resistant Glass, Oleophobic Coating</li>   <li>Dimensions: 5.65 x 2.79 x 0.30 inches, Weight: 6.24 oz</li>  </ul>"
                },
                "location": {
                    "city": "Sacramento",
                    "state": "CA",
                    "store_id": "3081",
                    "zip_code": "95829"
                },
                 "variations": [
                    {
                        "state": "IN_STOCK",
                        "product_id": "7328JAQF0Y2S",
                        "selected_options": [
                            {
                                "key": "Carrier",
                                "value": "Verizon"
                            },
                            {
                                "key": "Capacity",
                                "value": "256GB"
                            },
                            {
                                "key": "Color",
                                "value": "Desert Titanium"
                            }
                        ]
                    },
                "breadcrumbs": [
                    {
                        "url": "/cp/cell-phones/1105910",
                        "category_name": "Cell Phones"
                    },
                    {
                        "url": "/cp/unlocked-phones/1073085",
                        "category_name": "Unlocked Phones"
                    },
                    {
                        "url": "/cp/gsm-unlocked/8230659",
                        "category_name": "GSM Unlocked"
                    }
                ],
                "fulfillment": {
                    "pickup": false,
                    "delivery": false,
                    "shipping": true,
                    "out_of_stock": false,
                    "free_shipping": true,
                    "pickup_information": "Pickup, Not available",
                    "delivery_information": "Delivery, Not available",
                    "shipping_information": "Shipping, Arrives Oct 18, Free"
                },
                "specifications": [
                    {
                        "key": "Processor Brand",
                        "value": "Apple"
                    },
                    {
                        "key": "Display Technology",
                        "value": "Retina Display"
                    },
                    {
                        "key": "Phone Feature",
                        "value": "Wireless Charging"
                    },
                    ...
                ],
                "parse_status_code": 12000
            },
            "created_at": "2024-09-16 08:09:03",
            "updated_at": "2024-09-16 08:09:06",
            "page": 1,
            "url": "https://www.walmart.com//ip/Apple-iPhone-Xs-64GB-Unlocked-GSM-CDMA-4G-LTE-Phone-w-Dual-12MP-Camera-Gold-Fair-Cosmetics-Fully-Functional/701606028",
            "job_id": "7253339040034008521",
            "is_render_forced": false,
            "status_code": 200,
            "parser_type": "walmart_product_new"
        }
    ]
}

NEW! Walmart search page structured output

{
    "results": [
        {
            "content": {
                "url": "https://www.walmart.com/search?q=adidas",
                "facets": [
                    {
                        "type": "sort",
                        "values": [
                            {
                                "name": "Best Match"
                            },
                            {
                                "name": "Price Low"
                            },
                            {
                                "name": "Price High"
                            },
                            {
                                "name": "Best Seller"
                            }
                        ],
                        "display_name": "Sort by"
                    },
                    ...
                ],
                "results": [
                    {
                        "price": {
                            "price": 31.95,
                            "currency": "USD"
                        },
                        "rating": {
                            "count": 0,
                            "rating": 0
                        },
                        "seller": {
                            "id": "5027DF43EB634E91AEADF0D69DD4E009",
                            "name": "Revel Commerce"
                        },
                        "general": {
                            "pos": 13,
                            "url": "/ip/Adidas-Men-s-California-2-0-Crew-Neck-Short-Sleeve-Tee-T-Shirt/833623567?classType=VARIANT",
                            "image": "https://i5.walmartimages.com/seo/Adidas-Men-s-California-2-0-Crew-Neck-Short-Sleeve-Tee-T-Shirt_1b8e0b00-fdc7-4b88-99fb-9a633bf0227b_1.812a96a559770448397cd828ef1cf68b.jpeg?odnHeight=180&odnWidth=180&odnBg=FFFFFF",
                            "title": "Adidas Men's California 2.0 Crew Neck Short Sleeve Tee T-Shirt",
                            "sponsored": false,
                            "product_id": "833623567",
                            "out_of_stock": false,
                            "section_title": "Results for \"adidas\""
                        },
                        "variants": [
                            {
                                "url": "/ip/Adidas-Men-California-2-0-Tee-S-Black/524412260?classType=undefined&variantFieldId=actual_color",
                                "image": "https://i5.walmartimages.com/asr/f60cd6ff-41fd-484d-b76e-57f6022c2201.eedd632efbb4ce3803e9ef8306190aa3.jpeg?odnHeight=180&odnWidth=180&odnBg=ffffff",
                                "title": "Black/White",
                                "product_id": "524412260"
                            },
                            {
                                "url": "/ip/Adidas-Men-s-California-2-0-Crew-Neck-Short-Sleeve-Tee-T-Shirt/833623567?classType=undefined&variantFieldId=actual_color",
                                "image": "https://i5.walmartimages.com/asr/1b8e0b00-fdc7-4b88-99fb-9a633bf0227b_1.812a96a559770448397cd828ef1cf68b.jpeg?odnHeight=180&odnWidth=180&odnBg=ffffff",
                                "title": "White",
                                "product_id": "833623567"
                            }
                        ],
                        "fulfillment": {
                            "pickup": false,
                            "delivery": false,
                            "shipping": true,
                            "free_shipping": true
                        }
                    },
                    ...
                ],
                "location": {
                    "city": "Sacramento",
                    "state": "CA",
                    "zipcode": "95829",
                    "store_id": "3081"
                },
                "page_details": {
                    "page": 1,
                    "total_results": 11524,
                    "last_visible_page": 25
                },
                "parse_status_code": 12000
            },
            "created_at": "2024-10-16 09:57:40",
            "updated_at": "2024-10-16 09:57:46",
            "page": 1,
            "url": "https://www.walmart.com/search?q=adidas",
            "job_id": "7252256376867528705",
            "is_render_forced": false,
            "status_code": 200,
            "parser_type": "walmart_search_new"
        }
    ]
}

Output data dictionary

Navigate through the details using the right-side navigation or scrolling down the page.

[New] Product

You can select the parser template by using the parser_type parameter. To use the updated Walmart parser, pass the string walmart_product_new as the value.

HTML example

JSON structure

The table below presents a detailed list of each product page element we parse, along with its description and data type. The table also includes some metadata.

Key Description Type

Key	Description	Type
`general`	An object with general product page result details.	object
`price`	Object contains details on product pricing.	object
`rating`	Rating information for the product.	object
`seller`	Information about the seller.	object
`variations` (optional)	List of variations of the product.	array
`breadcrumbs`	Hierarchy of categories leading to the product.	object
`location`	Provides information on the location in which the request was run in.	object
`fulfillment`	Object contains information on product fulfillment options.	object
`specifications`	Array of key-value pairs detailing specific attributes or features of the product.	array
`parse_status_code`	The status code of the parsing job. You can see the parser status codes described here.	integer
`created_at`	The timestamp when the scraping job was created.	timestamp
`updated_at`	The timestamp when the scraping job was finished.	timestamp
`page`	Page number from which the product data was extracted	integer
`url`	URL of the product page on Walmart's website	string
`job_id`	The ID of the job associated with the scraping job.	string
`status_code`	The status code of the scraping job. You can see the scraper status codes described here.	integer
`is_render_forced`	Identifies whether rendering has been forced for this request.	boolean
`parser_type`	Type of parser used for extracting the data (e.g., "walmart_product_new").	string

general

An object with general product page result details.

object

price

Object contains details on product pricing.

object

rating

Rating information for the product.

object

seller

Information about the seller.

object

variations (optional)

List of variations of the product.

array

breadcrumbs

Hierarchy of categories leading to the product.

object

location

Provides information on the location in which the request was run in.

object

fulfillment

Object contains information on product fulfillment options.

object

specifications

Array of key-value pairs detailing specific attributes or features of the product.

array

parse_status_code

The status code of the parsing job. You can see the parser status codes described here.

integer

created_at

The timestamp when the scraping job was created.

timestamp

updated_at

The timestamp when the scraping job was finished.

timestamp

page

Page number from which the product data was extracted

integer

url

URL of the product page on Walmart's website

string

job_id

The ID of the job associated with the scraping job.

string

status_code

The status code of the scraping job. You can see the scraper status codes described here.

integer

is_render_forced

Identifies whether rendering has been forced for this request.

boolean

parser_type

Type of parser used for extracting the data (e.g., "walmart_product_new").

string

General

Key (general) Description Type

Key (general)	Description	Type
`url`	The URL of the product.	string
`main_image`	The URL of the main product image	integer
`images`	Array of URLs to images of the product.	array
`title`	Title or name of the product.	string
`description`	Detailed description of the product.	string
`brand`	The brand of the product.	string
`badge`	Indicator of specific attributes such as promotions, product features, certifications, or brand affiliations.	list of strings
`meta`	Metadata of the product.	object
`meta.sku`	Stock Keeping Unit (SKU) of the product.	string
`meta.gtin`	Global Trade Item Number (GTIN) of the product.	string

url

The URL of the product.

string

main_image

The URL of the main product image

integer

images

Array of URLs to images of the product.

array

title

Title or name of the product.

string

description

Detailed description of the product.

string

brand

The brand of the product.

string

badge

Indicator of specific attributes such as promotions, product features, certifications, or brand affiliations.

list of strings

meta

Metadata of the product.

object

meta.sku

Stock Keeping Unit (SKU) of the product.

string

meta.gtin

Global Trade Item Number (GTIN) of the product.

string

Price

...
"price": {
    "price": 12.49,
    "price_strikethrough": 23.72,
    "currency": "USD"
},
...

Key (price) Description Type

Key (price)	Description	Type
`price`	The current price of the product without any deductions.	integer
`price_strikethrough`	The strikethrough price is either a Was Price, a Bundle Price, or a List Price.	integer
`currency`	The ISO 4217 three-letter code of the currency.	string

price

The current price of the product without any deductions.

integer

price_strikethrough

The strikethrough price is either a Was Price, a Bundle Price, or a List Price.

integer

currency

The ISO 4217 three-letter code of the currency.

string

Rating

...
 "rating": {
    "count": 64,
    "rating": 4.7
},
...

Key (rating) Description Type

Key (rating)	Description	Type
`rating`	Average rating of the product.	float
`count`	Number of ratings for the product.	integer

rating

Average rating of the product.

float

count

Number of ratings for the product.

integer

Seller

...
"seller": {
    "id": "ED6F630F4BA94318A00A1D0BAACD0A48",
    "url": "/seller/7648?itemId=701606028&pageName=item&returnUrl=%2Fip%2FApple-iPhone-Xs-64GB-Unlocked-GSM-CDMA-4G-LTE-Phone-w-Dual-12MP-Camera-Gold-Fair-Cosmetics-Fully-Functional%2F701606028",
    "name": "Kiss Electronics Inc",
    "catalog_id": "7648",
    "official_name": "Kiss Electronics Inc"
},
...

Key (seller) Describtion Type

Key (seller)	Describtion	Type
`name`	Name of the seller.	string
`official_name`	Official registered name of the seller entity.	string
`id`	Unique identifier assigned to the seller by the platform.	string
`url`	The URL that leads to the seller's official website or storefront.	string
`catalog_id`	ID of catalog.	string

name

Name of the seller.

string

official_name

Official registered name of the seller entity.

string

id

Unique identifier assigned to the seller by the platform.

string

url

The URL that leads to the seller's official website or storefront.

string

catalog_id

ID of catalog.

string

Specifications

...
"specifications": [
    ...
    {
        "key": "Brand",
        "value": "LEGO"
    },
    {
        "key": "Age Range",
        "value": "9 Years & Up"
    },
]
...

Key (specifications) Description Type

Key (specifications)	Description	Type
`key`	Specific attribute or characteristic of the product.	string
`value`	Corresponding value or description of the attribute specified by the specifications key.	string

key

Specific attribute or characteristic of the product.

string

value

Corresponding value or description of the attribute specified by the specifications key.

string

Fulfillment

...
"fulfillment": {
                    "pickup": false,
                    "delivery": false,
                    "shipping": true,
                    "out_of_stock": false,
                    "free_shipping": true,
                    "pickup_information": "Pickup, Not available",
                    "delivery_information": "Delivery, Not available",
                    "shipping_information": "Shipping, Arrives Oct 24, Free"
                },
...

Key (fulfillment) Description Type

Key (fulfillment)	Description	Type
`pickup`	Indicates if the product is available to be fulfilled via in-store pickup.	boolean
`pickup_information`	The pickup message, when pickup = true.	string
`delivery`	Indicates if the product is available to be fulfilled via delivery from local store.	boolean
`delivery_information`	The delivery from local store message, when delivery = true.	string
`shipping`	Indicates if the product is available to be fulfilled via home shipping.	boolean
`shipping_information`	The shipping message, if shown.	string
`free_shipping`	Indicates if shipping is free of charge.	boolean
`out_of_stock`	Indicates if the product is currently out of stock.	boolean

pickup

Indicates if the product is available to be fulfilled via in-store pickup.

boolean

pickup_information

The pickup message, when pickup = true.

string

delivery

Indicates if the product is available to be fulfilled via delivery from local store.

boolean

delivery_information

The delivery from local store message, when delivery = true.

string

shipping

Indicates if the product is available to be fulfilled via home shipping.

boolean

shipping_information

The shipping message, if shown.

string

free_shipping

Indicates if shipping is free of charge.

boolean

out_of_stock

Indicates if the product is currently out of stock.

boolean

Variations

...
"variations": [
    {
        "state": "IN_STOCK",
        "product_id": "7328JAQF0Y2S",
        "selected_options": [
            {
                "key": "Color",
                "value": "Black"
            },
]
...

Key (variations) Description Type

Key (variations)	Description	Type
`state`	Availability state of the product variation.	string
`product_id`	Unique identifier for each product variation.	string
`selected_options`	Array containing selected options that define the variation.	array
`selected_options.key`	Key describing the option selected.	string
`selected_options.value`	Value of the option selected.	string

state

Availability state of the product variation.

string

product_id

Unique identifier for each product variation.

string

selected_options

Array containing selected options that define the variation.

array

selected_options.key

Key describing the option selected.

string

selected_options.value

Value of the option selected.

string

Breadcrumbs

... 
"breadcrumbs": [
    {
        "url": "/cp/cell-phones/1105910",
        "category_name": "Cell Phones"
    },
    {
        "url": "/cp/phones-with-plans/1073085",
        "category_name": "Phones With Plans"
    },
    {
        "url": "/cp/postpaid-phones/8230659",
        "category_name": "Postpaid Phones"
    }
    ...
],
...

Key (breadcrumbs) Description Type

Key (breadcrumbs)	Description	Type
`category_name`	The name of the category.	string
`url`	The URL of the category	string

category_name

The name of the category.

string

url

The URL of the category

string

Location

...
"location": {
    "city": "Sacramento",
    "state": "CA",
    "store_id": "8915",
    "zip_code": "95829"
},
...

Key (location) Description Type

Key (location)	Description	Type
`city`	The city the request was run on.	string
`state`	The state the request was run on.	string
`zip_code`	The zip code the request was run on.	string
`store_id`	The ID of the store that the request was run on.	string

city

The city the request was run on.

string

state

The state the request was run on.

string

zip_code

The zip code the request was run on.

string

store_id

The ID of the store that the request was run on.

string

[New] Search

You can select the parser template by using the parser_type parameter. To use the updated Walmart parser, pass the string walmart_search_new as the value.

HTML example

JSON structure

The table below presents a detailed list of each search page element we parse, along with its description and data type. The table also includes some metadata.

Key Description Type

Key	Description	Type
`url`	The search page URL.	string
`facets`	An array containing details of any available search facets (refinements) shown on the search result page.	array
`results`	Search page results.	array
`results.general`	An object with general product details.	object
`results.price`	An object with pricing details of the product.	object
`results.rating`	Object contains details on product rating.	object
`results.seller`	Object contains seller information.	object
`results.variants` (optional)	Array contains a list of product variants.	array
`results.fulfillment`	Object contains details on product fulfillment options.	object
`location`	Provides information on the location in which the request was run in.	object
`page_details`	Object contains data on search query result page.	object
`parse_status_code`	The status code of the parsing job. You can see the parser status codes described here.	integer
`created_at`	The timestamp when the scraping job was created.	timestamp
`updated_at`	The timestamp when the scraping job was finished.	timestamp
`page`	Page number from which the data was extracted	integer
`url`	The search page URL.	string
`job_id`	The ID of the job associated with the scraping job.	string
`status_code`	The status code of the scraping job. You can see the scraper status codes described here.	integer
`is_render_forced`	Identifies whether rendering has been forced for this request.	boolean
`parser_type`	Type of parser used for extracting the data (e.g., "walmart_search_new").	string

url

The search page URL.

string

facets

An array containing details of any available search facets (refinements) shown on the search result page.

array

results

Search page results.

array

results.general

An object with general product details.

object

results.price

An object with pricing details of the product.

object

results.rating

Object contains details on product rating.

object

results.seller

Object contains seller information.

object

results.variants (optional)

Array contains a list of product variants.

array

results.fulfillment

Object contains details on product fulfillment options.

object

location

Provides information on the location in which the request was run in.

object

page_details

Object contains data on search query result page.

object

parse_status_code

The status code of the parsing job. You can see the parser status codes described here.

integer

created_at

The timestamp when the scraping job was created.

timestamp

updated_at

The timestamp when the scraping job was finished.

timestamp

page

Page number from which the data was extracted

integer

url

The search page URL.

string

job_id

The ID of the job associated with the scraping job.

string

status_code

The status code of the scraping job. You can see the scraper status codes described here.

integer

is_render_forced

Identifies whether rendering has been forced for this request.

boolean

parser_type

Type of parser used for extracting the data (e.g., "walmart_search_new").

string

General

...
"general": {
    "pos": 1,
    "url": "/ip/Adidas-Men-s-California-2-0-Crew-Neck-Short-Sleeve-Tee-T-Shirt/833623567?classType=VARIANT",
    "image": "https://i5.walmartimages.com/seo/Adidas-Men-s-California-2-0-Crew-Neck-Short-Sleeve-Tee-T-Shirt_1b8e0b00-fdc7-4b88-99fb-9a633bf0227b_1.812a96a559770448397cd828ef1cf68b.jpeg?odnHeight=180&odnWidth=180&odnBg=FFFFFF",
    "title": "Adidas Men's California 2.0 Crew Neck Short Sleeve Tee T-Shirt",
    "sponsored": true,
    "product_id": "833623567",
    "out_of_stock": false,
    "section_title": "Results for \"adidas\""
},
...

Key (general) Description Type

Key (general)	Description	Type
`pos`	An indicator denoting the position of a given item within the section product is attributed to.	integer
`url`	The URL of the product.	string
`image`	The URL of the main product image.	string
`title`	Title or name of the product.	string
`product_id`	The ID of the product.	string
`sponsored`	Identifies if product is sponsored.	boolean
`badge` (optional)	Deal, popular pick, bestseller, 100+ bought since yesterday	list of strings
`section_title`	The name of the section which product is attributed to in the search page.	string
`out_of_stock`	Indicates if item is out of stock.	boolean

pos

An indicator denoting the position of a given item within the section product is attributed to.

integer

url

The URL of the product.

string

image

The URL of the main product image.

string

title

Title or name of the product.

string

product_id

The ID of the product.

string

sponsored

Identifies if product is sponsored.

boolean

badge (optional)

Deal, popular pick, bestseller, 100+ bought since yesterday

list of strings

section_title

The name of the section which product is attributed to in the search page.

string

out_of_stock

Indicates if item is out of stock.

boolean

Price

...
"price": {
    "price": 1149.99,
    "currency": "USD",
    "price_min": 1149.99
    "price_max": 1399.00
},
...

Key (price) Description Type

Key (price)	Description	Type
`price`	The current price of the product without any deductions.	float
`price_strikethrough`(optional)	The strikethrough price is either a Was Price, a Bundle Price, or a List Price.	float
`currency`	The ISO 4217 three-letter code of the currency.	string
`price_min`(optional)	The minimum price of the product in the case of range pricing.	float
`price_max`(optional)	The maximum price of the product in the case of range pricing.	float

price

The current price of the product without any deductions.

float

price_strikethrough(optional)

The strikethrough price is either a Was Price, a Bundle Price, or a List Price.

float

currency

The ISO 4217 three-letter code of the currency.

string

price_min(optional)

The minimum price of the product in the case of range pricing.

float

price_max(optional)

The maximum price of the product in the case of range pricing.

float

Rating

...
"rating": {
    "count": 428,
    "rating": 4.6
},
...

Key (rating) Description Type

Key (rating)	Description	Type
`rating`	Average rating of the product.	float
`count`	Number of ratings for the product.	integer

rating

Average rating of the product.

float

count

Number of ratings for the product.

integer

Seller

Data not displayed visually.

Key (seller) Description Type

Key (seller)	Description	Type
`name`	Name of the seller.	string
`id`	ID of the seller.	string

name

Name of the seller.

string

id

ID of the seller.

string

Variants

...
"variants": [
    {
        "url": "/ip/Apple-MacBook-Air-13-3-inch-Laptop-Gold-M1-Chip-8GB-RAM-256GB-storage/550880792?classType=undefined&variantFieldId=actual_color",
        "image": "https://i5.walmartimages.com/asr/a9857413-b9fa-4c8d-9f81-7ea4c93889a1.410fd3cb7fe36102bbe2d3dca32a8075.jpeg?odnHeight=180&odnWidth=180&odnBg=ffffff",
        "title": "Gold",
        "product_id": "550880792"
    },
    {
        "url": "/ip/Apple-MacBook-Air-13-3-inch-Laptop-Silver-M1-Chip-8GB-RAM-256GB-storage/715596133?classType=undefined&variantFieldId=actual_color",
        "image": "https://i5.walmartimages.com/asr/056c08d5-2d68-44f2-beb0-dd8a47e2f8e8.2a2a210657937c3c11b37df5be8fa4ad.jpeg?odnHeight=180&odnWidth=180&odnBg=ffffff",
        "title": "Silver",
        "product_id": "715596133"
    },
    {
        "url": "/ip/Apple-MacBook-Air-13-3-inch-Laptop-Space-Gray-M1-Chip-8GB-RAM-256GB-storage/609040889?classType=undefined&variantFieldId=actual_color",
        "image": "https://i5.walmartimages.com/asr/af1d4133-6de9-4bdc-b1c6-1ca8bd0af7a0.c0eb74c31b2cb05df4ed11124d0e255b.jpeg?odnHeight=180&odnWidth=180&odnBg=ffffff",
        "title": "Space Gray",
        "product_id": "609040889"
    }
],
...

Key (variants) Description Type

Key (variants)	Description	Type
`url`	URL of the product variation.	string
`title`	The title of the product variation.	string
`product_id`	The Id of the product variation.	string
`image`	The image of the product variation.	string

url

URL of the product variation.

string

title

The title of the product variation.

string

product_id

The Id of the product variation.

string

image

The image of the product variation.

string

Fulfillment

 ...
"fulfillment": {
    "pickup": true,
    "delivery": true,
    "shipping": true,
    "free_shipping": false
}
...

Key (fulfillment) Description Type

Key (fulfillment)	Description	Type
`pickup`	Indicates if the product is available to be fulfilled via in-store pickup.	boolean
`delivery`	Indicates if the product is available to be fulfilled via delivery from store. Delivery comes from your local store, if available.	boolean
`shipping`	Indicates if the product is available to be fulfilled via home shipping.	boolean
`free_shipping`	Indicates if shipping is free of charge.	boolean

pickup

Indicates if the product is available to be fulfilled via in-store pickup.

boolean

delivery

Indicates if the product is available to be fulfilled via delivery from store.

Delivery comes from your local store, if available.

boolean

shipping

Indicates if the product is available to be fulfilled via home shipping.

boolean

free_shipping

Indicates if shipping is free of charge.

boolean

Facets

... 
"facets": [
    {
        "type": "sort",
        "values": [
            {
                "name": "Best Match"
            },
            {
                "name": "Price Low"
            },
            {
                "name": "Price High"
            },
            {
                "name": "Best Seller"
            }
        ],
        "display_name": "Sort by"
    },
...

Key (facets) Description Type

Key (facets)	Description	Type
`display_name`	The display name of the facet (i.e. the user-facing name).	string
`type`	The facet type.	string
`values`	The facet values array shows the values of the given facet.	array
`values.name`	The facet value name.	string
`values.item_count` (optional)	The number of items available for the specific facet.	integer

display_name

The display name of the facet (i.e. the user-facing name).

string

type

The facet type.

string

values

The facet values array shows the values of the given facet.

array

values.name

The facet value name.

string

values.item_count (optional)

The number of items available for the specific facet.

integer

Location

...
"location": {
    "city": "Sacramento",
    "state": "CA",
    "store_id": "8915",
    "zip_code": "95829"
},
...

Key (location) Description Type

Key (location)	Description	Type
`city`	The city the request was run on.	string
`state`	The state the request was run on.	string
`zip_code`	The zip code the request was run on.	string
`store_id`	The ID of the store that the request was run on.	string

city

The city the request was run on.

string

state

The state the request was run on.

string

zip_code

The zip code the request was run on.

string

store_id

The ID of the store that the request was run on.

string

Page details

 ...
"page_details": {
    "page": 1,
    "total_results": 11524,
    "last_visible_page": 25
},
...

Key (page_details) Description Key

Key (page_details)	Description	Key
`total_results`	The total number of search results shown as being available.	integer
`last_visible_page`	Last page number of search results.	integer
`page`	Page number from which the product data was extracted	integer

total_results

The total number of search results shown as being available.

integer

last_visible_page

Last page number of search results.

integer

page

Page number from which the product data was extracted

integer

[Legacy] Product

Walmart product page structured output

{
    "results": [
        {
            "content": {
                "url": "https://www.walmart.com/ip/LEGO-Harry-Potter-The-Battle-Hogwarts-Building-Toy-Set-Boys-Girls-Ages-9-Up-Features-Buildable-Castle-6-Minifigures-Recreate-Iconic-Scene-76415/2190258783?athcpid=2190258783&athpgid=AthenaItempage&athcgid=null&athznid=si&athieid=v0_eeMjAuMCw5ODAuMCwwLjAyNDAzMzgzMjc2MTE5NDgzLDAuNV8&athstid=CS055%7ECS098&athguid=l5xGoCNzLlgb74imdpM72CsGeMBju_43eKHI&athancid=1864538426&athposb=4&athena=true&adsRedirect=true",
                "meta": {
                    "sku": "2190258783",
                    "gtin": "673419375818"
                },
                "price": 79.95,
                "title": "LEGO Harry Potter The Battle of Hogwarts Building Toy Set, Harry Potter Toy for Boys and Girls Ages 9 and Up, Features a Buildable Castle and 6 Minifigures to Recreate an Iconic Scene, 76415",
                "images": [
                    "https://i5.walmartimages.com/seo/LEGO-Harry-Potter-The-Battle-Hogwarts-Building-Toy-Set-Boys-Girls-Ages-9-Up-Features-Buildable-Castle-6-Minifigures-Recreate-Iconic-Scene-76415_4ad35e37-c39b-4c4f-9739-aa04cdcc36f8.1a266169d5cd0596c09ccebe08c7ed4a.jpeg?odnHeight=117&odnWidth=117&odnBg=FFFFFF",
                    ...
                    "https://i5.walmartimages.com/asr/bb84d409-af5a-4fbe-a21f-e69c9c53ed3e.d41fa49b888dafa033359900c17103e2.jpeg?odnHeight=117&odnWidth=117&odnBg=FFFFFF"
                ],
                "rating": {
                    "count": 64,
                    "rating": 4.7
                },
                "seller": {
                    "id": "F55CDC31AB754BB68FE0B39041159D63",
                    "name": "Walmart.com",
                    "official_name": "Walmart.com"
                },
                "currency": "USD",
                "breadcrumbs": [
                    "Toys",
                    "Building Sets & Blocks",
                    "LEGO",
                    "LEGO Sets for Girls"
                ],
                "description": "Reenact The Battle of Hogwarts from Harry Potter and the Deathly Hallows \u2013 Part 2 with this LEGO Harry Potter toy playset (76415) for boys and girls ages 9 and up. It features a detailed LEGO brick-built section of the Hogwarts Castle building that can be broken apart during battles between Voldemort and Harry Potter in the courtyard. The castle modules can also be rearranged to make the bridge from another memorable location, and this modular building toy set connects with others in the series to create an entire Hogwarts Castle. Bring magical stories and spellbinding action to life with the 6 LEGO minifigures, plus a Nagini figure. The Harry Potter and Voldemort minifigures each have a wand with attachable LEGO elements to create a \u2018spell-casting\u2019 effect, and Neville Longbottom has the Sword of Gryffindor. Let the LEGO Builder app guide your youngster on an intuitive building adventure, allowing them to zoom in and rotate models in 3D, save sets and track their progress.  Contains 730 pieces.<ul>   <li>The Battle of Hogwarts building toy set (76415) \u2013 Build the Hogwarts Castle courtyard and reenact the Voldemort vs. Harry Potter duel from the climax of Harry Potter and the Deathly Hallows \u2013 Part 2</li>   <li>6 LEGO minifigures \u2013 Harry Potter and Voldemort, each with a wand and spell-casting element, Neville Longbottom with the Sword of Gryffindor, Scabior, Molly Weasley and Bellatrix Lestrange</li>   <li>Rebuilds into a bridge \u2013 The castle modules can be rearranged to make a bridge and recreate another iconic location. The set also includes a Nagini figure for creative play</li>   <li>Fun gift idea \u2013 Give this 730-piece buildable LEGO model as a special treat, birthday present or holiday gift to kids aged 9 and up who are into Harry Potter and the Wizarding World</li>   <li>Build, play and display \u2013 This Hogwarts Castle model measures over 11 in. (28 cm) high, 17.5 in. (44 cm) wide and 4.5 in. (11 cm) deep in its basic formation</li>   <li>Modular building toy \u2013 This LEGO Harry Potter toy set is one of a series of modular sets that combine to create your own Hogwarts Castle</li>   <li>A helping hand \u2013 Discover intuitive instructions in the LEGO Builder app where builders can zoom in and rotate models in 3D, track their progress and save sets as they develop new skills</li>  </ul>",
                "out_of_stock": false,
                "free_delivery": true,
                "specifications": [
                    {
                        "key": "Features",
                        "value": "Collectible"
                    },
                    ...
                    {
                        "key": "Assembled Product Dimensions (L x W x H)",
                        "value": "15.04 x 10.31 x 3.70 Inches"
                    }
                ],
                "parse_status_code": 12000
            },
            "created_at": "2024-06-12 12:37:06",
            "updated_at": "2024-06-12 12:37:07",
            "page": 1,
            "url": "https://www.walmart.com/ip/LEGO-Harry-Potter-The-Battle-Hogwarts-Building-Toy-Set-Boys-Girls-Ages-9-Up-Features-Buildable-Castle-6-Minifigures-Recreate-Iconic-Scene-76415/2190258783?athcpid=2190258783&athpgid=AthenaItempage&athcgid=null&athznid=si&athieid=v0_eeMjAuMCw5ODAuMCwwLjAyNDAzMzgzMjc2MTE5NDgzLDAuNV8&athstid=CS055%7ECS098&athguid=l5xGoCNzLlgb74imdpM72CsGeMBju_43eKHI&athancid=1864538426&athposb=4&athena=true&adsRedirect=true",
            "job_id": "7206635626374893569",
            "status_code": 200,
            "parser_type": "walmart_product",
        }
    ]
}

HTML example

JSON structure

The table below presents a detailed list of each product page element we parse, along with its description and data type. The table also includes some metadata.

Key Description Type

Key	Description	Type
`url`	URL of the product page on Walmart's website.	string
`meta`	Metadata related to the product.	object
`meta.sku`	Stock Keeping Unit (SKU) of the product.	string
`meta.gtin`	Global Trade Item Number (GTIN) of the product.	string
`price`	Price of the product.	integer
`title`	Title or name of the product.	string
`images`	Array of URLs to images of the product.	array
`rating`	Rating information for the product.	object
`seller`	Information about the seller.	object
`currency`	Currency in which the price is denominated.	string
`warranty` (optional)	Duration of warranty of the product.	string
`variations` (optional)	List of variations of the product.	array
`breadcrumbs`	Hierarchy of categories leading to the product.	object
`description`	Detailed description of the product.	string
`out_of_stock`	Boolean indicating if the product is currently out of stock.	boolean
`free_delivery`	Boolean indicating if the product qualifies for free delivery.	boolean
`specifications`	Array of key-value pairs detailing specific attributes or features of the product.	array
`parse_status_code`	The status code of the parsing job. You can see the parser status codes described here.	integer
`price_strikethrough` (optional)	Striked-though price of the product.	integer
`created_at`	The timestamp when the scraping job was created.	timestamp
`updated_at`	The timestamp when the scraping job was finished.	timestamp
`page`	Page number from which the product data was extracted	integer
`url`	URL of the product page on Walmart's website	string
`job_id`	The ID of the job associated with the scraping job.	string
`status_code`	The status code of the scraping job. You can see the scraper status codes described here.	integer
`parser_type`	Type of parser used for extracting the data (e.g., "walmart_product").	string

url

URL of the product page on Walmart's website.

string

meta

Metadata related to the product.

object

meta.sku

Stock Keeping Unit (SKU) of the product.

string

meta.gtin

Global Trade Item Number (GTIN) of the product.

string

price

Price of the product.

integer

title

Title or name of the product.

string

images

Array of URLs to images of the product.

array

rating

Rating information for the product.

object

seller

Information about the seller.

object

currency

Currency in which the price is denominated.

string

warranty (optional)

Duration of warranty of the product.

string

variations (optional)

List of variations of the product.

array

breadcrumbs

Hierarchy of categories leading to the product.

object

description

Detailed description of the product.

string

out_of_stock

Boolean indicating if the product is currently out of stock.

boolean

free_delivery

Boolean indicating if the product qualifies for free delivery.

boolean

specifications

Array of key-value pairs detailing specific attributes or features of the product.

array

parse_status_code

The status code of the parsing job. You can see the parser status codes described here.

integer

price_strikethrough (optional)

Striked-though price of the product.

integer

created_at

The timestamp when the scraping job was created.

timestamp

updated_at

The timestamp when the scraping job was finished.

timestamp

page

Page number from which the product data was extracted

integer

url

URL of the product page on Walmart's website

string

job_id

The ID of the job associated with the scraping job.

string

status_code

The status code of the scraping job. You can see the scraper status codes described here.

integer

parser_type

Type of parser used for extracting the data (e.g., "walmart_product").

string

Rating

"rating": {
    "count": 64,
    "rating": 4.7
},

Key (rating) Description Type

Key (rating)	Description	Type
`count`	Number of ratings the product has.	integer
`rating`	Average rating of the product.	integer

count

Number of ratings the product has.

integer

rating

Average rating of the product.

integer

Seller

...            
 "seller": {
    "id": "F55CDC31AB754BB68FE0B39041159D63",
    "name": "Walmart.com",
    "official_name": "Walmart.com"
},
...

Key (seller) Description Type

Key (seller)	Description	Type
`id`	Unique identifier assigned to the seller by the platform.	string
`url` (optional)	The URL that leads to the seller's official website or storefront.	string
`name`	Name of the seller.	string
`catalog_name` (optional)	Specific name or identifier used internally within the seller's catalog or system.	string
`official_name`	Official registered name of the seller entity.	string

id

Unique identifier assigned to the seller by the platform.

string

url (optional)

The URL that leads to the seller's official website or storefront.

string

name

Name of the seller.

string

catalog_name (optional)

Specific name or identifier used internally within the seller's catalog or system.

string

official_name

Official registered name of the seller entity.

string

Specifications

...            
   "specifications": [
    {
        "key": "Features",
        "value": "Collectible"
    },
    {
        "key": "Brand",
        "value": "LEGO"
    },
    {
        "key": "Age Range",
        "value": "9 Years & Up"
    },
    {
        "key": "Character",
        "value": "Scabior, Harry Potter, Neville Longbottom, Bellatrix Lestrange, Molly Weasley, Voldemort"
    },
    {
        "key": "Product Line",
        "value": "LEGO Harry Potter"
    },
    {
        "key": "Theme",
        "value": "LEGO Harry Potter"
    },
    {
        "key": "Manufacturer",
        "value": "LEGO System Inc"
    },
    {
        "key": "Material",
        "value": "Plastic"
    },
    {
        "key": "Color",
        "value": "Multicolor"
    },
    {
        "key": "Assembled Product Weight",
        "value": "2.37 lb"
    },
    {
        "key": "Assembled Product Dimensions (L x W x H)",
        "value": "15.04 x 10.31 x 3.70 Inches"
    }
],

...

Key (specifications) Description Type

Key (specifications)	Description	Type
`key`	Specific attribute or characteristic of the product.	string
`value`	Corresponding value or description of the attribute specified by the specifications key.	string

key

Specific attribute or characteristic of the product.

string

value

Corresponding value or description of the attribute specified by the specifications key.

string

Variations

...            
"variations": [
    {
        "state": "IN_STOCK",
        "product_id": "6DAQRT9DNA1X",
        "selected_options": [
            {
                "key": "Color",
                "value": "Midnight"
            }
        ]
    },
    {
        "state": "OUT_OF_STOCK",
        "product_id": "1A1AC6PUGGHP",
        "selected_options": [
            {
                "key": "Color",
                "value": "Red"
            }
        ]
    },
    {
        "state": "IN_STOCK",
        "product_id": "1FV2WPCN4T2V",
        "selected_options": [
            {
                "key": "Color",
                "value": "Starlight"
            }
        ]
    }
],
...

Key (variations) Description Type

Key (variations)	Description	Type
`state`	Availability state of the product variation.	string
`product_id`	Unique identifier for each product variation.	string
`selected_options`	Array containing selected options that define the variation.	array
`selected_options.key`	Key describing the option selected.	string
`selected_options.value`	Value of the option selected.	string

state

Availability state of the product variation.

string

product_id

Unique identifier for each product variation.

string

selected_options

Array containing selected options that define the variation.

array

selected_options.key

Key describing the option selected.

string

selected_options.value

Value of the option selected.

string

[Legacy] Search

Walmart search page structured output

{
    "results": [
        {
            "content": {
                "url": "https://www.walmart.com/search?q=adidas+shoes",
                "organic": [
                    {
                        "url": "/ip/adidas-Lite-Racer-Adapt-4-0-Running-Shoes-Grey-Grey-Black-5-US-Unisex-Big-Kid/458707825",
                        "image": "https://i5.walmartimages.com/asr/52813b06-1355-4c4d-88ce-3505aebab6ca.aa96549fc1b4dd51be80fe1132584171.jpeg?odnHeight=180&odnWidth=180&odnBg=ffffff",
                        "price": {
                            "price": 77.27,
                            "currency": "$"
                        },
                        "title": "adidas Lite Racer Adapt 4.0 Running Shoes, Grey/Grey/Black, 5 US Unisex Big Kid",
                        "rating": {
                            "count": 23,
                            "rating": 4.8
                        },
                        "seller": {
                            "name": "Tartazo Surplus LLC"
                        },
                        "category": "Results for \"adidas shoes\"",
                        "product_id": "458707825"
                    },
                    {
                        "url": "/ip/PUMA-Women-s-Platform-Shoes-White-Multicolor-Mod-38842004-White-22-5-cm/5136084803",
                        "image": "https://i5.walmartimages.com/seo/PUMA-Women-s-Platform-Shoes-White-Multicolor-Mod-38842004-White-22-5-cm_4544be6c-1597-4c3a-84a9-62a15bf27d7d.4f2bc672565dfccc096a00cbe5b4b465.jpeg?odnHeight=180&odnWidth=180&odnBg=FFFFFF",
                        "price": {
                            "price": 39.99,
                            "currency": "$"
                        },
                        "title": "PUMA Women's Platform Shoes White/Multicolor Mod. 38842004, White, 22.5 cm",
                        "rating": {
                            "count": 0,
                            "rating": 0
                        },
                        "seller": {
                            "name": "La Via"
                        },
                        "category": "Results for \"adidas shoes\"",
                        "variants": [
                            {
                                "url": "/ip/PUMA-Karmen-Rebelle-Jr-Sneaker-4/5335437116?variantFieldId=shoe_size",
                                "title": "4",
                                "product_id": "5335437116"
                            },
                            {
                                "url": "/ip/PUMA-Women-s-Platform-Shoes-White-Multicolor-Mod-38842004-White-22-5-cm/5136084803?variantFieldId=shoe_size",
                                "title": "4.5",
                                "product_id": "5136084803"
                            }
                        ],
                        "product_id": "5136084803"
                    },
                    ...
                    {
                        "url": "/ip/Disney-Toddler-Girl-Bluey-Bingo-High-Top-Sneakers/1296727365",
                        "image": "https://i5.walmartimages.com/seo/Disney-Toddler-Girl-Bluey-Bingo-High-Top-Sneakers_312ba46b-fd02-4f9c-aa58-75015e32575f.f226e2d283bebdba2b6ff922476e0cbc.jpeg?odnHeight=180&odnWidth=180&odnBg=FFFFFF",
                        "price": {
                            "price": 18.98,
                            "currency": "$"
                        },
                        "title": "Disney Toddler Girl Bluey & Bingo High Top Sneakers",
                        "rating": {
                            "count": 540,
                            "rating": 4.7
                        },
                        "seller": {
                            "name": "Walmart.com"
                        },
                        "category": "Explore related products",
                        "variants": [
                            {
                                "url": "/ip/Disney-Bluey-Toddler-Girls-Bluey-and-Bingo-Hi-Top-Lace-up-Sneakers-Sizes-5-10/5001024819?variantFieldId=shoe_size",
                                "title": "1 Toddler",
                                "product_id": "5001024819"
                            },
                            ...
                        ],
                        "product_id": "1296727365"
                    }
                ],
                "total_results": 330,
                "last_visible_page": 9,
                "parse_status_code": 12000
            },
            "created_at": "2024-06-12 11:33:48",
            "updated_at": "2024-06-12 11:33:50",
            "page": 1,
            "url": "https://www.walmart.com/search?q=adidas+shoes",
            "job_id": "7206619699323365377",
            "status_code": 200,
            "parser_type": "walmart_search",
        }
    ]
}

HTML example

JSON structure

The table below presents a detailed list of each search results page element we parse, along with its description and data type. The table also includes some metadata.

Key Description Type

Key	Description	Type
`url`	URL of the Walmart search query.	string
`organic`	List of organic search results.	array
`total_results`	Total number of search results.	integer
`last_visible_page`	Last page number of search results.	integer
`parse_status_code`	The status code of the parsing job. You can see the parser status codes described here.	integer
`created_at`	The timestamp when the scraping job was created.	timestamp
`updated_at`	The timestamp when the scraping job was finished.	timestamp
`status_code`	The status code of the scraping job. You can see the scraper status codes described here.	integer
`job_id`	The ID of the job associated with the scraping job.	string

url

URL of the Walmart search query.

string

organic

List of organic search results.

array

total_results

Total number of search results.

integer

last_visible_page

Last page number of search results.

integer

parse_status_code

The status code of the parsing job. You can see the parser status codes described here.

integer

created_at

The timestamp when the scraping job was created.

timestamp

updated_at

The timestamp when the scraping job was finished.

timestamp

status_code

The status code of the scraping job. You can see the scraper status codes described here.

integer

job_id

The ID of the job associated with the scraping job.

string

Organic

{
    "url": "/ip/PUMA-Women-s-Platform-Shoes-White-Multicolor-Mod-38842004-White-22-5-cm/5136084803",
    "image": "https://i5.walmartimages.com/seo/PUMA-Women-s-Platform-Shoes-White-Multicolor-Mod-38842004-White-22-5-cm_4544be6c-1597-4c3a-84a9-62a15bf27d7d.4f2bc672565dfccc096a00cbe5b4b465.jpeg?odnHeight=180&odnWidth=180&odnBg=FFFFFF",
    "price": {
        "price": 39.99,
        "currency": "$"
    },
    "title": "PUMA Women's Platform Shoes White/Multicolor Mod. 38842004, White, 22.5 cm",
    "rating": {
        "count": 0,
        "rating": 0
    },
    "seller": {
        "name": "La Via"
    },
    "category": "Results for \"adidas shoes\"",
    "variants": [
        {
            "url": "/ip/PUMA-Karmen-Rebelle-Jr-Sneaker-4/5335437116?variantFieldId=shoe_size",
            "title": "4",
            "product_id": "5335437116"
        },
        {
            "url": "/ip/PUMA-Women-s-Platform-Shoes-White-Multicolor-Mod-38842004-White-22-5-cm/5136084803?variantFieldId=shoe_size",
            "title": "4.5",
            "product_id": "5136084803"
        }
    ],
    "product_id": "5136084803"
},

Key (organic) Description Type

Key (organic)	Description	Type
`url`	URL of the product.	string
`badge` (optional)	Indicator of specific attributes such as promotions, product features, certifications, or brand affiliations.	string
`image`	URL of the image for the product.	string
`price`	Price information for the product.	object
`price.price`	Price of the product.	integer
`price.currency`	Currency symbol.	string
`title`	Title or name of the product.	string
`rating`	Rating information for the product.	object
`rating.count`	Number of ratings for the product.	integer
`rating.rating`	Average rating of the product.	integer
`seller`	Seller information.	object
`seller.name`	Name of the seller.	string
`category`	Category description.	string
`variants`	List of product variants.	array

url

URL of the product.

string

badge (optional)

Indicator of specific attributes such as promotions, product features, certifications, or brand affiliations.

string

image

URL of the image for the product.

string

price

Price information for the product.

object