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

# Localización de comercio electrónico

Aprende a extraer datos de comercio electrónico adaptados a ubicaciones específicas de entrega y tienda.

Nuestra Web Scraper API ofrece opciones de localización para recuperar datos de comercio electrónico 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 ajustar los resultados a la disponibilidad y preferencias locales.

#### Soporte de localización específico 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="#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>Target</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>

## Amazon

Usando el `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="https://2786356907-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBQ7Zf9paoN3FTeGcyfY1%2Fuploads%2Fgit-blob-77660421df5ff1ad750844391da513277f6107a2%2FScreenshot%202024-06-21%20at%2011.08.46.png?alt=media" alt=""><figcaption></figcaption></figure> <figure><img src="https://2786356907-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBQ7Zf9paoN3FTeGcyfY1%2Fuploads%2Fgit-blob-b33db6ba30643382e4ee6220cdbad15d514fa0aa%2FScreenshot%202024-06-21%20at%2011.19.14.png?alt=media" alt=""><figcaption></figcaption></figure></div>

Para la mayoría de los dominios de Amazon, puede configurar `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 en algunos casos, este enfoque cubre dos escenarios principales de localización:

* Use 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" }`
* Use un **código de país de 2 letras** para ubicaciones **fuera de** 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 los 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 `dominio` y `configuración regional` parámetros al hacer scraping de Amazon. Más información [**aquí**](/products/es/web-scraper-api/features/localization/domain-locale.md).
{% endhint %}

## Bestbuy

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

<figure><img src="https://2786356907-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBQ7Zf9paoN3FTeGcyfY1%2Fuploads%2Fgit-blob-8e482805b779230e8bc71a082859d865601df672%2Fimage.png?alt=media" 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>Especifique una tienda.</td><td>-</td><td>Entero</td></tr><tr><td><code>delivery_zip</code></td><td>Establezca la ubicación del código postal de entrega.</td><td>-</td><td>Cadena</td></tr><tr><td><code>fulfillment_type</code></td><td>Especifique el método de cumplimiento del pedido. Valores disponibles: <code>pickup</code>, <code>shipping</code></td><td>-</td><td>Cadena</td></tr></tbody></table>

## Etsy

Ajuste los resultados a tiendas y ubicaciones de entrega específicas.

<figure><img src="https://2786356907-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBQ7Zf9paoN3FTeGcyfY1%2Fuploads%2Fgit-blob-f6a8576b55da38fb1326639e9fb4d992aa437ccc%2Fimage.png?alt=media" alt="" width="375"><figcaption><p>Seleccione store_id</p></figcaption></figure>

<figure><img src="https://2786356907-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBQ7Zf9paoN3FTeGcyfY1%2Fuploads%2Fgit-blob-47c985c12bdebead0550a23122216aa5f74e7def%2Fimage.png?alt=media" alt="" width="375"><figcaption><p>Seleccione 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>Especifique una tienda.</td><td>Entero</td></tr><tr><td><code>geo_location</code></td><td>Establezca el destino de envío.</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>Especifique una tienda. Consulte 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á configurado en <code>pickup</code> o <code>in_store</code>.</td></tr><tr><td><code>delivery_zip</code></td><td>Especifique el código postal de la ubicación de entrega.</td><td>-</td><td>Requerido cuando <code>fulfillment_type</code> está configurado en <code>delivery</code>.</td></tr><tr><td><code>fulfillment_type</code></td><td>Especifique el método de cumplimiento del pedido. Valores disponibles: <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 `fulfillment_type` y `store_id`/`delivery_zip` combinación no es válida (no admitida por Kroger), la página extraída devolverá un estado 404.
{% endhint %}

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

## Lowe's

<figure><img src="https://2786356907-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBQ7Zf9paoN3FTeGcyfY1%2Fuploads%2Fgit-blob-999d4086e3683e51e20f65cffd65e7180ba45642%2Fimage.png?alt=media" alt=""><figcaption><p>Seleccione 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>Especifique una tienda.</td><td>Entero</td></tr><tr><td><code>delivery_zip</code></td><td>Especifique el código postal de la ubicación de entrega.</td><td>Cadena</td></tr></tbody></table>

## Menards

Ajuste los resultados a tiendas y opciones de disponibilidad específicas.

