# Localización de comercio electrónico

Nuestra Web Scraper API ofrece opciones de localización para recuperar datos de e-commerce personalizados para ubicaciones específicas de entrega y tienda. Esta página explica cómo usar el `geo_location` y `store_id` y otros parámetros para alinear los resultados con la disponibilidad y las preferencias locales.

#### Compatibilidad de localización específica del sitio web

<table data-full-width="false"><thead><tr><th width="160">Dominio</th><th width="187">Ubicación geográfica / Entrega </th><th>ID de tienda</th><th>Tipo de cumplimiento</th></tr></thead><tbody><tr><td><a href="#allegro"><strong>Allegro</strong></a></td><td>-</td><td>Compatible</td><td>-</td></tr><tr><td><a href="#amazon"><strong>Amazon</strong></a></td><td>código postal o <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>código postal</td><td>Compatible</td><td>Compatible</td></tr><tr><td><a href="#bodega-aurrera"><strong>Bodega Aurrerá</strong></a></td><td>código postal</td><td>Compatible</td><td>Compatible</td></tr><tr><td><a href="#etsy"><strong>Etsy</strong></a></td><td>código postal o <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>Compatible</td><td>-</td></tr><tr><td><a href="#kroger"><strong>Kroger</strong></a></td><td>código postal</td><td>Compatible</td><td>Compatible</td></tr><tr><td><a href="#lowes"><strong>Lowes</strong></a></td><td>código postal</td><td>Compatible</td><td>-</td></tr><tr><td><a href="#menards"><strong>Menards</strong></a></td><td>-</td><td>Compatible</td><td>-</td></tr><tr><td><a href="#publix"><strong>Publix</strong></a></td><td>-</td><td>Compatible</td><td>-</td></tr><tr><td><a href="#sams-club"><strong>Sam's Club</strong></a></td><td>código postal</td><td>Compatible</td><td>Compatible</td></tr><tr><td><a href="#target"><strong>Objetivo</strong></a></td><td>código postal</td><td>Compatible</td><td>Compatible</td></tr><tr><td><a href="#the-home-depot"><strong>The Home Depot</strong></a></td><td>código postal o país</td><td>Compatible</td><td>-</td></tr><tr><td><a href="#walmart"><strong>Walmart</strong></a></td><td>código postal o país</td><td>Compatible</td><td>Compatible</td></tr></tbody></table>

## Allegro

Adapta los resultados a tiendas específicas, ubicaciones de envío, etc.

<figure><img src="/files/5cfbd0b2d746c6a2f93b84b00645f50184c43cd6" alt="" width="283"><figcaption><p>Establece el delivery_type</p></figcaption></figure>

<figure><img src="/files/a087d39f2052458cf00fdb3512b738da1d2697ef" alt="" width="283"><figcaption><p>Establece la ubicación shipping_from</p></figcaption></figure>

<figure><img src="/files/0f142c5b71e6f9f5e9b19ee28f72c129f37670d2" alt="" width="284"><figcaption><p>Establece store_city y store_region</p></figcaption></figure>

<table><thead><tr><th width="212">Parámetro</th><th width="235">Descripción</th><th>Tipo</th></tr></thead><tbody><tr><td><code>delivery_time</code></td><td>Establece la fecha de entrega. Los valores disponibles son: <code>one_day</code>, <code>two_days</code>.</td><td>Cadena</td></tr><tr><td><code>shipping_from</code></td><td>Establece la ubicación de envío desde. Los valores disponibles son: <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>Cadena</td></tr><tr><td><code>store_city</code></td><td>Establece la ciudad de la tienda de compra.</td><td>Cadena</td></tr><tr><td><code>store_region</code></td><td><p>Establece la región de la tienda de envío. Los valores disponibles son: </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>Cadena</td></tr></tbody></table>

## Amazon

Uso del `geo_location` el parámetro personaliza los resultados de Amazon según las preferencias de entrega, como se muestra en las capturas de pantalla a continuación:

<div><figure><img src="/files/a1bb42a56e3c4883b568401e2668da6e90356761" alt=""><figcaption></figcaption></figure> <figure><img src="/files/52c0b1d9c72e1819465273fdab52d63c598f8c30" alt=""><figcaption></figcaption></figure></div>

