> 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>邮政编码或 <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>邮政编码</td><td>支持</td><td>支持</td></tr><tr><td><a href="#bodega-aurrera"><strong>Bodega Aurrerá</strong></a></td><td>邮政编码</td><td>支持</td><td>支持</td></tr><tr><td><a href="#etsy"><strong>Etsy</strong></a></td><td>邮政编码或 <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>邮政编码</td><td>支持</td><td>支持</td></tr><tr><td><a href="#lowes"><strong>Lowes</strong></a></td><td>邮政编码</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>邮政编码</td><td>支持</td><td>支持</td></tr><tr><td><a href="#target"><strong>目标</strong></a></td><td>邮政编码</td><td>支持</td><td>支持</td></tr><tr><td><a href="#the-home-depot"><strong>The Home Depot</strong></a></td><td>邮政编码或国家</td><td>支持</td><td>-</td></tr><tr><td><a href="#walmart"><strong>Walmart</strong></a></td><td>邮政编码或国家</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/652471765ac1b57fd1d2bd15ac9fff6fdf9e15c3" 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/577a8ace6ebddbefba17a1f7648c867c67dd9195" alt=""><figcaption></figcaption></figure> <figure><img src="/files/5500e25644bb610a185ecb31962b84b467edd39a" 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" %}
你也可以在抓取 Google 时使用 `域名` 和 `locale` 在抓取 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>设置配送邮政编码位置。</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>delivery</code>.</td></tr><tr><td><code>fulfillment_type</code></td><td>指定订单履约方式。可用值： <code>pickup</code>, <code>delivery</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>delivery</code>.</td></tr></tbody></table>

**依赖关系说明：**

* `pickup` 和 `in_store` 值使用 `store_id` 参数来确定正确的门店。
* `delivery` 使用 `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/dian-zi-shang-wu/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` 参数按 **邮政编码** 或 **country**.&#x20;

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

<div><figure><img src="/files/f99b86070616375dca453a45b337f9656693ab39" alt=""><figcaption></figcaption></figure> <figure><img src="/files/3f0694ed3b04833ffe13b846e2423d4679936303" alt=""><figcaption></figcaption></figure></div>

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

## Walmart

使用 `delivery_zip` 参数，用于基于 **邮政编码**.&#x20;

你也可以在 `store_id` 参数用于门店特定数据。查找 Walmart Store ID 列表：&#x20;

{% 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>delivery</code>, <code>shipping</code></td></tr><tr><td><code>walmart.com.mx</code></td><td><code>pickup</code>, <code>delivery</code></td></tr><tr><td><code>walmart.ca</code></td><td><code>pickup</code>, <code>delivery</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` 参数，可按邮政编码为 `despensa.bodegaaurrera.com.mx` 仅此域设置配送或取货位置。你也可以使用 `store_id` 指定门店，并使用 `fulfillment_type`.

| 参数                 | 说明                                | 类型  |
| ------------------ | --------------------------------- | --- |
| `delivery_zip`     | 设置配送或取货位置。接受墨西哥邮政编码。              | 字符串 |
| `store_id`         | 指定一个门店。                           | 字符串 |
| `fulfillment_type` | 设置履约方式。可用值： `pickup`, `delivery`. | 字符串 |

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

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

{% file src="/files/9720fb92f9b2c2d36508848c463c435570bc6b18" %}

### Sam's Club

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

| 参数                 | 说明                                                                                                                     | 类型  |
| ------------------ | ---------------------------------------------------------------------------------------------------------------------- | --- |
| `delivery_zip`     | 设置配送或取货位置。                                                                                                             | 字符串 |
| `store_id`         | 指定一个门店。                                                                                                                | 字符串 |
| `fulfillment_type` | <p>设置履约方式。可用值： <code>delivery</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:

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

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.