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

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

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

# 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

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

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

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

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

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

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

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

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

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

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

PreviousURL NextTarget

Last updated 4 months ago