Para la mayoría de los dominios de Amazon, puedes establecer `geo_location` con un código postal o un [**código de país de 2 letras**](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2). Excepto por algunos casos, este enfoque cubre dos escenarios principales de localización:

* Usa un **código postal** para ubicaciones **dentro de** el país del marketplace. Pares de ejemplo:
  * `{ "domain": "com", "geo_location": "90210" }`
  * `{ "domain": "co.uk", "geo_location": "W105LT" }`
* Usa un **código de país de 2 letras** para ubicaciones **fuera** el país del marketplace. Pares de ejemplo:
  * `{ "domain": "com", "geo_location": "LT" }`
  * `{ "domain": "de", "geo_location": "US" }`

#### Excepciones

* **Dominios no compatibles**: `cn`, `com.tr`, `com.be`, y `nl` no admiten ubicaciones de entrega personalizadas.
* **Casos especiales**:
  * **Australia (`com.au`)**: Solo acepta códigos postales australianos.
  * **EAU (`.ae`)**: Acepta nombres de ciudades de EAU como `geo_location`, por ejemplo, `"geo_location": "Abu Dhabi"`, o códigos de país de 2 letras.

{% hint style="info" %}
También puede usar los parámetros `dominio` y `locale` parámetros al extraer Amazon. Aprende más [**aquí**](/products/es/web-scraper-api/features/localization/domain-locale.md).
{% endhint %}

## Bestbuy

Adapta los resultados a dominios específicos, tiendas, ubicaciones de entrega.

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

<table><thead><tr><th width="212">Parámetro</th><th width="180">Descripción</th><th width="135">Valor predeterminado</th><th>Tipo</th></tr></thead><tbody><tr><td><code>dominio</code></td><td>Localización de dominio para Bestbuy. Valores disponibles: <code>com</code>, <code>ca</code>.</td><td><code>com</code></td><td>Cadena</td></tr><tr><td><code>store_id</code></td><td>Especifica una tienda. </td><td>-</td><td>Entero</td></tr><tr><td><code>delivery_zip</code></td><td>Establece la ubicación ZIP de entrega.</td><td>-</td><td>Cadena</td></tr><tr><td><code>fulfillment_type</code></td><td>Especifica el método de cumplimiento del pedido. Los valores disponibles son: <code>pickup</code>, <code>shipping</code></td><td>-</td><td>Cadena</td></tr></tbody></table>

## Etsy

Adapta los resultados a tiendas específicas, ubicaciones de entrega.

<figure><img src="/files/4e8cb313da204e5a51ae5e3c8ee0c9649948f3bc" alt="" width="375"><figcaption><p>Selecciona store_id</p></figcaption></figure>

<figure><img src="/files/0cea9f8a666bdd687dd451adb87f9234b65b65b1" alt="" width="375"><figcaption><p>Selecciona la ubicación de entrega</p></figcaption></figure>

<table><thead><tr><th width="212">Parámetro</th><th width="235">Descripción</th><th>Tipo</th></tr></thead><tbody><tr><td><code>store_id</code></td><td>Especifica una tienda. </td><td>Entero</td></tr><tr><td><code>geo_location</code></td><td>Establece la ubicación de envío a.</td><td>Cadena</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">Descripción</th><th width="153">Valor predeterminado</th><th>Dependencias</th></tr></thead><tbody><tr><td><code>store_id</code></td><td>Especifica una tienda. Consulta los valores disponibles <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>aquí</strong></a>. El ID debe comenzar con '0'.</td><td>-</td><td>Requerido cuando  <code>fulfillment_type</code> está establecido en <code>pickup</code> o <code>in_store</code>.</td></tr><tr><td><code>delivery_zip</code></td><td>Especifica el código postal de la ubicación de entrega.</td><td>-</td><td>Requerido cuando  <code>fulfillment_type</code> está establecido en <code>delivery</code>.</td></tr><tr><td><code>fulfillment_type</code></td><td>Especifica el método de cumplimiento del pedido. Los valores disponibles son: <code>pickup</code>, <code>delivery</code>, <code>in_store</code>.</td><td><code>pickup</code> (si solo <code>store_id</code> se proporciona)</td><td>Requiere <code>store_id</code> para <code>pickup</code> y <code>in_store</code>, o <code>delivery_zip</code> para <code>delivery</code>.</td></tr></tbody></table>

