> 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/products/cn/web-scraper-api/mu-biao/dian-zi-shang-wu/walmart/sou-suo.md).

# 搜索

提取 Walmart 搜索结果中的已解析数据，包括价格、评分、卖家信息、变体、履约选项和筛选项，并支持价格区间和排序过滤。

该 `walmart_search` source 旨在检索 Walmart 搜索结果页。我们可以返回你需要的任何 Walmart 页面 HTML。此外，我们还可以提供 **Walmart 搜索页的结构化（已解析）输出**.

{% hint style="info" %}
除了下面列出的参数外，您还可以添加其他参数，例如 `user_agent_type`, `geo_location`, `render`等，以自定义您的抓取请求。更多信息见 [这里](https://developers.oxylabs.io/products/cn/web-scraper-api/features.md).
{% endhint %}

## 请求示例

{% tabs %}
{% tab title="cURL" %}

```shell
curl 'https://realtime.oxylabs.io/v1/queries' \
--user 'USERNAME:PASSWORD' \
-H 'Content-Type: application/json' \
-d '{
        "source": "walmart_search",
        "query": "iphone",
        "parse": true
    }'
```

{% endtab %}

{% tab title="Python" %}

```python
import requests
from pprint import pprint

# Structure payload.
payload = {
    'source': 'walmart_search',
    'query': 'iphone',
    'parse': True
}

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

# Instead of response with job status and results url, this will return the
# JSON response with the result.
pprint(response.json())
```

{% endtab %}

{% tab title="Node.js" %}

```javascript
const https = require("https");

const username = "USERNAME";
const password = "PASSWORD";
const body = {
    source: "walmart_search",
    query: "iphone",
    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_search&query=iphone&parse=true&access_token=12345abcde
```

{% endtab %}

{% tab title="PHP" %}

```php
<?php

$params = array(
    'source' => 'walmart_search',
    'query' => 'iphone',
    '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_search",
        "query": "iphone",
        "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_search",
                query = "iphone",
                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_search");
        jsonObject.put("query", "iphone");
        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_search",
    "query": "iphone",
    "parse": true
}
```

{% endtab %}
{% endtabs %}

## 请求参数值

<table><thead><tr><th width="180">参数</th><th>说明</th><th width="160">默认值</th></tr></thead><tbody><tr><td><mark style="background-color:green;"><strong><code>source</code></strong></mark></td><td>设置抓取器。</td><td><code>walmart_search</code></td></tr><tr><td><mark style="background-color:green;"><strong><code>query</code></strong></mark></td><td>要搜索商品的关键词或短语。</td><td>-</td></tr><tr><td><code>start_page</code></td><td>起始页码。</td><td><code>1</code></td></tr><tr><td><code>parse</code></td><td>设置为时返回解析后的数据 <code>true</code>。查看 <a href="#output-data-dictionary">输出数据字典</a>.</td><td><code>false</code></td></tr><tr><td><code>domain</code>, <code>store_id</code>, <code>delivery_zip</code>, <code>fulfillment_type</code>, <code>fulfillment_speed</code>, <code>sort_by</code>, <code>min_price</code>, <code>max_price</code></td><td>可选的本地化和过滤参数，见 <a href="#localization-and-filtering">本地化和过滤</a>.</td><td>-</td></tr></tbody></table>

&#x20;   \- 必填参数

## 响应示例

针对查询 `iphone` （该 `结果` 列表被缩减为一项及其 `变体` 为一项）：

```json
{
    "results": [
        {
            "content": {
                "location": {
                    "city": "Buford",
                    "state": "GA",
                    "store_id": "1314",
                    "zipcode": "30518"
                },
                "page_details": {
                    "last_visible_page": 14,
                    "page": 1,
                    "total_results": 163937
                },
                "parse_status_code": 12000,
                "results": [
                    {
                        "fulfillment": {
                            "delivery": false,
                            "free_shipping": false,
                            "pickup": false,
                            "shipping": false
                        },
                        "general": {
                            "badge": "In 100+ people's carts",
                            "image": "https://i5.walmartimages.com/seo/Straight-Talk-Apple-iPhone-16-128GB-Black-Prepaid-Smartphone-Locked-to-Straight-Talk_5020ab6e-5621-4a30-ad28-ff8ff50dda06.04e5097b0e5538a647ec36e73c454530.jpeg?odnHeight=180&odnWidth=180&odnBg=FFFFFF",
                            "out_of_stock": false,
                            "pos": 8,
                            "product_id": "11632865509",
                            "section_title": "Results for \"iphone\"",
                            "sponsored": false,
                            "title": "Straight Talk Apple iPhone 16, 128GB, Black - Prepaid Smartphone [Locked to Straight Talk]",
                            "url": "/ip/Straight-Talk-Apple-iPhone-16-128GB-Black-Prepaid-Smartphone-Locked-to-Straight-Talk/11632865509?classType=VARIANT&athbdg=L1103"
                        },
                        "price": {
                            "currency": "USD",
                            "price": 629
                        },
                        "rating": {
                            "count": 768,
                            "rating": 4.4
                        },
                        "seller": {
                            "id": "F55CDC31AB754BB68FE0B39041159D63",
                            "name": "Walmart.com"
                        },
                        "variants": [
                            {
                                "image": "https://i5.walmartimages.com/asr/5020ab6e-5621-4a30-ad28-ff8ff50dda06.04e5097b0e5538a647ec36e73c454530.jpeg?odnHeight=180&odnWidth=180&odnBg=FFFFFF",
                                "product_id": "11632865509",
                                "title": "Black",
                                "url": "/ip/Straight-Talk-iPhone-16-128GB-Prepaid-Smartphone-Black/11632865509?classType=undefined&variantFieldId=actual_color"
                            }
                        ]
                    }
                ],
                "url": "https://www.walmart.com/search?q=iphone"
            },
            "created_at": "2026-09-26 06:23:20",
            "updated_at": "2026-09-26 06:23:23",
            "page": 1,
            "url": "https://www.walmart.com/search?q=iphone",
            "job_id": "7509497822371138561",
            "status_code": 200,
            "is_render_forced": false,
            "parser_type": "walmart_search_new"
        }
    ]
}
```

## 本地化和过滤 <a href="#localization-and-filtering" id="localization-and-filtering"></a>

Walmart 会根据门店调整库存和价格。解析后的 `location` 对象显示该页面对应的门店；如果没有 `store_id` 或 `delivery_zip` 则为随机的美国门店。

你也可以找到 Walmart 门店的官方页面 [**这里**](https://www.walmart.com/store-directory)**.** 各站点的门店编号在这些列表中（`store_id` 列）：

{% file src="/files/a1fd89df42ba65b5b82eb8830835de0afcfd38c7" %}

{% file src="/files/46899e4a5618d3d01f87817cfa6346a07e18bac6" %}

{% file src="/files/627397ac4f11a69d93c2ff8ed9a5679e04b086ad" %}

{% file src="/files/6820d3e7b452344fc889cc51360075ef50fdb882" %}

<table><thead><tr><th width="180">参数</th><th>说明</th><th width="150">默认值</th></tr></thead><tbody><tr><td><code>domain</code></td><td>要抓取的 Walmart 站点。可用值： <code>com</code> (walmart.com), <code>ca</code> (walmart.ca), <code>com.mx</code> (walmart.com.mx), <code>co.cr</code> (walmart.co.cr). 价格以该站点的货币显示（USD、CAD、MXN、CRC）。</td><td><code>com</code></td></tr><tr><td><code>store_id</code></td><td>所选站点的 Walmart 门店编号，字符串，例如 <code>"3520"</code>。请从上面的门店列表中获取。</td><td>-</td></tr><tr><td><code>delivery_zip</code></td><td>送货 ZIP 或邮政编码，字符串，例如 <code>"90210"</code>。距离该编码最近的门店将成为该页面的门店。</td><td>-</td></tr><tr><td><code>fulfillment_type</code></td><td>按商品获取方式过滤结果。可用值： <code>pickup</code>, <code>delivery</code>, <code>shipping</code>。与 <code>store_id</code> （自提）或 <code>delivery_zip</code> （配送）。</td><td>-</td></tr><tr><td><code>fulfillment_speed</code></td><td>按配送速度过滤结果。可用值： <code>今天</code>, <code>明天</code>, <code>2_days</code>, <code>任意时间</code>.</td><td>-</td></tr><tr><td><code>sort_by</code></td><td>结果排序。可用值： <code>best_match</code>, <code>price_low</code>, <code>price_high</code>, <code>best_seller</code>.</td><td><code>best_match</code></td></tr><tr><td><code>min_price</code></td><td>要包含的最低价格，使用站点货币表示的整数，例如 <code>100</code>.</td><td>-</td></tr><tr><td><code>max_price</code></td><td>要包含的最高价格，使用站点货币表示的整数，例如 <code>200</code>.</td><td>-</td></tr></tbody></table>

```json
{
    "source": "walmart_search",
    "query": "milk",
    "store_id": "3520",
    "fulfillment_type": "pickup",
    "sort_by": "price_low",
    "parse": true
}
```

{% hint style="info" %}
如果目标门店与给定邮政编码距离过远，我们会尝试使用目标门店的邮政编码，否则位置将无法正确设置。如果我们无法设置 `delivery_zip` — Walmart 将返回其默认结果，不进行门店定向。
{% endhint %}

## 输出数据字典 <a href="#output-data-dictionary" id="output-data-dictionary"></a>

#### **HTML 示例**

<figure><img src="https://lh7-qw.googleusercontent.com/docsz/AD_4nXfYKEySR7wMk6YcQlNwL_-Md1jjuDsNYTvGWce18gD6iEPG_h6xZNBify4gxkgVVIL8paPHhpH3nM1hJPHgtyDsq_d3hfieZdRKXGwmSq8k2Qor046eUzY-ZVLMuE8V5pHs7AxC-L8aHx5KZVa0ivMlY0c?key=0pdGx4c_qHnNgLislTadiQ" alt=""><figcaption></figcaption></figure>

#### **JSON 结构**

下表列出了我们解析的每个搜索页元素的详细清单，以及其描述和数据类型。表中还包括一些元数据。

<table><thead><tr><th width="181.515625">键</th><th width="348.72265625">说明</th><th width="108.1640625">类型</th></tr></thead><tbody><tr><td><code>url</code></td><td>搜索页面的 URL。</td><td>字符串</td></tr><tr><td><code>结果</code></td><td>搜索结果列表。</td><td>数组</td></tr><tr><td><code>results.general</code></td><td>商品的通用详情。</td><td>对象</td></tr><tr><td><code>results.price</code></td><td>商品的价格详情。</td><td>对象</td></tr><tr><td><code>results.rating</code></td><td>商品的评分详情。</td><td>对象</td></tr><tr><td><code>results.seller</code></td><td>商品的卖家详情。</td><td>对象</td></tr><tr><td><code>results.variants</code> （可选）</td><td>商品变体列表。</td><td>数组</td></tr><tr><td><code>results.fulfillment</code></td><td>商品的履约选项。</td><td>对象</td></tr><tr><td><code>location</code></td><td>该页面所对应的门店。</td><td>对象</td></tr><tr><td><code>facets</code></td><td>结果页上显示的搜索筛选器（细化项）列表。</td><td>数组</td></tr><tr><td><code>page_details</code></td><td>结果页的分页详情。</td><td>对象</td></tr><tr><td><code>parse_status_code</code></td><td>解析任务的状态码。您可以查看所述的解析器状态码 <a href="https://developers.oxylabs.io/products/cn/web-scraper-api/features/custom-parser.md"><strong>这里</strong></a>.</td><td>整数</td></tr><tr><td><code>created_at</code></td><td>抓取任务创建时的时间戳。</td><td>时间戳</td></tr><tr><td><code>updated_at</code></td><td>抓取任务完成时的时间戳。</td><td>时间戳</td></tr><tr><td><code>page</code></td><td>结果分页中的页码。</td><td>整数</td></tr><tr><td><code>url</code></td><td>抓取页面的 URL。</td><td>字符串</td></tr><tr><td><code>job_id</code></td><td>与该抓取任务关联的任务 ID。</td><td>字符串</td></tr><tr><td><code>status_code</code></td><td>被抓取页面的 HTTP 状态码。</td><td>整数</td></tr><tr><td><code>is_render_forced</code></td><td>标识此请求是否已强制渲染。</td><td>布尔值</td></tr><tr><td><code>parser_type</code></td><td>用于提取数据的解析器类型。</td><td>字符串</td></tr></tbody></table>

### **通用**

来自以下内容的片段 [响应示例](#response-example):

```javascript
...
"general": {
"badge": "In 100+ people's carts",
"image": "https://i5.walmartimages.com/seo/Straight-Talk-Apple-iPhone-16-128GB-Black-Prepaid-Smartphone-Locked-to-Straight-Talk_5020ab6e-5621-4a30-ad28-ff8ff50dda06.04e5097b0e5538a647ec36e73c454530.jpeg?odnHeight=180&odnWidth=180&odnBg=FFFFFF",
"out_of_stock": false,
"pos": 8,
"product_id": "11632865509",
"section_title": "Results for \"iphone\"",
"sponsored": false,
"title": "Straight Talk Apple iPhone 16, 128GB, Black - Prepaid Smartphone [Locked to Straight Talk]",
"url": "/ip/Straight-Talk-Apple-iPhone-16-128GB-Black-Prepaid-Smartphone-Locked-to-Straight-Talk/11632865509?classType=VARIANT&athbdg=L1103"
},
...
```

<table><thead><tr><th width="237">键（general）</th><th width="372">说明</th><th>类型</th></tr></thead><tbody><tr><td><code>pos</code></td><td>该项目在其分区中的位置。</td><td>整数</td></tr><tr><td><code>url</code></td><td>商品页面的 URL 路径。</td><td>字符串</td></tr><tr><td><code>image</code></td><td>主商品图片的 URL。</td><td>字符串</td></tr><tr><td><code>title</code></td><td>产品标题。</td><td>字符串</td></tr><tr><td><code>product_id</code></td><td>Walmart 商品 ID。</td><td>字符串</td></tr><tr><td><code>sponsored</code></td><td>标识该商品是否为赞助列表。</td><td>布尔值</td></tr><tr><td><code>badge</code> （可选）</td><td>列表中显示的徽标，例如 <code>畅销</code>, <code>综合推荐</code>, <code>在 100 多人的购物车中</code>.</td><td>字符串</td></tr><tr><td><code>section_title</code></td><td>商品所在分区的名称，例如 <code>“iphone”的结果</code>.</td><td>字符串</td></tr><tr><td><code>out_of_stock</code></td><td>指示该商品是否缺货。</td><td>布尔值</td></tr></tbody></table>

### 价格

来自以下内容的片段 [响应示例](#response-example):

```javascript
...
"price": {
"currency": "USD",
"price": 629
},
...
```

<table><thead><tr><th width="237">键（price）</th><th width="372">说明</th><th>类型</th></tr></thead><tbody><tr><td><code>price</code> （可选）</td><td>商品当前价格。</td><td>浮点数</td></tr><tr><td><code>price_strikethrough</code> （可选）</td><td>划线价格（原价、组合价或标价）。</td><td>浮点数</td></tr><tr><td><code>currency</code></td><td>货币的 ISO 4217 三字母代码。</td><td>字符串</td></tr><tr><td><code>price_min</code> （可选）</td><td>区间定价时的最低价格。</td><td>浮点数</td></tr><tr><td><code>price_max</code> （可选）</td><td>区间定价时的最高价格。</td><td>浮点数</td></tr></tbody></table>

### 评分

来自以下内容的片段 [响应示例](#response-example):

```javascript
...
"rating": {
"count": 768,
"rating": 4.4
},
...
```

<table><thead><tr><th width="237">键（rating）</th><th width="372">说明</th><th>类型</th></tr></thead><tbody><tr><td><code>rating</code></td><td>商品的平均评分； <code>0</code> 当没有评分时。</td><td>浮点数</td></tr><tr><td><code>count</code></td><td>评分数量。</td><td>整数</td></tr></tbody></table>

### 卖家

来自以下内容的片段 [响应示例](#response-example):

```json
...
"seller": {
"id": "F55CDC31AB754BB68FE0B39041159D63",
"name": "Walmart.com"
},
...
```

<table><thead><tr><th width="237">键（seller）</th><th width="372">说明</th><th>类型</th></tr></thead><tbody><tr><td><code>name</code></td><td>卖家的名称。</td><td>字符串</td></tr><tr><td><code>id</code></td><td>卖家的 ID。</td><td>字符串</td></tr></tbody></table>

### 变体

来自以下内容的片段 [响应示例](#response-example):

```json
...
"variants": [
{
"image": "https://i5.walmartimages.com/asr/5020ab6e-5621-4a30-ad28-ff8ff50dda06.04e5097b0e5538a647ec36e73c454530.jpeg?odnHeight=180&odnWidth=180&odnBg=FFFFFF",
"product_id": "11632865509",
"title": "Black",
"url": "/ip/Straight-Talk-iPhone-16-128GB-Prepaid-Smartphone-Black/11632865509?classType=undefined&variantFieldId=actual_color"
}
]
}
],
...
```

<table><thead><tr><th width="237">键（variants）</th><th width="372">说明</th><th>类型</th></tr></thead><tbody><tr><td><code>url</code></td><td>商品变体的 URL 路径。</td><td>字符串</td></tr><tr><td><code>title</code></td><td>变体的标题，例如颜色。</td><td>字符串</td></tr><tr><td><code>product_id</code></td><td>变体的商品 ID。</td><td>字符串</td></tr><tr><td><code>image</code></td><td>变体图片。</td><td>字符串</td></tr></tbody></table>

### 履约

来自以下内容的片段 [响应示例](#response-example):

```json
 ...
"fulfillment": {
"delivery": false,
"free_shipping": false,
"pickup": false,
"shipping": false
},
...
```

<table><thead><tr><th width="237">键（fulfillment）</th><th width="372">说明</th><th>类型</th></tr></thead><tbody><tr><td><code>pickup</code></td><td>指示是否提供到店自提。</td><td>布尔值</td></tr><tr><td><code>delivery</code></td><td>指示是否提供本地门店配送。</td><td>布尔值</td></tr><tr><td><code>shipping</code></td><td>指示是否提供上门配送。</td><td>布尔值</td></tr><tr><td><code>free_shipping</code></td><td>指示是否免运费。</td><td>布尔值</td></tr></tbody></table>

### 筛选项

```json
... 
"facets": [
    {
        "type": "sort",
        "values": [
            {
                "name": "Best Match"
            },
            {
                "name": "Price Low"
            },
            {
                "name": "Price High"
            },
            {
                "name": "Best Seller"
            }
        ],
        "display_name": "Sort by"
    },
...
```

<table><thead><tr><th width="141.69140625">键（facets）</th><th width="372.97265625">说明</th><th>类型</th></tr></thead><tbody><tr><td><code>display_name</code></td><td>页面上显示的筛选器名称。</td><td>字符串</td></tr><tr><td><code>type</code></td><td>筛选器类型。</td><td>字符串</td></tr><tr><td><code>values</code></td><td>筛选器值列表。</td><td>数组</td></tr><tr><td><code>values.name</code></td><td>筛选值名称。</td><td>字符串</td></tr><tr><td><code>values.item_count</code> （可选）</td><td>该筛选值可用的商品数量。</td><td>整数</td></tr></tbody></table>

### 位置

来自以下内容的片段 [响应示例](#response-example):

```json
...
"location": {
"city": "Buford",
"state": "GA",
"store_id": "1314",
"zipcode": "30518"
},
...
```

<table><thead><tr><th width="237">键（location）</th><th width="372">说明</th><th>类型</th></tr></thead><tbody><tr><td><code>city</code></td><td>该页面所对应门店所在的城市。</td><td>字符串</td></tr><tr><td><code>state</code></td><td>门店所在的州。</td><td>字符串</td></tr><tr><td><code>zipcode</code></td><td>门店的 ZIP 代码。</td><td>字符串</td></tr><tr><td><code>store_id</code></td><td>门店 ID。</td><td>字符串</td></tr></tbody></table>

### 页面详情

来自以下内容的片段 [响应示例](#response-example):

```json
 ...
"page_details": {
"last_visible_page": 14,
"page": 1,
"total_results": 163937
},
...
```

<table><thead><tr><th width="237">键（page_details）</th><th width="372">说明</th><th>类型</th></tr></thead><tbody><tr><td><code>page</code></td><td>结果的页码。</td><td>整数</td></tr><tr><td><code>total_results</code></td><td>Walmart 针对该查询报告的结果总数。</td><td>整数</td></tr><tr><td><code>last_visible_page</code></td><td>可用的最后一页页码。</td><td>整数</td></tr></tbody></table>


---

# 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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://developers.oxylabs.io/products/cn/web-scraper-api/mu-biao/dian-zi-shang-wu/walmart/sou-suo.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
