> 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/features/localization/e-commerce-localization.md).

# 电商地域定位

我们的网页爬虫API提供本地化选项，可检索针对特定配送和门店位置定制的电商数据。本页说明如何使用 `geo_location` 和 `store_id` 以及其他参数，使结果与本地可用性和偏好保持一致。

#### 网站特定本地化支持

<table data-full-width="false"><thead><tr><th width="160">域名</th><th width="187">地理位置 / 配送</th><th>门店 ID</th><th>履约类型</th></tr></thead><tbody><tr><td><a href="#allegro"><strong>Allegro</strong></a></td><td>-</td><td>支持</td><td>-</td></tr><tr><td><a href="#amazon"><strong>Amazon</strong></a></td><td>ZIP 代码或 <a href="https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2"><strong>2 位国家代码</strong></a></td><td>-</td><td>-</td></tr><tr><td><a href="#bestbuy"><strong>Bestbuy</strong></a></td><td>ZIP 代码</td><td>支持</td><td>支持</td></tr><tr><td><a href="#bodega-aurrera"><strong>Bodega Aurrerá</strong></a></td><td>ZIP 代码</td><td>支持</td><td>支持</td></tr><tr><td><a href="#etsy"><strong>Etsy</strong></a></td><td>ZIP 代码或 <a href="https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2"><strong>2 位国家代码</strong></a></td><td>支持</td><td>-</td></tr><tr><td><a href="#kroger"><strong>Kroger</strong></a></td><td>ZIP 代码</td><td>支持</td><td>支持</td></tr><tr><td><a href="#lowes"><strong>Lowes</strong></a></td><td>ZIP 代码</td><td>支持</td><td>-</td></tr><tr><td><a href="#menards"><strong>Menards</strong></a></td><td>-</td><td>支持</td><td>-</td></tr><tr><td><a href="#publix"><strong>Publix</strong></a></td><td>-</td><td>支持</td><td>-</td></tr><tr><td><a href="#sams-club"><strong>Sam's Club</strong></a></td><td>ZIP 代码</td><td>支持</td><td>支持</td></tr><tr><td><a href="#target"><strong>目标</strong></a></td><td>ZIP 代码</td><td>支持</td><td>支持</td></tr><tr><td><a href="#the-home-depot"><strong>The Home Depot</strong></a></td><td>ZIP 代码或国家/地区</td><td>支持</td><td>-</td></tr><tr><td><a href="#walmart"><strong>Walmart</strong></a></td><td>ZIP 代码或国家/地区</td><td>支持</td><td>支持</td></tr></tbody></table>

## Allegro

将结果适配到特定门店、发货地点等。

<figure><img src="/files/d4d5aad03bf6d2077076a265847524c3ddb7b0be" alt="" width="283"><figcaption><p>设置 delivery_type</p></figcaption></figure>

<figure><img src="/files/4db49b5c345a2da12ebc32484a68b54977370371" alt="" width="283"><figcaption><p>设置 shipping_from 位置</p></figcaption></figure>

<figure><img src="/files/05c2b668883a13692d48ee359632f700f51a44ae" alt="" width="284"><figcaption><p>设置 store_city 和 store_region</p></figcaption></figure>

<table><thead><tr><th width="212">参数</th><th width="235">描述</th><th>类型</th></tr></thead><tbody><tr><td><code>delivery_time</code></td><td>设置配送日期。可用值： <code>one_day</code>, <code>two_days</code>.</td><td>字符串</td></tr><tr><td><code>shipping_from</code></td><td>设置发货来源位置。可用值： <code>china</code>, <code>czech</code>, <code>poland</code>, <code>hungary,</code> <code>slovakia</code>, <code>eu_countries</code>, <code>allegro_warehouse</code>.</td><td>字符串</td></tr><tr><td><code>store_city</code></td><td>设置购物门店所在城市。</td><td>字符串</td></tr><tr><td><code>store_region</code></td><td><p>设置发货门店所在地区。可用值：</p><pre class="language-json"><code class="lang-json"><strong>"lodz",
</strong>"opole",
"lublin",
"mazovia",
"silesia",
"lubuskie",
"podlaskie",
"pomerania",
"subcarpathia",
"lesser_poland",
"lower_silesia",
"greater_poland",
"warmia-masuria",
"west_pomerania",
"Świętokrzyskie",
"kuyavian-pomeranian"
</code></pre></td><td>字符串</td></tr></tbody></table>

