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",
"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
- 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.
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.
Rating
"rating": {
"count": 64,
"rating": 4.7
},
Seller
...
"seller": {
"id": "F55CDC31AB754BB68FE0B39041159D63",
"name": "Walmart.com",
"official_name": "Walmart.com"
},
...
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"
}
],
...
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"
}
]
}
],
...
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.
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"
},
Last updated