产品

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

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

请求示例

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

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

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

const https = require("https");

const username = "USERNAME";
const password = "PASSWORD";
const body = {
    source: "walmart_product",
    product_id: "15296401808",
    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();

# 你提交的整个字符串必须进行 URL 编码。

https://Realtime.oxylabs.io/v1/queries?source=walmart_product&product_id=15296401808&parse=true&access_token=12345abcde

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

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

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

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

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

请求参数值

通用

参数

说明

默认值

source

设置爬虫。

walmart_product

product_id

Walmart 商品 ID。

render

设置为 html. 更多信息.

parse

设置为 true.

false

callback_url

您的回调端点 URL。 更多信息

user_agent_type

设备类型和浏览器。完整列表可在这里.

desktop

- 必填参数

本地化

根据特定门店、送货地点调整结果。Walmart 门店 ID 列表请见：

294KB

www_walmart_com_stores.csv

打开

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

参数

说明

类型

域名

Walmart 的域名本地化。可用值： com, com.mx, ca, co.cr. 默认： com.

字符串

fulfillment_type

设置履约类型。支持的值： 自提, 配送, shipping.

字符串

delivery_zip

设置收货地点。

字符串

store_id

设置门店位置。

字符串

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

域名

支持的履约类型

walmart.com

自提, 配送, shipping

walmart.com.mx

自提, 配送

walmart.ca

自提, 配送

walmart.co.cr

自提

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

38KB

www_walmart_com_mx_stores.csv

打开

24KB

www_walmart_ca_stores.csv

打开

126B

walmart_co_cr_stores.json

打开

如果目标商店距离给定邮政编码太远，我们将尝试使用目标商店的邮政编码，否则位置将无法正确设置。如果我们无法设置 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": "畅销品",
                    "brand": "Apple",
                    "title": "二手 Apple iPhone XS - 运营商解锁 - 64GB 金色",
                    "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>Super Retina。更大更震撼。全面屏设计为你喜爱的所有内容提供宽大而美丽的画布。专门打造的 OLED。iPhone Xs 中的 OLED 面板支持 HDR 显示，具备业界顶尖的色彩准确度、纯正的黑色表现以及出色的亮度和对比度。它们是 Apple 设备中最清晰、像素密度最高的显示屏。全新一层防水能力。智能手机中最耐用的玻璃，与手术级不锈钢边框密封并精密贴合，帮助打造更强的防水机身——最深可达 2 米，最长 30 分钟。iPhone Xs 甚至可抵御咖啡、茶、汽水等液体泼溅。智能迈入全新层级。A12 Bionic 搭载我们下一代 Neural Engine，带来惊人的性能。它使用实时机器学习，改变你体验照片、游戏、增强现实等内容的方式。传感器、处理器、算法，还有你。创新的双摄系统集成了 ISP、Neural Engine 和先进算法，开启全新的创意可能，并帮助你拍出令人惊叹的照片。千亿次运算只为一张照片。iPhone Xs 双摄系统借助 Neural Engine 前所未有的强大性能，以及其每秒执行五万亿次运算的能力。它与 Apple 设计的 ISP 协同工作，就像世界上最快的摄影助理，帮助把你的照片变成焦点。安全，简单实现。Face ID 重新定义了解锁、登录和支付方式。我们最先进的一些技术——True Depth 相机系统、Secure Enclave 和 Neural Engine——让它成为智能手机上最安全的面部认证方式，而且使用起来更快、更简单。</p><ul>   <li>手机已测试，工作正常且功能完好。可能有磨痕、划痕、裂痕或其他不影响手机功能的轻微问题。</li>   <li>5.8 英寸 Super AMOLED 电容式触摸屏，1125 x 2436 像素</li>   <li>iOS、Apple A12 Bionic、六核、Apple GPU（4 核图形）</li>   <li>双 1200 万像素（f/1.8，28mm，OIS）和 1200 万像素（f/2.4，52mm，2 倍光学变焦）摄像头，配四 LED 双色温闪光灯，以及 f/2.2、32mm 的 700 万像素前置摄像头</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": "手机"
                    },
                    {
                        "url": "/cp/unlocked-phones/1073085",
                        "category_name": "解锁手机"
                    },
                    {
                        "url": "/cp/gsm-unlocked/8230659",
                        "category_name": "GSM 解锁"
                    }
                ],
                "fulfillment": {
                    "pickup": false,
                    "delivery": false,
                    "shipping": true,
                    "out_of_stock": false,
                    "free_shipping": true,
                    "pickup_information": "自提，暂无",
                    "delivery_information": "送货，暂无",
                    "shipping_information": "配送，10 月 18 日送达，免运费"
                },
                "specifications": [
                    {
                        "key": "Processor Brand",
                        "value": "Apple"
                    },
                    {
                        "key": "Display Technology",
                        "value": "Retina 显示屏"
                    },
                    {
                        "key": "Phone Feature",
                        "value": "无线充电"
                    },
                    ...
                ],
                "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 结构

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