## Amazon

使用 `geo_location` 该参数会根据配送偏好自定义 Amazon 结果，如下方截图所示：

<div><figure><img src="/files/fe40d4bd9b55f124d553c437ce6b880707036b77" alt=""><figcaption></figcaption></figure> <figure><img src="/files/cc39554a7f64b4f8235e5aadaafa0a5e74b19af2" alt=""><figcaption></figcaption></figure></div>

对于大多数 Amazon 域名，您可以设置 `geo_location` ，并使用邮政编码或 [**2 位国家代码**](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2)。除少数情况外，此方法覆盖两种主要本地化场景：

* 使用 **邮政编码** 用于以下位置 **位于** 市场所在国家。示例配对：
  * `{ "domain": "com", "geo_location": "90210" }`
  * `{ "domain": "co.uk", "geo_location": "W105LT" }`
* 使用 **2 位国家代码** 用于以下位置 **在** 市场所在国家。示例配对：
  * `{ "domain": "com", "geo_location": "LT" }`
  * `{ "domain": "de", "geo_location": "US" }`

#### 例外情况

* **不支持的域名**: `cn`, `com.tr`, `com.be`、以及 `nl` 不支持自定义配送位置。
* **特殊情况**:
  * **澳大利亚（`com.au`)**：仅接受澳大利亚邮政编码。
  * **阿联酋（`.ae`)**：接受阿联酋城市名称作为 `geo_location`，例如 `"geo_location": "Abu Dhabi"`，或 2 位国家代码。

{% hint style="info" %}
您还可以使用 `域` 和 `地区` 在抓取 Amazon 时使用参数。了解更多 [**这里**](/products/cn/web-scraper-api/features/localization/domain-locale.md).
{% endhint %}

## Bestbuy

将结果适配到特定域名、门店、配送位置。

<figure><img src="/files/07b18412b7bdb3373c48d3ca485f056206506fa5" alt="" width="359"><figcaption></figcaption></figure>

<table><thead><tr><th width="212">参数</th><th width="180">描述</th><th width="135">默认值</th><th>类型</th></tr></thead><tbody><tr><td><code>域</code></td><td>Bestbuy 的域名本地化。可用值： <code>com</code>, <code>ca</code>.</td><td><code>com</code></td><td>字符串</td></tr><tr><td><code>store_id</code></td><td>指定门店。</td><td>-</td><td>整数</td></tr><tr><td><code>delivery_zip</code></td><td>设置配送 ZIP 位置。</td><td>-</td><td>字符串</td></tr><tr><td><code>fulfillment_type</code></td><td>指定订单履约方式。可用值： <code>pickup</code>, <code>shipping</code></td><td>-</td><td>字符串</td></tr></tbody></table>

## Etsy

将结果适配到特定门店、配送位置。

<figure><img src="/files/10d7138f6d5fae9c737de2f1b678b88f6bb7e9f7" alt="" width="375"><figcaption><p>选择 store_id</p></figcaption></figure>

<figure><img src="/files/ad2d1f247ebf8b4b8239575eb337341a74706579" alt="" width="375"><figcaption><p>选择配送位置</p></figcaption></figure>

<table><thead><tr><th width="212">参数</th><th width="235">描述</th><th>类型</th></tr></thead><tbody><tr><td><code>store_id</code></td><td>指定门店。</td><td>整数</td></tr><tr><td><code>geo_location</code></td><td>设置配送至位置。</td><td>字符串</td></tr></tbody></table>

