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

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
    }'

Python

import requests
from pprint import pprint


# Structure payload.
payload = {
    '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,
}

# 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())

Node.js

const https = require("https");

const username = "USERNAME";
const password = "PASSWORD";
const body = {
    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,
};

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();

HTTP

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

https://realtime.oxylabs.io/v1/queries?source=universal_ecommerce&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

<?php

$params = array(
    '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
);

$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);

Golang

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_ecommerce",
		"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))
}

C#

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_ecommerce",
                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);
        }
    }
}

Java

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_ecommerce");
        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();
    }
}

JSON

{
    "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		-
parse	Returns parsed data when set to true.	false
callback_url		-
user_agent_type		desktop
geo_location		-

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