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.

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_ecommerce", 
        "url": "https://www.walmart.com/ip/Adidas-Moves-Body-Spray-for-Men-2-5-Oz/710726462", 
        "geo_location": "United States",
        "parse": true
    }'

We use Realtime integration method in our examples. If you would like to use some other integration method in your request (e.g. Push-Pull or Proxy Endpoint), refer to the integration methods section.

Request parameter values

Generic

Parameter
Description
Default Value

source

Sets the scraper.

universal_ecommerce

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

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_ecommerce 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.

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",
        }
    ]
}
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",
        }
    ]
}

Output data dictionary

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

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

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

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

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

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

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

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

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

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

Last updated