E-Commerce Localization
Last updated
Was this helpful?
Last updated
Was this helpful?
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.
-
-
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
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" }
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.
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.
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.
store_id
-
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
.
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.
Adapt results to specific domains, stores, delivery locations.
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
Adapt results to specific stores, shipping locations, etc.
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:
String
Adapt results to specific stores, delivery locations.
store_id
Specify a store.
Integer
geo_location
Set the shipping to location.
String
Adapt results to specific stores, fulfillment types.
store_id
Specify a store.
String
fulfillment_type
Specify order fulfillment method. Available values are: repeat_delivery
, free_pickup_today
, same_day_delivery
.
Boolean
Adapt results to specific stores, availability options.
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
store_id
Specify a store.
String
fulfillment_type
Specify order fulfillment method. Available values are: pickup
, shop_in_store
, same_day_delivery
, shipping
.
Boolean
ZIP code or
ZIP code or
Specify a store. See the available values . The ID must start with '0'.