键

说明

类型

通用

包含通用商品页结果详情的对象。

对象

价格

对象包含商品价格信息。

对象

rating

商品的评分信息。

对象

seller

关于卖家的信息。

对象

variations （可选）

商品变体列表。

数组

面包屑导航

通往商品的分类层级。

对象

location

提供请求运行位置的信息。

对象

履约

对象包含商品履约选项信息。

对象

specifications

用于详细说明商品特定属性或特征的键值对数组。

数组

parse_status_code

解析任务的状态码。你可以查看所描述的解析器状态码这里.

整数

created_at

抓取任务创建时的时间戳。

timestamp

updated_at

抓取任务完成时的时间戳。

timestamp

page

提取产品数据的页码

整数

url

Walmart 网站上商品页的 URL

字符串

job_id

与抓取任务关联的任务 ID。

字符串

status_code

抓取任务的状态码。你可以查看所描述的抓取器状态码这里.

整数

is_render_forced

标识此请求是否强制渲染。

boolean

parser_type

用于提取数据的解析器类型（例如，"walmart_product_new"）。

字符串

通用

键（通用）

说明

类型

url

商品的 URL。

字符串

主图

主商品图片的 URL

整数

images

商品图片 URL 数组。

数组

title

产品的标题或名称。

字符串

描述

商品的详细描述。

字符串

brand

产品品牌。

字符串

badge

指示促销、商品特征、认证或品牌关联等特定属性的标记。

字符串列表

meta

商品的元数据。

对象

meta.sku

商品的库存单位（SKU）。

字符串

meta.gtin

商品的全球贸易项目编号（GTIN）。

字符串

价格

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

键（价格）

说明

类型

价格

产品的当前价格，不含任何折扣。

浮点数

price_strikethrough

划线价可以是原价、套装价或标价。

浮点数

货币

商品价格的 ISO 4217 三字母货币代码。

字符串

评分

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

键（评分）

说明

类型

rating

产品的平均评分。

浮点数

count

产品的评分数量。

整数

卖家

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

键（卖家）

描述

类型

name

卖家的名称。

字符串

official_name

卖家实体的官方注册名称。

字符串

id

平台分配给卖家的唯一标识符。

字符串

url

指向卖家官方网站或店面的 URL。

字符串

catalog_id

目录 ID。

字符串

规格

...
"specifications": [
    ...
    {
        "key": "Brand",
        "value": "LEGO"
    },
    {
        "key": "Age Range",
        "value": "9 岁及以上"
    },
]
...

键（规格）

说明

类型

key

商品的具体属性或特征。

字符串

值下可用

与规格键所指定属性对应的值或描述。

字符串

履约

...
"fulfillment": {
                    "pickup": false,
                    "delivery": false,
                    "shipping": true,
                    "out_of_stock": false,
                    "free_shipping": true,
                    "pickup_information": "自提，暂无",
                    "delivery_information": "送货，暂无",
                    "shipping_information": "配送，10 月 24 日送达，免运费"
                },
...

键（履约）

说明

类型

自提

表示产品是否可通过门店自提履约。

boolean

pickup_information

当 pickup = true 时的自提信息。

字符串

配送

表示商品是否可通过本地门店配送履约。

boolean

delivery_information

当 delivery = true 时的本地门店配送信息。

字符串

shipping

表示产品是否可通过送货上门履约。

boolean

shipping_information

如果显示，则为配送信息。

字符串

free_shipping

表示是否免运费。

boolean

out_of_stock

表示商品当前是否缺货。

boolean

变体

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

键（variations）

说明

类型

state

商品变体的可用状态。

字符串

product_id

每个商品变体的唯一标识符。

字符串

selected_options

包含定义该变体的已选选项的数组。

数组

selected_options.key

描述所选选项的键。

字符串

selected_options.value

所选选项的值。

字符串

面包屑导航

... 
"breadcrumbs": [
    {
        "url": "/cp/cell-phones/1105910",
        "category_name": "手机"
    },
    {
        "url": "/cp/phones-with-plans/1073085",
        "category_name": "带套餐手机"
    },
    {
        "url": "/cp/postpaid-phones/8230659",
        "category_name": "后付费手机"
    }
    ...
],
...

键（面包屑导航）

说明

类型

category_name

类别名称。

字符串

url

分类的 URL

字符串

位置

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

键（位置）

说明

类型

city

请求运行所在的城市。

字符串

state

请求运行所在的州。

字符串

zip_code

请求运行所在的邮政编码。

字符串

store_id

请求运行所在门店的 ID。

字符串

最后更新于 1个月前

这有帮助吗？