E-Commerce Localization

Learn how to scrape e-commerce data tailored to specific delivery and store locations.

Our Web Scraper API offers localization options to retrieve e-commerce data customized to specific delivery and store locations. This page explains how to use the geo_location and store_id and other parameters to align results with local availability and preferences.

Website-Specific Localization Support

Domain	Geo Location / Delivery	Store ID	Fulfillment type
Allegro	-	Supported	-
Amazon	ZIP code or 2-letter country code	-	-
Bestbuy	ZIP code	Supported	Supported
Bodega Aurrerá	ZIP code	Supported	Supported
Etsy	ZIP code or 2-letter country code	Supported	-
Kroger	ZIP code	Supported	Supported
Lowes	ZIP code	Supported	-
Menards	-	Supported	-
Petco	-	Supported	Supported
Publix	-	Supported	-
Sam's Club	ZIP code	Supported	Supported
Target	ZIP code	Supported	Supported
The Home Depot	ZIP code or country	Supported	-
Walmart	ZIP code or country	Supported	Supported

Allegro

Adapt results to specific stores, shipping locations, etc.

Set the delivery_type

Set the shipping_from location

Set the store_city and store_region

Parameter	Description	Type
delivery_time	Set the delivery date. Available values are: one_day, two_days.	String
shipping_from	Set the shipping from location. Available values are: china, czech, poland, hungary, slovakia, eu_countries, allegro_warehouse.	String
store_city	Set the shopping store's city.	String
store_region	Set the shipping store's region. Available values are: "lodz", "opole", "lublin", "mazovia", "silesia", "lubuskie", "podlaskie", "pomerania", "subcarpathia", "lesser_poland", "lower_silesia", "greater_poland", "warmia-masuria", "west_pomerania", "Świętokrzyskie", "kuyavian-pomeranian"	String

Amazon

Using the geo_location parameter customizes Amazon results based on delivery preferences, as shown in the screenshots below:

For most Amazon domains, you can set geo_location with either a zip/postal code or a 2-letter country code. Except for a few cases, this approach covers two main localization scenarios:

• Use a zip/postal code for locations within the marketplace’s country. Example pairs:

  • { "domain": "com", "geo_location": "90210" }

  • { "domain": "co.uk", "geo_location": "W105LT" }

• Use a 2-letter country code for locations outside the marketplace’s country. Example pairs:

  • { "domain": "com", "geo_location": "LT" }

  • { "domain": "de", "geo_location": "US" }

Exceptions

• Unsupported domains: cn, com.tr, com.be, and nl do not support custom delivery locations.

• Special Cases:

  • Australia (com.au): Only accepts Australian postcodes.

  • UAE (.ae): Accepts UAE city names as geo_location, e.g., "geo_location": "Abu Dhabi", or 2-letter country codes.

You can also use domain and locale parameters when scraping Amazon. Learn more here.

Bestbuy

Adapt results to specific domains, stores, delivery locations.

Parameter	Description	Default Value	Type
domain	Domain localization for Bestbuy. Available values: com, ca.	com	String
store_id	Specify a store.	-	Integer
delivery_zip	Set the delivery ZIP location.	-	String
fulfillment_type	Specify order fulfillment method. Available values: pickup, shipping	-	String

Etsy

Adapt results to specific stores, delivery locations.

Select store_id

Select delivery location

Parameter	Description	Type
store_id	Specify a store.	Integer
geo_location	Set the shipping to location.	String

Kroger

Parameter	Description	Default Value	Dependencies
store_id	Specify a store. See the available values here. The ID must start with '0'.	-	Required when fulfillment_type is set to pickup or in_store.
delivery_zip	Specify delivery location ZIP code.	-	Required when fulfillment_type is set to delivery.
fulfillment_type	Specify order fulfillment method. Available values: pickup, delivery, in_store.	pickup (if only store_id is provided)	Requires store_id for pickup and in_store, or delivery_zip for delivery.

Dependecies explained:

• pickup and in_store values use the store_id parameter to determine the correct store.

• delivery uses the delivery_zip parameter to specify the delivery location.

• If only store_id is provided, and fulfillment_type is not specified, the default type is pickup.

If the fulfillment_type and store_id/delivery_zip combination is invalid (unsupported by Kroger), the scraped page will return with a 404 status.

