# Localização de e-commerce

Nossa Web Scraper API oferece opções de localização para recuperar dados de e-commerce personalizados para locais específicos de entrega e loja. Esta página explica como usar o `geo_location` e `store_id` e outros parâmetros para alinhar os resultados com a disponibilidade e as preferências locais.

#### Suporte de localização específico por site

<table data-full-width="false"><thead><tr><th width="160">Domínio</th><th width="187">Localização geográfica / Entrega </th><th>ID da loja</th><th>Tipo de fulfillment</th></tr></thead><tbody><tr><td><a href="#allegro"><strong>Allegro</strong></a></td><td>-</td><td>Suportado</td><td>-</td></tr><tr><td><a href="#amazon"><strong>Amazon</strong></a></td><td>CEP ou <a href="https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2"><strong>código do país de 2 letras</strong></a></td><td>-</td><td>-</td></tr><tr><td><a href="#bestbuy"><strong>Bestbuy</strong></a></td><td>CEP</td><td>Suportado</td><td>Suportado</td></tr><tr><td><a href="#bodega-aurrera"><strong>Bodega Aurrerá</strong></a></td><td>CEP</td><td>Suportado</td><td>Suportado</td></tr><tr><td><a href="#etsy"><strong>Etsy</strong></a></td><td>CEP ou <a href="https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2"><strong>código do país de 2 letras</strong></a></td><td>Suportado</td><td>-</td></tr><tr><td><a href="#kroger"><strong>Kroger</strong></a></td><td>CEP</td><td>Suportado</td><td>Suportado</td></tr><tr><td><a href="#lowes"><strong>Lowes</strong></a></td><td>CEP</td><td>Suportado</td><td>-</td></tr><tr><td><a href="#menards"><strong>Menards</strong></a></td><td>-</td><td>Suportado</td><td>-</td></tr><tr><td><a href="#publix"><strong>Publix</strong></a></td><td>-</td><td>Suportado</td><td>-</td></tr><tr><td><a href="#sams-club"><strong>Sam's Club</strong></a></td><td>CEP</td><td>Suportado</td><td>Suportado</td></tr><tr><td><a href="#target"><strong>Destino</strong></a></td><td>CEP</td><td>Suportado</td><td>Suportado</td></tr><tr><td><a href="#the-home-depot"><strong>The Home Depot</strong></a></td><td>CEP ou código do país</td><td>Suportado</td><td>-</td></tr><tr><td><a href="#walmart"><strong>Walmart</strong></a></td><td>CEP ou código do país</td><td>Suportado</td><td>Suportado</td></tr></tbody></table>

## Allegro

Adapte os resultados para lojas específicas, locais de envio etc.

<figure><img src="/files/a61cd6899f5458eadf17ad5da720d7199a214307" alt="" width="283"><figcaption><p>Defina o delivery_type</p></figcaption></figure>

<figure><img src="/files/96187670a87dd1dd1f7a125afa11b6bc0c79f78c" alt="" width="283"><figcaption><p>Defina a localização shipping_from</p></figcaption></figure>

<figure><img src="/files/bdf3c1736a9dc2f25fbbea21cd3e191958783966" alt="" width="284"><figcaption><p>Defina store_city e store_region</p></figcaption></figure>

<table><thead><tr><th width="212">Parâmetro</th><th width="235">Descrição</th><th>Tipo</th></tr></thead><tbody><tr><td><code>delivery_time</code></td><td>Defina a data de entrega. Os valores disponíveis são: <code>one_day</code>, <code>two_days</code>.</td><td>String</td></tr><tr><td><code>shipping_from</code></td><td>Defina a origem do envio. Os valores disponíveis são: <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>String</td></tr><tr><td><code>store_city</code></td><td>Defina a cidade da loja de compras.</td><td>String</td></tr><tr><td><code>store_region</code></td><td><p>Defina a região da loja de envio. Os valores disponíveis são: </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>String</td></tr></tbody></table>

## Amazon

Usando o `geo_location` parametr personaliza os resultados da Amazon com base nas preferências de entrega, como mostrado nas capturas de tela abaixo:

<div><figure><img src="/files/2b0eb01f66c340aa4e75acfa8350f1d2d1e26105" alt=""><figcaption></figcaption></figure> <figure><img src="/files/c1ba99bac626a9260ca56da6063004680fa7d646" alt=""><figcaption></figcaption></figure></div>