<figure><img src="https://2786356907-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBQ7Zf9paoN3FTeGcyfY1%2Fuploads%2Fgit-blob-a46c674b0588424f4e0fd46ed94218723e97abfc%2Fimage.png?alt=media" alt="" width="195"><figcaption><p>Seleccione store_id</p></figcaption></figure>

<figure><img src="https://2786356907-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBQ7Zf9paoN3FTeGcyfY1%2Fuploads%2Fgit-blob-3c6942469c6544c8a24d961f9f77385e7f8d4f79%2Fimage.png?alt=media" alt="" width="244"><figcaption><p>Seleccione 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>Especifique una tienda.</td><td>Cadena</td></tr><tr><td><code>pickup_at_store_eligible</code></td><td>Recogida disponible en 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 servicio de entrega a domicilio.</td><td>Booleano</td></tr></tbody></table>

## Publix

Ajuste [Publix](https://developers.oxylabs.io/api-targets/es/e-commerce/publix) los resultados según las ubicaciones de las tiendas.

<figure><img src="https://2786356907-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBQ7Zf9paoN3FTeGcyfY1%2Fuploads%2Fgit-blob-5cbb6e9a155b75da89e7fecf2e6ae2e3db49fe8d%2Fpublix_store.png?alt=media" 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>Especifique una tienda. Consulte 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>

## Target

<figure><img src="https://2786356907-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBQ7Zf9paoN3FTeGcyfY1%2Fuploads%2Fgit-blob-4c7d8df337ff2f3446d231b2d93f5499ee4f3090%2Fimage.png?alt=media" alt="" width="313"><figcaption><p>Seleccione geo_location y store_id</p></figcaption></figure>

<figure><img src="https://2786356907-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBQ7Zf9paoN3FTeGcyfY1%2Fuploads%2Fgit-blob-151b675f28edaa8ec22ab8d5ec9be30482819c38%2Fimage.png?alt=media" alt="" width="375"><figcaption><p>Seleccione 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>Especifique una tienda.</td><td>Cadena</td></tr><tr><td><code>fulfillment_type</code></td><td>Especifique 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

Usa el `geo_location` parámetro para establecer la ubicación de entrega por **código postal** o **país**.

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

<div><figure><img src="https://2786356907-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBQ7Zf9paoN3FTeGcyfY1%2Fuploads%2Fgit-blob-9213d746aab70e2829485a054dea3b03d019f446%2Fimage%20(27).png?alt=media" alt=""><figcaption></figcaption></figure> <figure><img src="https://2786356907-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBQ7Zf9paoN3FTeGcyfY1%2Fuploads%2Fgit-blob-53850d9bf4bde80b54f2dfc0013b842b5347eb0b%2FScreenshot%202024-07-12%20at%2016.28.47.png?alt=media" alt=""><figcaption></figcaption></figure></div>

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

## Walmart

Usa el `delivery_zip` parámetro para especificar ubicaciones de entrega de Walmart basadas en **código postal**.

También puede añadir `store_id` parámetro para datos específicos de la tienda. Encuentre la lista de IDs de tienda de Walmart aquí:

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

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

<div align="center"><figure><img src="https://2786356907-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBQ7Zf9paoN3FTeGcyfY1%2Fuploads%2Fgit-blob-79fb4cc07999f1bf5d95da8e019e14f45947ff42%2FScreenshot%202024-11-13%20at%2014.22.18.png?alt=media" 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. Use `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 puede 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" }
]
```

Encuentre 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`. Use `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" }
]
```

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

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

### Bodega Aurrerá

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

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

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

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

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

### Sam's Club

La localización es compatible tanto con `samsclub.com` (EE. UU.) y `sams.com.mx` (México). Use 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. Use `fulfillment_type` para seleccionar el método de cumplimiento.

| Parámetro          | Descripción                                                                                                                                                                     | Tipo   |
| ------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------ |
| `delivery_zip`     | Establezca la ubicación de entrega o recogida.                                                                                                                                  | Cadena |
| `store_id`         | Especifique una tienda.                                                                                                                                                         | Cadena |
| `fulfillment_type` | <p>Establezca el método de cumplimiento. Valores disponibles: <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" }
]
```

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

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

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


---

# 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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

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

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