**Dependencias explicadas:**

* `pickup` y `in_store` los valores usan el `store_id` parámetro para determinar la tienda correcta.
* `delivery` usa el `delivery_zip` parámetro para especificar la ubicación de entrega.
* Si solo `store_id` se proporciona, y `fulfillment_type` no se especifica, el tipo predeterminado es `pickup`.

{% hint style="warning" %}
Si la combinación `fulfillment_type` y `store_id`/`delivery_zip` es inválida (no compatible con Kroger), la página extraída devolverá un estado 404.
{% endhint %}

{% hint style="warning" %}
Ten en cuenta que el parámetro contextual no es necesario para establecer el ID de tienda con las fuentes de Kroger, a diferencia de otras fuentes.
{% endhint %}

## Lowe's

<figure><img src="/files/85b4ab99394dff398a0adb2fb57af17e05ee07f8" alt=""><figcaption><p>Selecciona store_id</p></figcaption></figure>

<table><thead><tr><th width="210">Parámetro</th><th width="342.8841145833333">Descripción</th><th>Tipo</th></tr></thead><tbody><tr><td><code>store_id</code></td><td>Especifica una tienda.</td><td>Entero</td></tr><tr><td><code>delivery_zip</code></td><td>Especifica el código postal de la ubicación de entrega.</td><td>Cadena</td></tr></tbody></table>

## Menards

Adapta los resultados a tiendas específicas, opciones de disponibilidad.

<figure><img src="/files/5b17e3e81198b0e02988dbfbc67b026fdafb1d43" alt="" width="195"><figcaption><p>Selecciona store_id</p></figcaption></figure>

<figure><img src="/files/219fd718aedb0d2ac0581949dc353a1b0c2b757c" alt="" width="244"><figcaption><p>Selecciona opciones de disponibilidad</p></figcaption></figure>

<table><thead><tr><th width="230">Parámetro</th><th width="247.328125">Descripción</th><th>Tipo</th></tr></thead><tbody><tr><td><code>store_id</code></td><td>Especifica una tienda. </td><td>Cadena</td></tr><tr><td><code>pickup_at_store_eligible</code></td><td>Recogida disponible en la tienda.</td><td>Booleano</td></tr><tr><td><code>in_stock_today</code></td><td>El artículo está en stock hoy.</td><td>Booleano</td></tr><tr><td><code>fulfillment_center</code></td><td>El pedido puede enviarse desde un almacén centralizado de Menards.</td><td>Booleano</td></tr><tr><td><code>delivery_eligible</code></td><td>El artículo califica para el servicio de entrega a domicilio.</td><td>Booleano</td></tr></tbody></table>

## Publix

Adapta [Publix](/api-targets/es/comercio-electronico/publix.md) los resultados según las ubicaciones de las tiendas.

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

<table><thead><tr><th width="157.34375">Parámetro</th><th width="383.1223958333333">Descripción</th><th>Tipo</th></tr></thead><tbody><tr><td><code>store_id</code></td><td>Especifica una tienda. Consulta los <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 disponibles aquí</strong></a>.</td><td>Entero</td></tr></tbody></table>

## Objetivo

<figure><img src="/files/c55313a4a49da52e73c572585d60fe96bcaf2575" alt="" width="313"><figcaption><p>Selecciona geo_location y store_id</p></figcaption></figure>

<figure><img src="/files/84989812bc4ee9a095cad69532010af5c9bbe49c" alt="" width="375"><figcaption><p>Selecciona fulfillment_type</p></figcaption></figure>

<table><thead><tr><th width="230">Parámetro</th><th width="298.41796875">Descripción</th><th>Tipo</th></tr></thead><tbody><tr><td><code>store_id</code></td><td>Especifica una tienda. </td><td>Cadena</td></tr><tr><td><code>fulfillment_type</code></td><td>Especifica el método de cumplimiento del pedido. Los valores disponibles son: <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 el `geo_location` parámetro para establecer la ubicación de entrega por **código postal** o **país**.&#x20;