Para a maioria dos domínios da Amazon, você pode definir `geo_location` com um CEP/código postal ou um [**código do país de 2 letras**](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2). Exceto por alguns casos, essa abordagem cobre dois cenários principais de localização:

* Use um **CEP/código postal** para localizações **dentro** o país do marketplace. Pares de exemplo:
  * `{ "domain": "com", "geo_location": "90210" }`
  * `{ "domain": "co.uk", "geo_location": "W105LT" }`
* Use um **código do país de 2 letras** para localizações **fora** o país do marketplace. Pares de exemplo:
  * `{ "domain": "com", "geo_location": "LT" }`
  * `{ "domain": "de", "geo_location": "US" }`

#### Exceções

* **Domínios não suportados**: `cn`, `com.tr`, `com.be`, e `nl` não suportam locais de entrega personalizados.
* **Casos especiais**:
  * **Austrália (`com.au`)**: Aceita apenas códigos postais australianos.
  * **EAU (`.ae`)**: Aceita nomes de cidades dos EAU como `geo_location`, por exemplo, `"geo_location": "Abu Dhabi"`, ou códigos de país de 2 letras.

{% hint style="info" %}
Você também pode usar `domain` e `locale` parâmetros ao fazer scraping da Amazon. Saiba mais [**aqui**](/products/pt-br/web-scraper-api/features/localization/domain-locale.md).
{% endhint %}

## Bestbuy

Adapte os resultados para domínios, lojas e locais de entrega específicos.

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

<table><thead><tr><th width="212">Parâmetro</th><th width="180">Descrição</th><th width="135">Valor padrão</th><th>Tipo</th></tr></thead><tbody><tr><td><code>domain</code></td><td>Localização de domínio para Bestbuy. Valores disponíveis: <code>com</code>, <code>ca</code>.</td><td><code>com</code></td><td>String</td></tr><tr><td><code>store_id</code></td><td>Especifique uma loja. </td><td>-</td><td>Inteiro</td></tr><tr><td><code>delivery_zip</code></td><td>Defina o CEP de entrega.</td><td>-</td><td>String</td></tr><tr><td><code>fulfillment_type</code></td><td>Especifique o método de fulfillment do pedido. Valores disponíveis: <code>pickup</code>, <code>shipping</code></td><td>-</td><td>String</td></tr></tbody></table>

## Etsy

Adapte os resultados para lojas específicas, locais de entrega.

<figure><img src="/files/0803e3eb1f05ec68a68ed60755a072c5a7e97edb" alt="" width="375"><figcaption><p>Selecione store_id</p></figcaption></figure>

<figure><img src="/files/92e941d2b40d83444003f986facfd5451295cd0c" alt="" width="375"><figcaption><p>Selecione o local de entrega</p></figcaption></figure>

<table><thead><tr><th width="212">Parâmetro</th><th width="235">Descrição</th><th>Tipo</th></tr></thead><tbody><tr><td><code>store_id</code></td><td>Especifique uma loja. </td><td>Inteiro</td></tr><tr><td><code>geo_location</code></td><td>Defina a origem do envio.</td><td>String</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">Parâmetro</th><th width="172.33333333333331">Descrição</th><th width="153">Valor padrão</th><th>Dependências</th></tr></thead><tbody><tr><td><code>store_id</code></td><td>Especifique uma loja. Veja os valores disponíveis <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>aqui</strong></a>. O ID deve começar com '0'.</td><td>-</td><td>Obrigatório quando  <code>fulfillment_type</code> está definido como <code>pickup</code> ou <code>in_store</code>.</td></tr><tr><td><code>delivery_zip</code></td><td>Especifique o CEP do local de entrega.</td><td>-</td><td>Obrigatório quando  <code>fulfillment_type</code> está definido como <code>delivery</code>.</td></tr><tr><td><code>fulfillment_type</code></td><td>Especifique o método de fulfillment do pedido. Valores disponíveis: <code>pickup</code>, <code>delivery</code>, <code>in_store</code>.</td><td><code>pickup</code> (se apenas <code>store_id</code> for fornecido)</td><td>Requer <code>store_id</code> para <code>pickup</code> e <code>in_store</code>, ou <code>delivery_zip</code> para <code>delivery</code>.</td></tr></tbody></table>

