Documentation has been updated: see help center and changelog in one place.

商品

了解如何使用 Web Scraper API 获取 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
    }'

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

请求参数值

通用

参数
说明
默认值

source

设置抓取器。

walmart_product

product_id

Walmart 产品 ID。

-

render

启用 JavaScript 渲染,当设置为 html. 更多信息.

-

parse

当设置为以下值时返回解析后的数据 true.

false

callback_url

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

-

user_agent_type

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

desktop

- 必填参数

本地化

将结果适配到特定门店、送货地点。Walmart 门店 ID 的 JSON 列表见此处:

您也可以找到沃尔玛门店的官方页面 此处.

参数
说明
类型

domain

沃尔玛的域名本地化。

字符串

delivery_zip

设置收货邮编位置。

字符串

store_id

设置门店位置。

字符串

如果目标门店距离给定邮政编码过远——我们将尝试使用目标门店的邮政编码,否则位置将无法正确设置。在无法设置 delivery_zip - 沃尔玛将返回其默认结果,不带门店定位。

结构化数据

在下列部分,当某个结果类型有多于一项时,解析后的 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 光学变焦)摄像头,配四 LED 双色温闪光灯;前置 7MP(f/2.2,32mm)摄像头</li>   <li>内部存储:64GB,4GB RAM</li>   <li>IP68 防尘/防水(最多 2m,30 分钟),抗划玻璃,防油污涂层</li>   <li>尺寸:5.65 x 2.79 x 0.30 英寸,重量:6.24 oz</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 结构

下表列出了我们解析的每个产品页面元素的详细清单、说明和数据类型。表中还包括一些元数据。

说明
类型

general

包含一般产品页面结果详情的对象。

对象

价格

对象包含有关产品定价的详细信息。

对象

rating

产品的评分信息。

对象

卖家

有关卖家的信息。

对象

variations (可选)

产品的可选变体列表。

数组

breadcrumbs

指向产品的类别层级。

对象

位置

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

对象

fulfillment

对象包含有关产品履约选项的信息。

对象

specifications

详细的键值对数组,列出产品的具体属性或特征。

数组

parse_status_code

解析任务的状态代码。您可以在此处查看解析器状态代码说明 此处.

整数

created_at

抓取任务创建的时间戳。

时间戳

updated_at

抓取任务完成的时间戳。

时间戳

page

提取产品数据时所在的页码

整数

url

产品页面在 Walmart 网站上的 URL

字符串

job_id

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

字符串

status_code

抓取任务的状态代码。您可以在此处查看爬虫状态代码说明 此处.

整数

is_render_forced

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

boolean

parser_type

用于提取数据的解析器类型(例如:"walmart_product_new")。

字符串

常规

键(general)
说明
类型

url

商品的 URL。

字符串

main_image

主要产品图片的 URL

整数

images

产品图片的 URL 数组。

数组

title

产品的标题或名称。

字符串

description

产品的详尽描述。

字符串

brand

产品的品牌。

字符串

badge

指示特定属性,如促销、产品特征、认证或品牌关联。

字符串列表

meta

产品的元数据。

对象

meta.sku

产品的库存单位(SKU)。

字符串

meta.gtin

产品的全球贸易项目编号(GTIN)。

字符串

价格

...
"price": {
    "price": 12.49,
    "price_strikethrough": 23.72,
    "currency": "USD"
},
...
键(price)
说明
类型

价格

产品当前价格(未扣减)。

float

price_strikethrough

划线价可以是曾经价格、组合价或标价。

float

货币

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

字符串

评分

...
 "rating": {
    "count": 64,
    "rating": 4.7
},
...
键(rating)
说明
类型

rating

产品的平均评分。

float

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"
},
...
键(seller)
Describtion
类型

name

卖家的名称。

字符串

official_name

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

字符串

id

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

字符串

url

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

字符串

catalog_id

目录 ID。

字符串

规格

...
"specifications": [
    ...
    {
        "key": "Brand",
        "value": "LEGO"
    },
    {
        "key": "Age Range",
        "value": "9 Years & Up"
    },
]
...
Key (specifications)
说明
类型

key

产品的具体属性或特征。

字符串

value

由规格键指定的属性对应的值或说明。

字符串

履约

...
"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"
                },
...
键(fulfillment)
说明
类型

pickup

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

boolean

pickup_information

当 pickup = true 时的自提消息。

字符串

delivery

指示该产品是否可通过本地门店配送履约。

boolean

delivery_information

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

字符串

运输

指示产品是否可通过家庭运输履约。

boolean

shipping_information

如果显示,产品的运输信息消息。

字符串

free_shipping

指示运费是否为免费。

boolean

out_of_stock

指示该产品当前是否缺货。

boolean

Variations

...
"variations": [
    {
        "state": "IN_STOCK",
        "product_id": "7328JAQF0Y2S",
        "selected_options": [
            {
                "key": "Color",
                "value": "Black"
            },
]
...
Key (variations)
说明
类型

state

产品变体的可用性状态。

字符串

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"
    }
    ...
],
...
Key (breadcrumbs)
说明
类型

category_name

类别的名称。

字符串

url

类别的 URL

字符串

位置

...
"location": {
    "city": "Sacramento",
    "state": "CA",
    "store_id": "8915",
    "zip_code": "95829"
},
...
键(location)
说明
类型

city

请求运行时所在的城市。

字符串

state

请求运行时所在的州。

字符串

zip_code

请求运行时使用的邮政编码。

字符串

store_id

请求运行时使用的门店 ID。

字符串

最后更新于

这有帮助吗?