## Kroger

<figure><img src="https://lh7-qw.googleusercontent.com/docsz/AD_4nXfi8IRb24cfhIXTYy2QciLGDjD2S3EOlCGo_W8ipSDjNXBJI8N1cN1a03TB-5sQTGzMwk5RZkrxoPkXWBGP0GhZo12T10V8jA38BpsKP4f7hPKUD_DQtwaNSmPAT-XkzdR4kAJbWHqVHKDmTytH5DBFXbGm?key=O8OPhOCjl3FoIrVoMiPnpgh4" alt="" width="375"><figcaption></figcaption></figure>

<table><thead><tr><th width="210">参数</th><th width="172.33333333333331">描述</th><th width="153">默认值</th><th>依赖关系</th></tr></thead><tbody><tr><td><code>store_id</code></td><td>指定门店。参见可用值 <a href="https://files.gitbook.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FzrXw45naRpCZ0Ku9AjY1%2Fuploads%2FAsihGe7hi5yfauUl2JIQ%2Fkroger_stores.csv?alt=media&#x26;token=40fcd869-1845-47c5-bf76-96e74cabf685"><strong>这里</strong></a>。ID 必须以 '0' 开头。</td><td>-</td><td>当 <code>fulfillment_type</code> 设置为 <code>pickup</code> 还是 <code>in_store</code>.</td></tr><tr><td><code>delivery_zip</code></td><td>时为必需。</td><td>-</td><td>当 <code>fulfillment_type</code> 设置为 <code>指定配送位置 ZIP 代码。</code>.</td></tr><tr><td><code>fulfillment_type</code></td><td>指定订单履约方式。可用值： <code>pickup</code>, <code>指定配送位置 ZIP 代码。</code>, <code>in_store</code>.</td><td><code>pickup</code> （如果仅提供 <code>store_id</code> 则）</td><td>需要 <code>store_id</code> 适用于 <code>pickup</code> 和 <code>in_store</code>，或 <code>delivery_zip</code> 适用于 <code>指定配送位置 ZIP 代码。</code>.</td></tr></tbody></table>

**依赖关系说明：**

* `pickup` 和 `in_store` 值使用 `store_id` 参数来确定正确的门店。
* `指定配送位置 ZIP 代码。` 使用 `delivery_zip` 参数来指定配送位置。
* 如果仅提供 `store_id` ，且 `fulfillment_type` 未指定，则默认类型为 `pickup`.

{% hint style="warning" %}
如果 `fulfillment_type` 和 `store_id`/`delivery_zip` 组合无效（Kroger 不支持），抓取页面将返回 404 状态。
{% endhint %}

{% hint style="warning" %}
请注意，与其他来源不同，Kroger 来源设置门店 ID 不需要上下文参数。
{% endhint %}

## Lowe's

<figure><img src="/files/d760d19ceef4d741a6e9d67a51b3e19373c582e0" alt=""><figcaption><p>选择 store_id</p></figcaption></figure>

<table><thead><tr><th width="210">参数</th><th width="342.8841145833333">描述</th><th>类型</th></tr></thead><tbody><tr><td><code>store_id</code></td><td>指定门店。</td><td>整数</td></tr><tr><td><code>delivery_zip</code></td><td>时为必需。</td><td>字符串</td></tr></tbody></table>

## Menards

将结果适配到特定门店、可用性选项。

<figure><img src="/files/3c90681745955a68469cbd3e2536aea55a68c4f7" alt="" width="195"><figcaption><p>选择 store_id</p></figcaption></figure>

<figure><img src="/files/a0346d812b3f1dfbb04fb2ad97dce3b7d52cacb9" alt="" width="244"><figcaption><p>选择可用性选项</p></figcaption></figure>