**Dependências explicadas:**

* `pickup` e `in_store` valores usam o `store_id` parâmetro para determinar a loja correta.
* `delivery` usa o `delivery_zip` parâmetro para especificar o local de entrega.
* Se apenas `store_id` for fornecido, e `fulfillment_type` não for especificado, o tipo padrão é `pickup`.

{% hint style="warning" %}
Se a combinação `fulfillment_type` e `store_id`/`delivery_zip` for inválida (não suportada pelo Kroger), a página raspada retornará com um status 404.
{% endhint %}

{% hint style="warning" %}
Observe que o parâmetro contextual não é necessário para definir o ID da loja com fontes Kroger, ao contrário de outras fontes.
{% endhint %}

## Lowe's

<figure><img src="/files/0abc7a0a6fac6af74e1bf3b0f2e1619374670896" alt=""><figcaption><p>Selecione store_id</p></figcaption></figure>

<table><thead><tr><th width="210">Parâmetro</th><th width="342.8841145833333">Descrição</th><th>Tipo</th></tr></thead><tbody><tr><td><code>store_id</code></td><td>Especifique uma loja.</td><td>Inteiro</td></tr><tr><td><code>delivery_zip</code></td><td>Especifique o CEP do local de entrega.</td><td>String</td></tr></tbody></table>

## Menards

Adapte os resultados para lojas específicas, opções de disponibilidade.

<figure><img src="/files/49a6956fea6666c677b31f4d95a41a4dd229bd9a" alt="" width="195"><figcaption><p>Selecione store_id</p></figcaption></figure>

<figure><img src="/files/f037a9a1ad99ecd440801ec9cc1a0ad70d167527" alt="" width="244"><figcaption><p>Selecione opções de disponibilidade</p></figcaption></figure>

<table><thead><tr><th width="230">Parâmetro</th><th width="247.328125">Descrição</th><th>Tipo</th></tr></thead><tbody><tr><td><code>store_id</code></td><td>Especifique uma loja. </td><td>String</td></tr><tr><td><code>pickup_at_store_eligible</code></td><td>Retirada disponível na loja.</td><td>Booleano</td></tr><tr><td><code>in_stock_today</code></td><td>O item está em estoque hoje.</td><td>Booleano</td></tr><tr><td><code>fulfillment_center</code></td><td>O pedido pode ser enviado de um depósito centralizado da Menards.</td><td>Booleano</td></tr><tr><td><code>delivery_eligible</code></td><td>O item se qualifica para serviço de entrega em domicílio.</td><td>Booleano</td></tr></tbody></table>

## Publix

Adapte [Publix](/api-targets/pt-br/e-commerce/publix.md) os resultados com base nas localizações das lojas.

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

<table><thead><tr><th width="157.34375">Parâmetro</th><th width="383.1223958333333">Descrição</th><th>Tipo</th></tr></thead><tbody><tr><td><code>store_id</code></td><td>Especifique uma loja. Veja os <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>valores disponíveis aqui</strong></a>.</td><td>Inteiro</td></tr></tbody></table>

## Destino

<figure><img src="/files/ab5a4d0b365c00b391e9043ed65a40b34780307e" alt="" width="313"><figcaption><p>Selecione geo_location e store_id</p></figcaption></figure>

<figure><img src="/files/eff332197f1abfa4b1e186b8bbb6e5d1ebfcd6a9" alt="" width="375"><figcaption><p>Selecione fulfillment_type</p></figcaption></figure>

<table><thead><tr><th width="230">Parâmetro</th><th width="298.41796875">Descrição</th><th>Tipo</th></tr></thead><tbody><tr><td><code>store_id</code></td><td>Especifique uma loja. </td><td>String</td></tr><tr><td><code>fulfillment_type</code></td><td>Especifique o método de fulfillment do pedido. Os valores disponíveis são: <code>pickup</code>, <code>shop_in_store</code>, <code>same_day_delivery</code>, <code>shipping</code>.</td><td>Booleano</td></tr></tbody></table>

## The Home Depot

Use o `geo_location` parâmetro para definir o local de entrega por **código postal** ou **país**.&#x20;

