# 产品
该 `walmart_product` source 旨在检索 Walmart 商品结果页。我们可以返回你喜欢的任何 Walmart 页面 HTML。此外，我们还可以提供 **Walmart 商品页的结构化（解析后）输出**.
## 请求样本
下面的示例展示了如何获取已解析的 Walmart 商品页结果。
{% tabs %}
{% tab title="cURL" %}
```shell
curl 'https://realtime.oxylabs.io/v1/queries' \\
--user 'USERNAME:PASSWORD' \\
-H 'Content-Type: application/json' \\
-d '{
"source": "walmart_product",
"product_id": "15296401808",
"parse": true
}'
```
{% endtab %}
{% tab title="Python" %}
```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())
```
{% endtab %}
{% tab title="Node.js" %}
```javascript
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);
});
request.write(JSON.stringify(body));
request.end();
```
{% endtab %}
{% tab title="HTTP" %}
```http
# 你提交的整个字符串必须进行 URL 编码。
https://Realtime.oxylabs.io/v1/queries?source=walmart_product&product_id=15296401808&parse=true&access_token=12345abcde
```
{% endtab %}
{% tab title="PHP" %}
```php
'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 '错误:' . curl_error($ch);
}
curl_close($ch);
```
{% endtab %}
{% tab title="Golang" %}
```go
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))
}
```
{% endtab %}
{% tab title="C#" %}
```csharp
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);
}
}
}
```
{% endtab %}
{% tab title="Java" %}
```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("错误： " + exception.getMessage());
}
System.exit(0);
}
public static void main(String[] args) {
new Thread(new Main()).start();
}
}
```
{% endtab %}
{% tab title="JSON" %}
```json
{
"source": "walmart_product",
"product_id": "15296401808",
"parse": true
}
```
{% endtab %}
{% endtabs %}
我们在示例中使用同步 [**Realtime**](/products/cn/web-scraper-api/integration-methods/realtime.md) 集成方法。如果您想使用 [**Proxy Endpoint**](/products/cn/web-scraper-api/integration-methods/proxy-endpoint.md) 或异步 [**Push-Pull**](/products/cn/web-scraper-api/integration-methods/push-pull.md) 集成，请参阅 [**集成方法**](/products/cn/web-scraper-api/integration-methods.md) 部分。
## 请求参数值
### 通用
参数 描述 默认值 source设置爬虫。 walmart_productproduct_idWalmart 商品 ID。 - render设置为时启用 JavaScript 渲染 html. 更多信息 . - parse设置为时返回解析后的数据 true. falsecallback_url回调端点的 URL。 更多信息 - user_agent_type设备类型和浏览器。完整列表可在 这里 desktop
\- 必填参数
### 本地化
将结果适配到特定商店、配送地点。在此查找 Walmart 门店 ID 列表：
{% file src="/files/0d53a32dcf2febd94bf40a765b0230511b08c500" %}
你还可以找到沃尔玛商店的官方页面 [**这里**](https://www.walmart.com/store-directory)**.**
参数 描述 类型 域名沃尔玛域名本地化。可用值： com, com.mx, ca, co.cr。默认值： com. 字符串 fulfillment_type设置履约类型。支持的值： 自提, 配送, shipping. 字符串 delivery_zip设置收货地点。 字符串 store_id设置门店位置。 字符串
履约类型参数的可用性因沃尔玛域名而异：
域名 支持的履约类型 walmart.com自提, 配送, shippingwalmart.com.mx自提, 配送walmart.ca自提, 配送walmart.co.cr自提
对于国际 `store_id` 列表，请参见以下文件：
{% file src="/files/4f46528eb81a355147474f1621ccb315941832fb" %}
{% file src="/files/d52b112df6ce8920ad2da97936318cc6aaa5aa79" %}
{% file src="/files/b0910e561dcbc6c58b8398ee95b1e9bfd61e074a" %}
{% hint style="info" %}
如果目标商店距离给定邮政编码过远 - 我们将尝试使用目标商店的邮政编码，否则位置信息将无法正确设置。如果我们无法设置 `delivery_zip` - 沃尔玛将返回其默认结果，而不会按商店定位。
{% endhint %}
## 结构化数据
{% hint style="info" %}
在以下各节中，当结果类型可用的项目多于一个时，已解析的 JSON 代码片段会被截短。
{% endhint %}
Walmart 商品页结构化输出
```javascript
{
"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": "Super Retina。更大、更震撼。全面屏设计为你喜爱的所有内容带来宽广而精美的画布。定制 OLED。iPhone Xs 中的 OLED 面板支持 HDR 显示，具备业界最佳色彩准确度、纯粹的黑色以及卓越的亮度与对比度。它们是苹果设备中最清晰、像素密度最高的显示屏。全新防水等级。智能手机中最耐用的玻璃，采用医疗级不锈钢边框密封并精密贴合，帮助打造更强的防水机身——最长可在 2 米水深下保持 30 分钟。iPhone Xs 甚至可抵御咖啡、茶、汽水等液体泼溅。全新的智能层级。搭载下一代神经网络引擎的 A12 Bionic 带来令人惊叹的性能。它使用实时机器学习，改变你体验照片、游戏、增强现实等功能的方式。传感器、处理器、算法，以及你。创新的双摄系统集成了 ISP、神经网络引擎和先进算法，释放新的创作可能，帮助你拍出惊艳照片。一张照片胜过万亿次运算。iPhone Xs 双摄系统借助神经网络引擎前所未有的强大算力，每秒可执行五万亿次运算。再加上苹果设计的 ISP，它就像世界上最快的摄影助手，帮助你的照片成为焦点。简化的安全性。Face ID 重新定义了解锁、登录和支付的方式。我们最先进的一些技术——True Depth 摄像头系统、Secure Enclave 和神经网络引擎——使其成为智能手机上最安全的面部认证方式，而且使用起来更快更简单。
手机已测试，可正常工作并具备功能。可能有磨痕、划痕、裂痕或其他不影响手机功能的轻微问题。 5.8 英寸 Super AMOLED 电容式触摸屏，1125 x 2436 像素 iOS，Apple A12 Bionic，六核，Apple GPU（4 核图形） 双 1200 万像素（f/1.8，28mm，OIS）和 1200 万像素（f/2.4，52mm，2 倍光学变焦）摄像头，配备四 LED 双色温闪光灯，以及 700 万像素前置摄像头，f/2.2，32mm 内存：64GB，4GB RAM IP68 防尘/防水（最长 2 米，30 分钟），防刮玻璃，疏油涂层 尺寸：5.65 x 2.79 x 0.30 英寸，重量：6.24 盎司 "
},
"location": {
"city": "Sacramento",
"state": "CA",
"store_id": "3081",
"zip_code": "95829"
},
"variations": [
{
"state": "有货",
"product_id": "7328JAQF0Y2S",
"selected_options": [
{
"key": "运营商",
"value": "Verizon"
},
{
"key": "容量",
"value": "256GB"
},
{
"key": "颜色",
"value": "沙漠钛金"
}
]
},
"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": "处理器品牌",
"value": "Apple"
},
{
"key": "显示技术",
"value": "Retina 显示屏"
},
{
"key": "手机功能",
"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 示例
Amazon Best Sellers 页面的网址。 描述 类型 常规包含常规商品页结果详情的对象。 对象 价格对象包含商品价格详情。 对象 rating商品的评分信息。 对象 卖家关于卖家的信息。 对象 variations （可选）商品变体列表。 数组 面包屑导航指向该商品的类别层级。 对象 location提供请求运行位置的信息。 对象 履约对象包含商品履约选项信息。 对象 specifications包含键值对数组，详细说明商品的具体属性或特征。 数组 parse_status_code解析任务的状态码。你可以查看所描述的解析器状态码 这里 整数 created_at抓取任务创建时的时间戳。 timestamp updated_at抓取任务完成时的时间戳。 timestamp page提取产品数据的页码 整数 urlWalmart 网站上商品页面的 URL 字符串 job_id与抓取任务关联的任务 ID。 字符串 status_code抓取任务的状态码。你可以查看所描述的抓取器状态码 这里 整数 is_render_forced标识此次请求是否强制渲染。 布尔值 parser_type用于提取数据的解析器类型（例如 "walmart_product_new"）。 字符串
### **通用**
键（通用） 描述 类型 url商品的 URL。 字符串 主图商品主图的 URL 整数 images商品图片 URL 数组。 数组 title产品的标题或名称。 字符串 description商品的详细描述。 字符串 brand产品品牌。 字符串 badge表示促销、商品特性、认证或品牌归属等特定属性的指示项。 字符串列表 元数据商品的元数据。 对象 meta.sku商品的库存量单位（SKU）。 字符串 meta.gtin商品的全球贸易项目编号（GTIN）。 字符串
### 价格
键（价格） 描述 类型 价格产品当前价格，不含任何折扣。 浮点数 price_strikethrough划线价格可以是原价、组合价或目录价。 浮点数 货币商品价格的 ISO 4217 三字母货币代码。 字符串
### 评分
键（评分） 描述 类型 rating产品的平均评分。 浮点数 count产品的评分数量。 整数
### 卖家
键（卖家） 描述 类型 name卖家名称。 字符串 official_name卖家实体的官方注册名称。 字符串 id平台分配给卖家的唯一标识符。 字符串 url指向卖家官方网站或店面的 URL。 字符串 catalog_id目录 ID。 字符串
### 规格
键（规格） 描述 类型 键商品的具体属性或特征。 字符串 值与规格键所指定属性对应的值或描述。 字符串
### 履约
键（履约） 描述 类型 自提指示产品是否可通过门店自提履约。 布尔值 pickup_information当 pickup = true 时的自提信息。 字符串 配送表示该商品是否可通过本地门店配送履约。 布尔值 delivery_information当 delivery = true 时的门店配送信息。 字符串 shipping指示产品是否可通过送货上门履约。 布尔值 shipping_information如果显示，这是配送信息。 字符串 free_shipping指示配送是否免费。 布尔值 out_of_stock表示该商品当前是否缺货。 布尔值
### 变体
键（variations） 描述 类型 state商品变体的可用状态。 字符串 product_id每个商品变体的唯一标识符。 字符串 selected_options包含定义该变体的已选选项数组。 数组 selected_options.key描述所选选项的键。 字符串 selected_options.value所选选项的值。 字符串
### 面包屑导航
键（面包屑导航） 描述 类型 category_name类别名称。 字符串 url类别的 URL 字符串
### 位置
键（位置） 描述 类型 city请求运行所在的城市。 字符串 state请求运行所在的州。 字符串 zip_code请求运行所在的邮政编码。 字符串 store_id请求运行所在商店的 ID。 字符串
---
# Agent Instructions: Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter:
```
GET https://developers.oxylabs.io/api-targets/cn/dian-zi-shang-wu/walmart/product.md?ask=
```
The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.