<table><thead><tr><th width="230">参数</th><th width="247.328125">描述</th><th>类型</th></tr></thead><tbody><tr><td><code>store_id</code></td><td>指定门店。</td><td>字符串</td></tr><tr><td><code>pickup_at_store_eligible</code></td><td>店内可取。</td><td>布尔值</td></tr><tr><td><code>in_stock_today</code></td><td>商品今天有库存。</td><td>布尔值</td></tr><tr><td><code>fulfillment_center</code></td><td>订单可从集中的 Menards 仓库发货。</td><td>布尔值</td></tr><tr><td><code>delivery_eligible</code></td><td>商品符合送货上门服务条件。</td><td>布尔值</td></tr></tbody></table>

## Publix

适配 [Publix](/api-targets/cn/e-commerce/publix.md) 基于门店位置的结果。

<figure><img src="/files/46606187c15f8edf73ecd690f16920797f6975f4" alt="" width="563"><figcaption></figcaption></figure>

<table><thead><tr><th width="157.34375">参数</th><th width="383.1223958333333">描述</th><th>类型</th></tr></thead><tbody><tr><td><code>store_id</code></td><td>指定门店。请参见 <a href="https://files.gitbook.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FzrXw45naRpCZ0Ku9AjY1%2Fuploads%2FBnY1mBp2TzLykr7HkhkR%2Fpublix_store_data.json?alt=media&#x26;token=6b66ce31-745b-4558-8b26-6d74c561ded2"><strong>此处的可用值</strong></a>.</td><td>整数</td></tr></tbody></table>

## 目标

<figure><img src="/files/d389c0c723f61662e3ef88bc645359a83a04c299" alt="" width="313"><figcaption><p>选择 geo_location 和 store_id</p></figcaption></figure>

<figure><img src="/files/9db101957fa5d318f7e15893476ceb82997bc689" alt="" width="375"><figcaption><p>选择 fulfillment_type</p></figcaption></figure>

<table><thead><tr><th width="230">参数</th><th width="298.41796875">描述</th><th>类型</th></tr></thead><tbody><tr><td><code>store_id</code></td><td>指定门店。</td><td>字符串</td></tr><tr><td><code>fulfillment_type</code></td><td>指定订单履约方式。可用值： <code>pickup</code>, <code>shop_in_store</code>, <code>same_day_delivery</code>, <code>shipping</code>.</td><td>布尔值</td></tr></tbody></table>

## The Home Depot

使用 `geo_location` 参数用于按 **zip code** 还是 **国家**.

