E-Commerce Localization

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

ZIP code or country

Supported

Supported

ZIP code or country

Supported

-

ZIP code

Supported

Supported

ZIP code

Supported

Supported

-

Supported

-

Supported

-

-

Supported

Supported

-

Supported

Supported

ZIP code

Supported

Supported

ZIP code

Supported

Supported

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.

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.

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

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

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 or ship.

fulfillment_type

Specify order fulfillment method. Available values: ship, pickup, delivery, in_store.

pickup (if only store_id is provided)

Requires store_id for pickup and in_store, or delivery_zip for delivery and ship.

Dependecies explained:

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

  • delivery and ship use 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.

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

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

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

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

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

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

Lowe's

Select store_id
Parameter
Description
Type

store_id

Specify a store.

Integer

delivery_zip

Specify delivery location ZIP code.

String

Last updated

Was this helpful?