También puedes añadir `store_id` en el `contexto` parámetro para datos específicos de la tienda. El Store ID debe ser un número de 4 dígitos. Por ejemplo, si el Store ID es un número de 3 dígitos, antepón un cero (p. ej., 618 -> `0618`). Encuentra la lista de IDs de tiendas de The Home Depot [**aquí**](https://www.homedepot.com/l/storeDirectory).

<div><figure><img src="/files/7fe25c859d2f9ccf3d8c14c9cbda4a7a0e0e319f" alt=""><figcaption></figcaption></figure> <figure><img src="/files/bd13146b3f7d7402673c79b81032431debf57ec6" alt=""><figcaption></figcaption></figure></div>

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

## Walmart

Use el `delivery_zip` parámetro para especificar ubicaciones de entrega de Walmart según **código postal**.&#x20;

También puedes añadir `store_id` parámetro para datos específicos de la tienda. Encuentra la lista de IDs de tiendas de Walmart aquí:&#x20;

{% file src="/files/5ded26396deefd41a032e346b528a8959d556522" %}

La página oficial de las tiendas Walmart es [**aquí**](https://www.walmart.com/store-directory)**.**

<div align="center"><figure><img src="/files/6d1b1ee538f4f335c8727d0971ab38c6941f840e" alt=""><figcaption></figcaption></figure></div>

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

### Dominios internacionales de Walmart

La localización también es compatible con los siguientes dominios de Walmart. Usa `delivery_zip` y `store_id` como parámetros de contexto para establecer la ubicación de entrega o recogida y apuntar a una tienda específica.

Para `walmart.com`, `walmart.com.mx`, y `walmart.ca`, también puedes pasar `fulfillment_type` como parámetro de contexto para establecer el método de cumplimiento.

<table><thead><tr><th width="341">Dominio</th><th>Tipos de cumplimiento compatibles</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" }
]
```

Encuentra los `store_id` valores disponibles para cada dominio a continuación:

{% file src="/files/6654d80b4b790279540a865ff013e97fc91663e3" %}

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

Para `walmart.co.cr`, el tipo de cumplimiento siempre es `pickup`. Usa `delivery_zip` y `store_id` para apuntar a una ubicación específica.

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

Encuentra los `store_id` valores para la configuración regional de Costa Rica a continuación:

{% file src="/files/316677b528c1f4ec3420d26d321ab08e868ba579" %}

### Bodega Aurrerá

Use el `delivery_zip` parámetro para establecer la ubicación de entrega o recogida por código postal para `despensa.bodegaaurrera.com.mx` solo dominio. También puedes especificar una tienda con `store_id` y seleccionar un método de cumplimiento con `fulfillment_type`.

| Parámetro          | Descripción                                                                             | Tipo   |
| ------------------ | --------------------------------------------------------------------------------------- | ------ |
| `delivery_zip`     | Establece la ubicación de entrega o recogida. Acepta un código postal mexicano.         | Cadena |
| `store_id`         | Especifica una tienda.                                                                  | Cadena |
| `fulfillment_type` | Establece el método de cumplimiento. Los valores disponibles son: `pickup`, `delivery`. | Cadena |

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

Encuentra a continuación los IDs de tienda disponibles de Bodega Aurrerá:

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

### Sam's Club

La localización es compatible tanto para `samsclub.com` (EE. UU.) como para `sams.com.mx` (México). Usa los `delivery_zip` y `store_id` parámetros de contexto para establecer la ubicación de entrega o recogida y apuntar a una tienda específica. Usa `fulfillment_type` para seleccionar el método de cumplimiento.

| Parámetro          | Descripción                                                                                                                                                                             | Tipo   |
| ------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------ |
| `delivery_zip`     | Establece la ubicación de entrega o recogida.                                                                                                                                           | Cadena |
| `store_id`         | Especifica una tienda.                                                                                                                                                                  | Cadena |
| `fulfillment_type` | <p>Establece el método de cumplimiento. Los valores disponibles son: <code>delivery</code>, <code>pickup</code>, <code>shipping</code>. </p><p>Predeterminado: <code>pickup</code>.</p> | Cadena |

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

Encuentra los `store_id` valores disponibles para cada dominio a continuación:

{% file src="/files/134d8beed49230d127ba8ea90b7d62dab32c2b95" %}

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


---

# 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/es/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.