Documentation has been updated: see help center and changelog in one place.
🆕Explore
LogoLogo
Oxylabs dashboardContact usProduct
English
  • Documentation
  • Help center
  • Changelog
English
  • Overview
  • PROXIES
    • Integration Guides
      • Get IP Address for Integrations
      • Residential Proxies Guides
        • AdsPower
        • Android
        • ClonBrowser
        • Dolphin Anty
        • Ghost Browser
        • GoLogin
        • Helium Scraper
        • Incogniton
        • iOS
        • Kameleo
        • Lalicat Browser
        • MacOS
        • MoreLogin
        • MuLogin
        • Multilogin
        • Nstbrowser
        • Octoparse
        • Oxy® Proxy Extension for Chrome
        • ParseHub
        • Playwright
        • Puppeteer
        • Selenium
        • SEO Neo
        • SessionBox
        • Shadowrocket
        • Super Proxy
        • SwitchyOmega
        • Ubuntu
        • VMLogin
        • WebHarvy
        • Hidemyacc
      • ISP Proxies Guides
        • AdsPower
        • Android
        • Dolphin Anty
        • FoxyProxy
        • GoLogin
        • Incogniton
        • iOS
        • Lalicat Browser
        • MacOS
        • MoreLogin
        • MuLogin
        • Multilogin
        • Nstbrowser
        • Octoparse
        • Oxy® Proxy Extension for Chrome
        • SEO Neo
        • Shadowrocket
        • Sphere
        • Super Proxy
        • SwitchyOmega
        • Ubuntu
        • Hidemyacc
      • Mobile Proxies Guides
        • AdsPower
        • Android
        • ClonBrowser
        • Dolphin Anty
        • Ghost Browser
        • GoLogin
        • Helium Scraper
        • Incogniton
        • iOS
        • Kameleo
        • Lalicat Browser
        • MacOS
        • MoreLogin
        • MuLogin
        • Multilogin
        • Nstbrowser
        • Octoparse
        • Oxy® Proxy Extension for Chrome
        • ParseHub
        • Playwright
        • Puppeteer
        • Selenium
        • SEO Neo
        • SessionBox
        • Shadowrocket
        • SwitchyOmega
        • Ubuntu
        • VMLogin
        • WebHarvy
      • Dedicated Datacenter Proxies Guides
        • Enterprise
          • Dolphin Anty
          • FoxyProxy
          • GoLogin
          • Lalicat Browser
          • MoreLogin
          • MuLogin
          • Nstbrowser
          • Octoparse
          • Oxy® Proxy Extension for Chrome
          • SEO Neo
          • Shadowrocket
          • Sphere
          • Super Proxy
          • SwitchyOmega
          • Ubuntu
          • Hidemyacc
        • Self-Service
          • Android
          • Dolphin Anty
          • FoxyProxy
          • GoLogin
          • iOS
          • Lalicat Browser
          • MacOS
          • MoreLogin
          • MuLogin
          • Nstbrowser
          • Octoparse
          • Oxy® Proxy Extension for Chrome
          • SEO Neo
          • Shadowrocket
          • Sphere
          • Super Proxy
          • SwitchyOmega
          • Ubuntu
          • Hidemyacc
      • Datacenter Proxies Guides
        • AdsPower
        • Android
        • Dolphin Anty
        • GoLogin
        • iOS
        • Lalicat Browser
        • MacOS
        • MoreLogin
        • MuLogin
        • Nstbrowser
        • Octoparse
        • Oxy® Proxy Extension for Chrome
        • SEO Neo
        • Shadowrocket
        • Super Proxy
        • SwitchyOmega
        • Ubuntu
        • Hidemyacc
    • Residential Proxies
      • Getting Started
      • Making Requests
        • Entry Node for China
      • Location Settings
        • Country
        • City
        • State
        • Continent
        • ZIP/Postal code
        • Coordinates
        • ASN Targeting
      • Session Control
        • Sticky Proxy Entry Nodes
      • Protocols
      • Whitelisting IPs
        • Requests with Whitelisted IPs
      • Endpoint Generator
      • Restricted Targets
      • Public API
      • Response Codes
    • ISP Proxies
      • Making Requests
      • Proxy List
      • Proxy Rotation
      • Location Settings
      • Protocols
      • Whitelisting IPs
      • Response Codes
      • Restricted Targets
      • Fair usage policy
    • Mobile Proxies
      • Getting Started
      • Making Requests
        • Entry Node for China
      • Location Settings
        • Country
        • City
        • State
        • Continent
        • Coordinates
        • ASN Targeting
      • Session Control
        • Sticky Proxy Entry Nodes
      • Protocols
      • Whitelisting IPs
      • Endpoint Generator
      • Restricted Targets
      • Public API
      • Response Codes
    • Datacenter Proxies
      • Proxy List
      • IP Control
      • Select Country
      • Protocols
      • Whitelisting
      • Response Codes
      • Restricted Targets
      • Fair usage policy
      • Free Datacenter IPs
    • Dedicated Datacenter Proxies
      • Enterprise
        • Getting Started
        • Proxy List
        • Making Requests
        • Protocols
        • Whitelisting IPs
          • Dashboard
          • RESTful
            • Getting Whitelisted IPs List
            • Adding a Whitelisted IP
            • Removing a Whitelisted IP
            • Saving Changes (5min Cooldown)
        • Datacenter Proxy API
        • Proxy Rotator - Optional
        • Response Codes
      • Self-Service
        • Getting Started
        • Making Requests
        • Proxy List
        • Proxy Rotation
        • Location Settings
        • Protocols
        • Whitelisting IPs
        • Response Codes
        • Restricted Targets
        • Fair usage policy
    • Dedicated ISP Proxies
      • Getting Started
      • Proxy List
      • Making Requests
      • Protocols
      • Whitelisting IPs (RESTful)
        • Getting Whitelisted IPs List
        • Adding a Whitelisted IP
        • Removing a Whitelisted IP
        • Saving Changes (5min Cooldown)
      • Proxy API
      • Proxy Rotator - Optional
      • Response Codes
  • Advanced proxy solutions
    • Web Unblocker
      • Getting Started
      • Making Requests
        • Session
        • Geo-location
        • Headers & Cookies
        • Custom status code
        • POST requests
      • Headless Browser
        • JavaScript rendering
        • Browser instructions (Beta)
          • List of instructions
      • Sample Response
      • Response Codes
      • Rate Limits
      • Migration Guides
        • From Bright Data Web Unlocker
      • Usage Statistics
      • Billing Information
  • VIDEO DATA
    • High-Bandwidth Proxies
      • YouTube Downloader (yt_dlp) integration
  • Video Data API
  • Scraper APIs
    • Web Scraper API
      • Integration Methods
        • Realtime
        • Push-Pull
        • Proxy Endpoint
      • Features
        • Localization
          • Proxy Location
          • SERP Localization
          • E-Commerce Localization
          • Domain, Locale, Results Language
        • JS Rendering & Browser Control
          • JavaScript Rendering
          • Browser Instructions
            • List of instructions
        • Result Processing & Storage
          • Dedicated Parsers
          • Custom Parser
            • Getting started
            • Parsing instruction examples
            • List of functions
              • Function examples
          • Download Images
          • Cloud Storage
        • HTTP Context & Job Management
          • Headers, Cookies, Method
          • User Agent Type
          • Client Notes
        • Scheduler
      • Solutions for AI Workflows
        • Model Context Protocol (MCP)
        • LangChain
        • LlamaIndex
      • Targets
        • Google
          • Search
            • Web Search
            • AI Overviews
            • Image Search
            • News Search
            • Local Search
            • Reverse Image Search
            • Google Suggest
          • Ads Max
          • Shopping
            • Shopping Product
            • Shopping Search
            • Shopping Pricing
          • Trends: Explore
          • Travel: Hotels
          • Lens
          • URL
        • Amazon
          • Product
          • Search
          • Pricing
          • Sellers
          • Best Sellers
          • Reviews
          • Questions & Answers
          • URL
        • YouTube
          • YouTube Scraping Guide for AI
          • YouTube Search
          • YouTube Video Trainability
          • YouTube Metadata
          • YouTube Downloader
          • YouTube Transcript
        • Generic Target
        • Walmart
          • Search
          • Product
        • Ebay
        • Etsy
          • Search
          • Product
        • Bing
          • Search
          • URL
        • North American E-Commerce
          • Best Buy
            • Search
            • Product
          • Target
            • Search
            • Product
            • Category
          • Kroger
            • Product
            • Search
            • URL
          • Costco
          • Bed Bath & Beyond
          • Menards
          • Petco
          • Staples
          • Grainger
          • Instacart
        • European E-Commerce
          • Allegro
            • Search
            • Product
          • Idealo
          • Mediamarkt
          • Cdiscount
        • Asian E-Commerce
          • Alibaba
          • Aliexpress
          • Lazada
          • Rakuten
          • Tokopedia
          • Flipkart
          • Avnet
          • Indiamart
        • Latin American E-Commerce
          • Mercado Livre
          • Magazine Luiza
          • Falabella
          • Dcard
      • Restricted Targets
      • Response Codes
    • OxyCopilot (Beta)
    • Usage and Billing
      • Usage Statistics
      • Traffic and Billing
      • Rate Limits
    • Unblocking Browser
      • Chrome
      • Firefox
      • Device Type
      • Restricted Targets
      • Integration with MCP
  • Dashboard
    • Teams
    • Billing Information
      • Accessing Billing Information
      • Managing Payment Methods
      • Updating Billing Information
      • Canceling a Subscription
    • IP Replacement
  • Guides for Scraper APIs
    • Python SDK
    • Go SDK
    • Forming Requests
    • Forming URLs
    • Using Postman
  • Useful links
    • Oxylabs Dashboard
    • Release Notes
    • Network status
    • Open Source Tools
      • Oxy Parser
      • Oxy Mouse
      • Web Scraper API Scheduler
    • Discord Community
    • GitHub
    • Scraping Experts
  • SUPPORT
    • FAQ
    • Have a Question?
Powered by GitBook
On this page
  • Amazon
  • Walmart
  • The Home Depot
  • Kroger
  • Bestbuy
  • Allegro
  • Etsy
  • Petco
  • Menards
  • Target

Was this helpful?

  1. Scraper APIs
  2. Web Scraper API
  3. Features
  4. Localization

E-Commerce Localization

PreviousSERP LocalizationNextDomain, Locale, Results Language

Last updated 2 months ago

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.

Website-Specific Localization Support

Domain
Geo Location / Delivery
Store ID
Fulfillment type

ZIP code or 2-letter country code

-

-

ZIP code or country

Supported

Supported

ZIP code or country

Supported

-

ZIP code

Supported

Supported

Bestbuy

ZIP code

Supported

Supported

Allegro

-

Supported

-

Etsy

ZIP code or 2-letter country code

Supported

-

Petco

-

Supported

Supported

Menards

-

Supported

Supported

Target

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.

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.

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.

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.

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.

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.

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

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

Amazon
Walmart
The Home Depot
Kroger
Set the delivery_type
Set the shipping_from location
Set the store_city and store_region
Select store_id
Select delivery location
Select store_id
Select fulfillment_type
Select store_id
Select availability options
Select geo_location and store_id
Select fulfillment_type