Please note that the contextual parameter is not required to set the store ID with Kroger sources, unlike with other sources.

Lowe's

Select store_id

Parameter	Description	Type
store_id	Specify a store.	Integer
delivery_zip	Specify delivery location ZIP code.	String

Menards

Adapt results to specific stores, availability options.

Select store_id

Select availability options

Parameter	Description	Type
store_id	Specify a store.	String
pickup_at_store_eligible	Pickup available at store.	Boolean
in_stock_today	Item is at stock today.	Boolean
fulfillment_center	Order can be shipped from a centralized Menards warehouse.	Boolean
delivery_eligible	Item qualifies for home delivery service.	Boolean

Petco

Adapt results to specific stores, fulfillment types.

Select store_id

Select fulfillment_type

Parameter	Description	Type
store_id	Specify a store.	String
fulfillment_type	Specify order fulfillment method. Available values are: repeat_delivery, free_pickup_today, same_day_delivery.	Boolean

Publix

Adapt Publix results based on store locations.

Parameter	Description	Type
store_id	Specify a store. See the available values here.	Integer

Target

Select geo_location and store_id

Select fulfillment_type

Parameter	Description	Type
store_id	Specify a store.	String
fulfillment_type	Specify order fulfillment method. Available values are: pickup, shop_in_store, same_day_delivery, shipping.	Boolean

The Home Depot

Use the geo_location parameter to set the delivery location by zip code or country.

You can also add store_id in the context parameter for store-specific data. The Store ID must be a 4-digit number. For example, if the Store ID is a 3-digit number, prefix it with one zero (e.g., 618 -> 0618). Find the list of Home Depot Store IDs here.

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

Walmart

Use the delivery_zip parameter to specify Walmart delivery locations based on zip code.

You can also add store_id parameter for store-specific data. Find the list of Walmart Store IDs here:

294KB

www_walmart_com_stores.csv

Open

The official page of Walmart Stores is here.

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

International Walmart domains

Localization is also supported for the following Walmart domains. Use delivery_zip and store_id as context parameters to set the delivery or pickup location and target a specific store.

For walmart.com, walmart.com.mx, and walmart.ca, you can also pass fulfillment_type as a context parameter to set the fulfillment method.

Domain	Supported fulfillment types
walmart.com	pickup, delivery, shipping
walmart.com.mx	pickup, delivery
walmart.ca	pickup, delivery
walmart.co.cr	pickup

"context": [
    { "key": "delivery_zip", "value": "06600" },
    { "key": "store_id", "value": "1015" },
    { "key": "fulfillment_type", "value": "delivery" }
]

Find the available store_id values for each domain below:

38KB

www_walmart_com_mx_stores.csv

Open

24KB

www_walmart_ca_stores.csv

Open

For walmart.co.cr, the fulfillment type is always pickup. Use delivery_zip and store_id to target a specific location.

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

Find the available store_id values for Costa Rica locale below:

126B

walmart_co_cr_stores.json

Open

Bodega Aurrerá

Use the delivery_zip parameter to set the delivery or pickup location by ZIP code for despensa.bodegaaurrera.com.mx domain only. You can also specify a store with store_id and select a fulfillment method with fulfillment_type.

Parameter	Description	Type
delivery_zip	Set the delivery or pickup location. Accepts a Mexican postal code.	String
store_id	Specify a store.	String
fulfillment_type	Set the fulfillment method. Available values: pickup, delivery.	String

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

Find the available Bodega Aurrerá store IDs below:

23KB

despensa_bodegaaurrera_com_mx_stores.json

Open

Sam's Club

Localization is supported for both samsclub.com (US) and sams.com.mx (Mexico). Use the delivery_zip and store_id context parameters to set the delivery or pickup location and target a specific store. Use fulfillment_type to select the fulfillment method.

Parameter	Description	Type
delivery_zip	Set the delivery or pickup location.	String
store_id	Specify a store.	String
fulfillment_type	Set the fulfillment method. Available values: delivery, pickup, shipping. Default: pickup.	String

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

Find the available store_id values for each domain below:

38KB

www_samsclub_com_stores.csv

Open

16KB

www_sams_com_mx_stores.csv

Open