使用场景
国际化抓取
通过适当的本地化访问多个国家/地区的特定区域内容
地理屏蔽的内容
绕过地理限制,访问仅限特定地区的内容
区域定价
为电商和旅游网站比较不同国家/地区的价格
多语言网站
使用适当的 Accept-Language 请求头抓取不同语言的内容
本地化搜索
获取特定国家/地区用户所看到的搜索结果
市场研究
分析内容、定价和可用性在各地区之间的差异
Endpoint
POST
/api/v1/tools/localizationAuth Required
2 req/s on Free plan
2 credits
Parameters
| Name | Type | Required | Default | Description |
|---|---|---|---|---|
operation | string | Required | - | 本地化操作:"configure_country"、"localize_search"、"localize_browser" 或 "handle_geo_blocking" Example: localize_browser |
countryCode | string | Required | - | 两位字母的 ISO 3166-1 国家/地区代码(例如 US、GB、JP) Example: JP |
language | string | Optional | - | 两位字母的 ISO 639-1 语言代码(例如 en、es、ja) Example: ja |
geoLocation | object | Optional | - | 用于地理位置伪装的 GPS 坐标 Example: {"latitude": 35.6762, "longitude": 139.6503} |
timezone | string | Optional | - | IANA 时区标识符(例如 America/New_York、Asia/Tokyo) Example: Asia/Tokyo |
url | string | Optional | - | 使用本地化设置抓取的目标 URL Example: https://example.com |
可用操作
configure_country
设置特定国家/地区的浏览器设置(区域设置、时区、请求头)
localize_search
配置搜索引擎以返回特定区域的结果
localize_browser
设置浏览器以模拟来自特定国家/地区的用户(包含地理位置)
handle_geo_blocking
尝试通过适当的请求头和位置绕过地理限制
请求示例
terminalBash
响应示例
200 OK1850ms
{ "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}Field Descriptions
data.localizedContent指定国家/地区用户所看到的页面内容data.detectedLanguage从内容中检测到的语言(ISO 639-1)data.countryCode用于本地化的国家/地区代码data.geoLocation地理位置详情,包括城市和地区data.headers随本地化设置发送的 HTTP 请求头data.regionSpecificData额外的区域特定格式(货币、日期)credits_used本次请求扣除的 credits(每次本地化 2 个)错误处理
无效的国家/地区代码(400 Bad Request)
该国家/地区代码不是有效的 ISO 3166-1 代码。请使用 US、GB、JP 等两位字母代码。
无效的语言代码(400 Bad Request)
该语言代码不是有效的 ISO 639-1 代码。请使用 en、es、ja 等两位字母代码。
地理屏蔽仍然生效(403 Forbidden)
尽管进行了本地化,内容仍被地理屏蔽。某些网站使用了额外的验证方式。
Credits 不足(402 Payment Required)
您的账户 credits 不足(需要 2 个)。购买更多 credits 或 升级您的套餐。
超出速率限制(429 Too Many Requests)
您已超出套餐的速率限制。请稍候片刻,或 升级您的套餐 以获得更高限额。
专业提示: 为获得最佳效果,请使用 localize_browser 操作,它会自动设置所有本地化参数(语言、时区、地理位置、请求头)。
Credit 费用
2 credits
每次请求 2 credits
每次成功的本地化请求消耗 2 credits,与操作类型无关。
Free 套餐: 1,000 个一次性试用 credits = 500 次本地化
Hobby 套餐: 5,000 credits/月 = 2,500 次本地化($19/mo)
Professional 套餐: 50,000 credits/月 = 25,000 次本地化($99/mo)
Business 套餐: 250,000 credits/月 = 125,000 次本地化($399/mo)
相关工具
准备好试用 localization 了吗?免费注册,获取 1,000 credits,开始构建。