> 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/pt-br/web-scraper-api/features/localization/e-commerce-localization.md).

# 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 do 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 atendimento</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 de 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 de 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>Alvo</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 país</td><td>Suportado</td><td>-</td></tr><tr><td><a href="#walmart"><strong>Walmart</strong></a></td><td>CEP ou país</td><td>Suportado</td><td>Suportado</td></tr></tbody></table>

## Allegro

Adapte os resultados a 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/262f79d903fc8d9765de99d2b9075e3ca78bd3d0" alt="" width="283"><figcaption><p>Defina o local de origem do envio</p></figcaption></figure>

<figure><img src="/files/bdf3c1736a9dc2f25fbbea21cd3e191958783966" alt="" width="284"><figcaption><p>Defina a cidade e a região da loja</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. 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 o local de origem do envio. 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. 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` O parâmetro personaliza os resultados da Amazon com base nas preferências de entrega, como mostrado nas capturas de tela abaixo:

<div><figure><img src="/files/d052d620e40d04cff949120392242c9d3e7573b8" alt=""><figcaption></figcaption></figure> <figure><img src="/files/fd75608344ca1c66aaffc0802eb23c339f23c833" 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 de 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 locais **dentro** o país do marketplace. Pares de exemplo:
  * `{ "domain": "com", "geo_location": "90210" }`
  * `{ "domain": "co.uk", "geo_location": "W105LT" }`
* Use um **código de país de 2 letras** para locais **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 oferecem suporte a 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 a 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 por 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 local de entrega pelo CEP.</td><td>-</td><td>string</td></tr><tr><td><code>fulfillment_type</code></td><td>Especifique o método de atendimento do pedido. Valores disponíveis: <code>pickup</code>, <code>shipping</code></td><td>-</td><td>string</td></tr></tbody></table>

## Etsy

Adapte os resultados a lojas e locais de entrega específicos.

<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 o local de 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 atendimento 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` os 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 `fulfillment_type` e `store_id`/`delivery_zip` combinação for inválida (não suportada pela Kroger), a página raspada retornará com 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 a lojas e opções de disponibilidade específicas.

<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>boolean</td></tr><tr><td><code>in_stock_today</code></td><td>O item está em estoque hoje.</td><td>boolean</td></tr><tr><td><code>fulfillment_center</code></td><td>O pedido pode ser enviado de um depósito centralizado da Menards.</td><td>boolean</td></tr><tr><td><code>delivery_eligible</code></td><td>O item se qualifica para o serviço de entrega em domicílio.</td><td>boolean</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>

## Alvo

<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 atendimento do pedido. Valores disponíveis são: <code>pickup</code>, <code>shop_in_store</code>, <code>same_day_delivery</code>, <code>shipping</code>.</td><td>boolean</td></tr></tbody></table>

## The Home Depot

Use o `geo_location` parâmetro para definir o local de entrega por **CEP** ou **país**.

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, adicione um zero à esquerda (por exemplo, 618 -> `0618`). Encontre a lista de IDs de lojas do Home Depot [**aqui**](https://www.homedepot.com/l/storeDirectory).

<div><figure><img src="/files/ed512132126cea142802d580ab397f5bfec4c74f" alt=""><figcaption></figcaption></figure> <figure><img src="/files/e980d7891c656f1927100024a044dc3043fccad0" alt=""><figcaption></figcaption></figure></div>

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

## Walmart

Use o `delivery_zip` parâmetro para especificar locais de entrega do Walmart com base em **CEP**.

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

{% 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 do Walmart

A localização também é suportada para os seguintes domínios do 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 um parâmetro de contexto para definir o método de atendimento.

<table><thead><tr><th width="341">Domínio</th><th>Tipos de atendimento 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 atendimento é sempre `pickup`. Use `delivery_zip` e `store_id` para direcionar uma localidade específica.

```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` somente o domínio. Você também pode especificar uma loja com `store_id` e selecionar um método de atendimento 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 atendimento. 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 lojas da Bodega Aurrerá disponíveis:

{% file src="/files/431c249d8f571c09a4e6ce2f8cf22158fba2c551" %}

### 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 atendimento.

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