你也可以添加 `store_id` 在 `上下文` 参数用于门店特定数据。Store ID 必须是 4 位数字。例如，如果 Store ID 是 3 位数字，请在前面补一个零（例如，618 -> `0618`）。查找 Home Depot 门店 ID 列表 [**这里**](https://www.homedepot.com/l/storeDirectory).

<div><figure><img src="/files/c1b83fddfba0fb8a17b37434d61cba0e82403659" alt=""><figcaption></figcaption></figure> <figure><img src="/files/6796cb70ff2efbb42d302627ebfd1c02bb2a3841" alt=""><figcaption></figcaption></figure></div>

```json
...
"geo_location": "29576",
"context": [
    {
        "key": "store_id",
        "value": "2214"
    }
]
...  
```

## Walmart

使用 `delivery_zip` 参数用于根据 **zip code**.

你也可以添加 `store_id` 参数用于门店特定数据。Walmart Store ID 列表请见此处：

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

Walmart 门店的官方页面是 [**这里**](https://www.walmart.com/store-directory)**.**

<div align="center"><figure><img src="/files/38c6e79f857d397a81b958b3ad6cd877895cdb6b" alt=""><figcaption></figcaption></figure></div>

```json
...
"delivery_zip": "60805",
"store_id": "2070"
...  
```

### 国际 Walmart 域名

以下 Walmart 域名也支持本地化。使用 `delivery_zip` 和 `store_id` 作为上下文参数，以设置配送或自提位置，并定位到特定门店。

对于 `walmart.com`, `walmart.com.mx`、以及 `walmart.ca`，您还可以传入 `fulfillment_type` 作为上下文参数，以设置履约方式。

<table><thead><tr><th width="341">域名</th><th>支持的履约类型</th></tr></thead><tbody><tr><td><code>walmart.com</code></td><td><code>pickup</code>, <code>指定配送位置 ZIP 代码。</code>, <code>shipping</code></td></tr><tr><td><code>walmart.com.mx</code></td><td><code>pickup</code>, <code>指定配送位置 ZIP 代码。</code></td></tr><tr><td><code>walmart.ca</code></td><td><code>pickup</code>, <code>指定配送位置 ZIP 代码。</code></td></tr><tr><td><code>walmart.co.cr</code></td><td><code>pickup</code></td></tr></tbody></table>

```json
"context": [
    { "key": "delivery_zip", "value": "06600" },
    { "key": "store_id", "value": "1015" },
    { "key": "fulfillment_type", "value": "delivery" }
]
```

查找下方各域名可用的 `store_id` 值：

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

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

对于 `walmart.co.cr`，履约类型始终为 `pickup`。使用 `delivery_zip` 和 `store_id` 以定位到特定位置。

```json
"context": [
    { "key": "delivery_zip", "value": "10101" },
    { "key": "store_id", "value": "4413" }
]
```

查找下方各域名可用的 `store_id` 以下为 Costa Rica 区域的可用值：

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

### Bodega Aurrerá

使用 `delivery_zip` 参数用于按 ZIP 代码设置以下站点的配送或自提位置： `despensa.bodegaaurrera.com.mx` 仅限域名。您也可以使用 `store_id` 指定门店，并使用 `fulfillment_type`.

| 参数                 | 描述                                      | 类型  |
| ------------------ | --------------------------------------- | --- |
| `delivery_zip`     | 设置配送或自提位置。接受墨西哥邮政编码。                    | 字符串 |
| `store_id`         | 指定门店。                                   | 字符串 |
| `fulfillment_type` | 设置履约方式。可用值： `pickup`, `指定配送位置 ZIP 代码。`. | 字符串 |

```json
"delivery_zip": "06600",
"context": [
    { "key": "store_id", "value": "383" },
    { "key": "fulfillment_type", "value": "delivery" }
]
```

在下方查找可用的 Bodega Aurrerá 门店 ID：

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

### Sam's Club

支持以下两者的本地化 `samsclub.com` （美国）和 `sams.com.mx` （墨西哥）。使用 `delivery_zip` 和 `store_id` 上下文参数设置配送或自提位置，并定位到特定门店。使用 `fulfillment_type` 选择履约方式。

| 参数                 | 描述                                                                                                                          | 类型  |
| ------------------ | --------------------------------------------------------------------------------------------------------------------------- | --- |
| `delivery_zip`     | 设置配送或自提位置。                                                                                                                  | 字符串 |
| `store_id`         | 指定门店。                                                                                                                       | 字符串 |
| `fulfillment_type` | <p>设置履约方式。可用值： <code>指定配送位置 ZIP 代码。</code>, <code>pickup</code>, <code>shipping</code>.</p><p>默认值： <code>pickup</code>.</p> | 字符串 |

```json
"context": [
    { "key": "delivery_zip", "value": "60601" },
    { "key": "store_id", "value": "4702" },
    { "key": "fulfillment_type", "value": "pickup" }
]
```

查找下方各域名可用的 `store_id` 值：

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

{% file src="/files/774bc8206a77c7bc050ec12400132f9a71f44699" %}


---

# 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, and the optional `goal` query parameter:

```
GET https://developers.oxylabs.io/products/cn/web-scraper-api/features/localization/e-commerce-localization.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.