> For the complete documentation index, see [llms.txt](https://developers.oxylabs.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://developers.oxylabs.io/api-targets/cn/dian-zi-shang-wu/walmart/product.md).
# 商品
该 `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:", 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 'Error:' . 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("Error: " + 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设置为 html. 更多信息 . - parse设置为 true. falsecallback_url您的回调端点 URL。 更多信息 - user_agent_type设备类型和浏览器。完整列表可在 这里 desktop
\- 必填参数
### 本地化
根据特定门店、送货地点调整结果。Walmart 门店 ID 列表请见：
{% file src="/files/0d53a32dcf2febd94bf40a765b0230511b08c500" %}
你也可以在这里找到 Walmart 商店的官方页面 [**这里**](https://www.walmart.com/store-directory)**.**
参数 说明 类型 域名Walmart 的域名本地化。可用值： com, com.mx, ca, co.cr. 默认： com. 字符串 fulfillment_type设置履约类型。支持的值： 自提, 配送, shipping. 字符串 delivery_zip设置收货地点。 字符串 store_id设置门店位置。 字符串
履约类型参数的可用性因 Walmart 域名而异：
域名 支持的履约类型 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` - Walmart 将返回其默认结果，不进行商店定向。
{% 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 显示，具备业界顶尖的色彩准确度、纯正的黑色表现以及出色的亮度和对比度。它们是 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——让它成为智能手机上最安全的面部认证方式，而且使用起来更快、更简单。
手机已测试，工作正常且功能完好。可能有磨痕、划痕、裂痕或其他不影响手机功能的轻微问题。 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 双色温闪光灯，以及 f/2.2、32mm 的 700 万像素前置摄像头 内存：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": "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 示例
键 说明 类型 通用包含通用商品页结果详情的对象。 对象 价格对象包含商品价格信息。 对象 rating商品的评分信息。 对象 seller关于卖家的信息。 对象 variations （可选）商品变体列表。 数组 面包屑导航通往商品的分类层级。 对象 location提供请求运行位置的信息。 对象 履约对象包含商品履约选项信息。 对象 specifications用于详细说明商品特定属性或特征的键值对数组。 数组 parse_status_code解析任务的状态码。你可以查看所描述的解析器状态码 这里 整数 created_at抓取任务创建时的时间戳。 timestamp updated_at抓取任务完成时的时间戳。 timestamp page提取产品数据的页码 整数 urlWalmart 网站上商品页的 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_strikethrough划线价可以是原价、套装价或标价。 浮点数 货币商品价格的 ISO 4217 三字母货币代码。 字符串
### 评分
键（评分） 说明 类型 rating产品的平均评分。 浮点数 count产品的评分数量。 整数
### 卖家
键（卖家） 描述 类型 name卖家的名称。 字符串 official_name卖家实体的官方注册名称。 字符串 id平台分配给卖家的唯一标识符。 字符串 url指向卖家官方网站或店面的 URL。 字符串 catalog_id目录 ID。 字符串
### 规格
键（规格） 说明 类型 key商品的具体属性或特征。 字符串 值下可用与规格键所指定属性对应的值或描述。 字符串
### 履约
键（履约） 说明 类型 自提表示产品是否可通过门店自提履约。 boolean pickup_information当 pickup = true 时的自提信息。 字符串 配送表示商品是否可通过本地门店配送履约。 boolean delivery_information当 delivery = true 时的本地门店配送信息。 字符串 shipping表示产品是否可通过送货上门履约。 boolean shipping_information如果显示，则为配送信息。 字符串 free_shipping表示是否免运费。 boolean out_of_stock表示商品当前是否缺货。 boolean
### 变体
键（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
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## 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.