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/localization
Parameters
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.localizedContent
Page content as it appears to users in the specified countrydata.detectedLanguage
Language detected from the content (ISO 639-1)data.countryCode
Country code used for localizationdata.geoLocation
Geo-location details including city and regiondata.headers
HTTP headers sent with localization settingsdata.regionSpecificData
Additional region-specific formatting (currency, dates)credits_used
Credits 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)