Você também pode adicionar `store_id` no `contexto` parâmetro para dados específicos da loja. O Store ID deve ser um número de 4 dígitos. Por exemplo, se o Store ID for um número de 3 dígitos, acrescente um zero à esquerda (ex.: 618 -> `0618`). Encontre a lista de Home Depot Store IDs [**aqui**](https://www.homedepot.com/l/storeDirectory).

<div><figure><img src="/files/349f174c61fde448b76cfe39be48075faa130ea0" alt=""><figcaption></figcaption></figure> <figure><img src="/files/0c683d059e29fc3dba74e3616d803ab0ef69ee8f" alt=""><figcaption></figcaption></figure></div>

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

## Walmart

Use o `delivery_zip` parâmetro para especificar os locais de entrega da Walmart com base em **código postal**.&#x20;

Você também pode adicionar `store_id` parâmetro para dados específicos da loja. Encontre a lista de Walmart Store IDs aqui:&#x20;

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

A página oficial das lojas Walmart é [**aqui**](https://www.walmart.com/store-directory)**.**

<div align="center"><figure><img src="/files/5a9f6d39ca2bafe58327b9704279c7e8ec6d8b48" alt=""><figcaption></figcaption></figure></div>

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

### Domínios internacionais da Walmart

A localização também é suportada para os seguintes domínios da Walmart. Use `delivery_zip` e `store_id` como parâmetros de contexto para definir o local de entrega ou retirada e direcionar uma loja específica.

Para `walmart.com`, `walmart.com.mx`, e `walmart.ca`, você também pode passar `fulfillment_type` como parâmetro de contexto para definir o método de fulfillment.

<table><thead><tr><th width="341">Domínio</th><th>Tipos de fulfillment suportados</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" }
]
```

Encontre os `store_id` valores disponíveis para cada domínio abaixo:

{% file src="/files/0f08fc71ccd356e31b3419d23d4de8f0f7714113" %}

{% file src="/files/6a4fddebbb09362494f6324dccadbf1cf188a529" %}

Para `walmart.co.cr`, o tipo de fulfillment é sempre `pickup`. Use `delivery_zip` e `store_id` para direcionar um local específico.

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

Encontre os `store_id` valores para a localidade da Costa Rica abaixo:

{% file src="/files/3e061d95374fa4374effbf3a77377838c51599a4" %}

### Bodega Aurrerá

Use o `delivery_zip` parâmetro para definir o local de entrega ou retirada por CEP para `despensa.bodegaaurrera.com.mx` apenas o domínio. Você também pode especificar uma loja com `store_id` e selecionar um método de fulfillment com `fulfillment_type`.

| Parâmetro          | Descrição                                                                  | Tipo   |
| ------------------ | -------------------------------------------------------------------------- | ------ |
| `delivery_zip`     | Defina o local de entrega ou retirada. Aceita um código postal mexicano.   | String |
| `store_id`         | Especifique uma loja.                                                      | String |
| `fulfillment_type` | Defina o método de fulfillment. Valores disponíveis: `pickup`, `delivery`. | String |

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

Encontre abaixo os IDs de loja disponíveis da Bodega Aurrerá:

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

### Sam's Club

A localização é suportada para ambos `samsclub.com` (EUA) e `sams.com.mx` (México). Use os `delivery_zip` e `store_id` parâmetros de contexto para definir o local de entrega ou retirada e direcionar uma loja específica. Use `fulfillment_type` para selecionar o método de fulfillment.

| Parâmetro          | Descrição                                                                                                                                                          | Tipo   |
| ------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------ |
| `delivery_zip`     | Defina o local de entrega ou retirada.                                                                                                                             | String |
| `store_id`         | Especifique uma loja.                                                                                                                                              | String |
| `fulfillment_type` | <p>Defina o método de fulfillment. Valores disponíveis: <code>delivery</code>, <code>pickup</code>, <code>shipping</code>. </p><p>Padrão: <code>pickup</code>.</p> | String |

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

Encontre os `store_id` valores disponíveis para cada domínio abaixo:

{% file src="/files/218b65bb50f7467a1e669af4345ff18bcd838b0b" %}

{% file src="/files/0a071a1fc02bc9c3f73e78aab97744f1777e4855" %}


---

# 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/products/pt-br/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.