localization
Multi-language and geo-location support with timezone spoofing and Accept-Language headers. Perfect for international scraping, bypassing geo-blocks, and accessing regional content.
Use Cases
International Scraping
Access region-specific content from multiple countries with proper localization
Geo-Blocked Content
Bypass geo-restrictions and access content limited to specific regions
Regional Pricing
Compare prices across different countries for e-commerce and travel sites
Multi-Language Sites
Scrape content in different languages with proper Accept-Language headers
Localized Search
Get search results as they appear to users in specific countries
Market Research
Analyze how content, pricing, and availability vary across regions
Endpoint
/api/v1/tools/localizationParameters
| Name | Type | Required | Default | Description |
|---|---|---|---|---|
operation | string | Required | - | Localization operation: "configure_country", "localize_search", "localize_browser", or "handle_geo_blocking" Example: localize_browser |
countryCode | string | Required | - | Two-letter ISO 3166-1 country code (e.g., US, GB, JP) Example: JP |
language | string | Optional | - | Two-letter ISO 639-1 language code (e.g., en, es, ja) Example: ja |
geoLocation | object | Optional | - | GPS coordinates for geo-location spoofing Example: {"latitude": 35.6762, "longitude": 139.6503} |
timezone | string | Optional | - | IANA timezone identifier (e.g., America/New_York, Asia/Tokyo) Example: Asia/Tokyo |
url | string | Optional | - | Target URL to scrape with localization settings Example: https://example.com |
Available Operations
Request Examples
Response Example
{ "success": true, "data": { "localizedContent": "ja\">...", "detectedLanguage": "ja", "countryCode": "JP", "timezone": "Asia/Tokyo", "geoLocation": { "latitude": 35.6762, "longitude": 139.6503, "city": "Tokyo", "region": "Tokyo", "country": "Japan" }, "headers": { "Accept-Language": "ja-JP,ja;q=0.9", "Accept-Encoding": "gzip, deflate, br", "User-Agent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36" }, "regionSpecificData": { "currency": "JPY", "currencySymbol": "¥", "dateFormat": "YYYY/MM/DD", "timeFormat": "24h" } }, "credits_used": 2, "credits_remaining": 998, "processing_time": 1850}data.localizedContentPage content as it appears to users in the specified countrydata.detectedLanguageLanguage detected from the content (ISO 639-1)data.countryCodeCountry code used for localizationdata.geoLocationGeo-location details including city and regiondata.headersHTTP headers sent with localization settingsdata.regionSpecificDataAdditional region-specific formatting (currency, dates)credits_usedCredits deducted for this request (2 per localization)Error Handling
Invalid Country Code (400 Bad Request)
The country code is not a valid ISO 3166-1 code. Use two-letter codes like US, GB, JP.
Invalid Language Code (400 Bad Request)
The language code is not a valid ISO 639-1 code. Use two-letter codes like en, es, ja.
Geo-Blocking Still Active (403 Forbidden)
The content is still geo-blocked despite localization. Some sites use additional verification methods.
Insufficient Credits (402 Payment Required)
Your account doesn't have enough credits (need 2). Purchase more credits or upgrade your plan.
Rate Limit Exceeded (429 Too Many Requests)
You've exceeded your plan's rate limit. Wait a moment or upgrade your plan for higher limits.
Credit Cost
Free Plan: 1,000 credits/month = 500 localizations
Hobby Plan: 5,000 credits/month = 2,500 localizations ($19/mo)
Professional Plan: 50,000 credits/month = 25,000 localizations ($99/mo)
Business Plan: 250,000 credits/month = 125,000 localizations ($399/mo)