产品

通过产品 ID 提取 Walmart 产品页的解析数据，包括价格、评分、卖家信息、规格、变体、履约选项、面包屑导航等。

该 walmart_product source 旨在检索 Walmart 商品结果页面。我们可以返回任何你想要的 Walmart 页面 HTML。此外，我们还可以提供 Walmart 商品页面的结构化（解析后）输出.

请求示例

下面的示例说明如何获取解析后的 Walmart 商品页面结果。

cURL

curl 'https://realtime.oxylabs.io/v1/queries' \\
--user 'USERNAME:PASSWORD' \\
-H 'Content-Type: application/json' \\
-d '{
        "source": "walmart_product", 
        "product_id": "15296401808",
        "parse": true
    }'

Python

import requests
from pprint import pprint


# 结构化载荷。
payload = {
    'source': 'walmart_product',
    'product_id': '15296401808',
    'parse': True,
}

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

# 不会返回包含作业状态和结果 url 的响应，而是返回
# 包含结果的 JSON 响应。
pprint(response.json())

Node.js

const https = require("https");

const username = "USERNAME";
const password = "PASSWORD";
const body = {
    source: "walmart_product",
    product_id: "15296401808",
    解析：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=walmart_product&product_id=15296401808&parse=true&access_token=12345abcde

PHP

<?php

$params = array(
    'source' => 'walmart_product',
    'product_id' => '15296401808',
    '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":       "walmart_product",
		"product_id":   "15296401808",
		"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 = "walmart_product",
                product_id = "15296401808",
                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", "walmart_product");
        jsonObject.put("product_id", "15296401808");
        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": "walmart_product", 
    "product_id": "15296401808", 
    "parse": true
}

我们在示例中使用同步 Realtime 集成方法。如果您想使用 Proxy Endpoint 或异步 Push-Pull 集成，请参阅 集成方法 部分。

请求参数值

通用

参数	描述	默认值
source	设置抓取器。	walmart_product
product_id	Walmart 商品 ID。	-
render	设置为时启用 JavaScript 渲染 html. 更多信息.	-
解析	设置为以下值时返回解析后的数据： true.	false
callback_url	回调端点的 URL。 更多信息	-
user_agent_type	设备类型和浏览器。完整列表可在 此处.	desktop

- 必填参数

本地化

根据特定商店、配送地点调整结果。Walmart 商店 ID 列表请见这里：

www_walmart_com_stores.csv

294KB

打开

你还可以在这里找到 Walmart 商店的官方页面 此处.

参数	描述	类型
domain	Walmart 的域名本地化。可用值： com, com.mx, ca, co.cr。默认： com.	字符串
fulfillment_type	设置履约类型。支持的值： pickup, delivery, shipping.	字符串
delivery_zip	设置配送到达地点。	字符串
store_id	设置商店位置。	字符串

履约类型参数的可用性因 Walmart 域名而异：

域名	支持的履约类型
walmart.com	pickup, delivery, shipping
walmart.com.mx	pickup, delivery
walmart.ca	pickup, delivery
walmart.co.cr	pickup

国际 store_id 列表，请参见下面的文件：

www_walmart_com_mx_stores.csv

38KB

打开

www_walmart_ca_stores.csv

24KB

打开

walmart_co_cr_stores.json

126B

打开

如果目标商店离给定邮政编码太远，我们将尝试使用目标商店的邮政编码；否则位置将无法正确设置。如果我们无法设置 delivery_zip - Walmart 将返回默认结果，不进行门店定位。

结构化数据

在以下部分中，当某个结果类型有多个项目可用时，已将解析后的 JSON 代码片段缩短。

Walmart 商品页面结构化输出

{
    "results": [
        {
            "content": {
                "price": {
                    "price": 157.97,
                    "currency": "USD",
                    "price_strikethrough": 199.99
                },
                "rating": {
                    "count": 94,
                    "rating": 4.5
                },
                "seller": {
                    "id": "ED6F630F4BA94318A00A1D0BAACD0A48",
                    "url": "/seller/7648?itemId=701606028&pageName=item&returnUrl=%2Fip%2FApple-iPhone-Xs-64GB-Unlocked-GSM-CDMA-4G-LTE-Phone-w-Dual-12MP-Camera-Gold-Fair-Cosmetics-Fully-Functional%2F701606028",
                    "name": "Kiss Electronics Inc",
                    "catalog_id": "7648",
                    "official_name": "Kiss Electronics Inc"
                },
                "general": {
                    "url": "https://www.walmart.com/ip/Apple-iPhone-Xs-64GB-Unlocked-GSM-CDMA-4G-LTE-Phone-w-Dual-12MP-Camera-Gold-Fair-Cosmetics-Fully-Functional/701606028",
                    "meta": {
                        "sku": "701606028",
                        "gtin": "683346585136"
                    },
                    "badge": "Best seller",
                    "brand": "Apple",
                    "title": "Pre-Owned Apple iPhone XS - Carrier Unlocked - 64GB Gold",
                    "images": [
                        "https://i5.walmartimages.com/seo/Apple-iPhone-Xs-64GB-Unlocked-GSM-CDMA-4G-LTE-Phone-w-Dual-12MP-Camera-Gold-Fair-Cosmetics-Fully-Functional_d6dacc88-10c1-46e0-b528-c626915adadc.4c6907ee5896ccbc68382cb59470a6d8.jpeg?odnHeight=117&odnWidth=117&odnBg=FFFFFF"
                    ],
                    "main_image": "https://i5.walmartimages.com/seo/Apple-iPhone-Xs-64GB-Unlocked-GSM-CDMA-4G-LTE-Phone-w-Dual-12MP-Camera-Gold-Fair-Cosmetics-Fully-Functional_d6dacc88-10c1-46e0-b528-c626915adadc.4c6907ee5896ccbc68382cb59470a6d8.jpeg?odnHeight=640&odnWidth=640&odnBg=FFFFFF",
                    "description": "<p>超视网膜。更大，更出色。全屏设计为你喜爱的一切提供了一个大而美丽的画布。定制 OLED。iPhone Xs 中的 OLED 面板带来 HDR 显示，具备业界最佳的色彩准确度、真正的黑色以及出色的亮度和对比度。它们是 Apple 设备中最锐利、像素密度最高的显示屏。更高等级的防水性能。智能手机中最耐用的玻璃，与手术级不锈钢边框密封并精密贴合，帮助打造更强的防水外壳——最长可达 2 米，持续 30 分钟。iPhone Xs 甚至可以抵御咖啡、茶、汽水等液体泼溅。全新层级的智能。A12 Bionic 及新一代神经网络引擎带来惊人的性能。它使用实时机器学习，改变你体验照片、游戏、增强现实等内容的方式。传感器、处理器、算法，以及你。创新的双摄像头系统集成了 ISP、神经网络引擎和高级算法，释放新的创作可能，帮助你拍出惊艳照片。一张照片胜过万亿次运算。iPhone Xs 双摄像头系统利用神经网络引擎前所未有的强大能力，以及每秒五万亿次运算的处理能力。配合 Apple 设计的 ISP，它就像世界上最快的摄影助手，帮助把你的照片变成吸睛之作。安全，变得简单。Face ID 重新定义了解锁、登录和支付的方式。我们最先进的一些技术——True Depth 摄像头系统、Secure Enclave 和神经网络引擎——使其成为智能手机中前所未有的最安全面部认证方式，而且使用起来更快、更简单。</p><ul>   <li>手机已测试，工作正常且可使用。可能有磨损、划痕、裂痕或其他不影响手机功能的轻微问题。</li>   <li>5.8 英寸 Super AMOLED 电容式触摸屏，1125 x 2436 像素</li>   <li>iOS、Apple A12 Bionic、六核、Apple GPU（4 核图形）</li>   <li>双 12MP(f/1.8, 28mm, OIS) 和 12MP(f/2.4, 52mm, 2x optical Zoom) 摄像头，配备四 LED 双色闪光灯，以及 f/2.2, 32mm 的 7MP 前置摄像头</li>   <li>内部存储：64GB，4GB RAM</li>   <li>IP68 防尘/防水（最长 2 米，30 分钟）、防刮玻璃、疏油涂层</li>   <li>尺寸：5.65 x 2.79 x 0.30 英寸，重量：6.24 盎司</li>  </ul>"
                },
                "location": {
                    "city": "Sacramento",
                    "state": "CA",
                    "store_id": "3081",
                    "zip_code": "95829"
                },
                 "variations": [
                    {
                        "state": "IN_STOCK",
                        "product_id": "7328JAQF0Y2S",
                        "selected_options": [
                            {
                                "key": "Carrier",
                                "value": "Verizon"
                            },
                            {
                                "key": "Capacity",
                                "value": "256GB"
                            },
                            {
                                "key": "Color",
                                "value": "Desert Titanium"
                            }
                        ]
                    },
                "breadcrumbs": [
                    {
                        "url": "/cp/cell-phones/1105910",
                        "category_name": "Cell Phones"
                    },
                    {
                        "url": "/cp/unlocked-phones/1073085",
                        "category_name": "Unlocked Phones"
                    },
                    {
                        "url": "/cp/gsm-unlocked/8230659",
                        "category_name": "GSM Unlocked"
                    }
                ],
                "fulfillment": {
                    "pickup": false,
                    "delivery": false,
                    "shipping": true,
                    "out_of_stock": false,
                    "free_shipping": true,
                    "pickup_information": "Pickup, Not available",
                    "delivery_information": "Delivery, Not available",
                    "shipping_information": "Shipping, Arrives Oct 18, Free"
                },
                "specifications": [
                    {
                        "key": "Processor Brand",
                        "value": "Apple"
                    },
                    {
                        "key": "Display Technology",
                        "value": "Retina Display"
                    },
                    {
                        "key": "Phone Feature",
                        "value": "Wireless Charging"
                    },
                    ...
                ],
                "parse_status_code": 12000
            },
            "created_at": "2024-09-16 08:09:03",
            "updated_at": "2024-09-16 08:09:06",
            "page": 1,
            "url": "https://www.walmart.com//ip/Apple-iPhone-Xs-64GB-Unlocked-GSM-CDMA-4G-LTE-Phone-w-Dual-12MP-Camera-Gold-Fair-Cosmetics-Fully-Functional/701606028",
            "job_id": "7253339040034008521",
            "is_render_forced": false,
            "status_code": 200,
            "parser_type": "walmart_product_new"
        }
    ]
}

输出数据字典

HTML 示例

JSON 结构

下表详细列出了我们解析的每个商品页面元素，以及对应的描述和数据类型。表中还包含一些元数据。

键	描述	类型
通用	包含通用商品页面结果详情的对象。	对象
price	对象包含商品定价的详细信息。	对象
rating	商品的评分信息。	对象
seller	关于卖家的信息。	对象
变体 （可选）	商品变体列表。	数组
面包屑导航	通向商品的分类层级。	对象
location	提供请求运行时所在位置的信息。	对象
履约	对象包含商品履约选项的信息。	对象
规格	包含用于详细说明商品特定属性或特征的键值对数组。	数组
parse_status_code	解析任务的状态码。你可以查看所描述的解析器状态码 此处.	整数
创建时间	抓取任务创建时的时间戳。	时间戳
更新时间	抓取任务完成时的时间戳。	时间戳
page	提取商品数据的页码	整数
url	Walmart 网站上商品页面的 URL	字符串
任务ID	与该抓取任务关联的任务 ID。	字符串
状态码	抓取任务的状态码。你可以查看所描述的抓取器状态码 此处.	整数
is_render_forced	指示此请求是否强制渲染。	布尔值
parser_type	用于提取数据的解析器类型（例如，"walmart_product_new"）。	字符串

常规

键（通用）	描述	类型
url	商品的 URL。	字符串
main_image	主商品图片的 URL	整数
images	商品图片 URL 数组。	数组
title	商品的标题或名称。	字符串
description	商品的详细描述。	字符串
品牌	商品的品牌。	字符串
徽章	促销、商品特性、认证或品牌关联等特定属性的指示器。	字符串列表
元数据	商品的元数据。	对象
meta.sku	商品的库存量单位（SKU）。	字符串
meta.gtin	商品的全球贸易项目代码（GTIN）。	字符串

价格

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

键（价格）	描述	类型
price	商品当前价格，不含任何折扣。	浮点数
price_strikethrough	删除线价格可以是原价、组合价或目录价。	浮点数
货币	商品价格的 ISO 4217 三字母货币代码。	字符串

评分

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

键（评分）	描述	类型
rating	商品的平均评分。	浮点数
数量	商品的评分数量。	整数

卖家

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

键（卖家）	描述	类型
姓名	卖家名称。	字符串
official_name	卖家实体的官方注册名称。	字符串
id	平台分配给卖家的唯一标识符。	字符串
url	指向卖家官方网站或店铺的 URL。	字符串
catalog_id	目录 ID。	字符串

规格

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

键（规格）	描述	类型
键	商品的特定属性或特征。	字符串
值	规格键所对应的属性值或描述。	字符串

履约

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

键（履约）	描述	类型
pickup	指示商品是否可通过门店自提履约。	布尔值
pickup_information	当 pickup = true 时的自提信息。	字符串
delivery	指示商品是否可通过本地门店配送履约。	布尔值
delivery_information	当 delivery = true 时的本地门店配送信息。	字符串
shipping	指示商品是否可通过送货上门履约。	布尔值
shipping_information	显示时的配送信息。	字符串
free_shipping	指示是否免运费。	布尔值
out_of_stock	指示商品当前是否缺货。	布尔值

变体

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

键（变体）	描述	类型
状态	商品变体的可用状态。	字符串
product_id	每个商品变体的唯一标识符。	字符串
selected_options	包含定义该变体的已选选项的数组。	数组
selected_options.key	描述所选选项的键。	字符串
selected_options.value	所选选项的值。	字符串

面包屑导航

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

键（面包屑导航）	描述	类型
category_name	分类名称。	字符串
url	分类的 URL	字符串

位置

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

键（位置）	描述	类型
城市	请求运行所在的城市。	字符串
状态	请求运行所在的州。	字符串
邮政编码	请求运行所在的邮政编码。	字符串
store_id	请求运行所在商店的 ID。	字符串