IP Localization API - Country, Timezone, Currency, Language

RapidAPI2026-08-28 更新2026-08-29 收录

数据链接：

https://rapidapi.com/letsworkshane/api/ip-localization-api-country-timezone-currency-language 数据链接链接失效反馈

官方服务：

资源简介：

Get complete localization data from any IP: country, timezone, language, currency, postal format, locale, EU status & calling code. Free tier, no external deps.

创建时间：

2026-08-28

原始信息汇总

数据集概述：IP Localization API - Country, Timezone, Currency, Language

该API是一个IP本地化信息服务，旨在将IP地址转换为完整的本地化数据对象，涵盖国家、时区、货币、语言、邮政编码格式、区域设置、欧盟状态及国际拨号代码等信息。其核心优势在于，通过一次API调用即可获取通常需要多个服务拼接才能得到的完整本地化数据集。

核心功能与用途

一键获取完整本地化数据：从任意IPv4地址返回包括国家、时区、货币、语言、邮政编码格式、实际当地时间等在内的完整信息。
解决传统IP地理定位的痛点：传统服务往往只提供经纬度和国家代码，而该API直接完成了时区、货币、语言、邮政编码验证和本地时间的整合，免去开发者自行关联多种数据的繁琐流程。

端点信息

请求方式：GET
请求URL：https://ip-localization.meow-dev.workers.dev/v1/localize
参数说明：
- ip（可选）：IPv4地址。如果省略，则自动使用CF-Connecting-IP头（即调用者的真实IP）。

响应数据示例（以IP 8.8.8.8为例）

响应为JSON格式，包含以下主要字段：

ip：查询的IP地址
country：国家信息（含ISO 3166-1 alpha-2代码、国家名称、国旗emoji）
timezone：时区信息（含时区ID、GMT偏移量、是否实行夏令时、当前当地时间）
language：语言信息（含语言代码、名称、本地名称）
currency：货币信息（含货币代码、符号、名称、小数位数）
postal_format：邮政编码格式的正则表达式
locale：区域设置（如eng_US）
is_eu：是否为欧盟国家（布尔值）
calling_code：国际电话区号（如+1）

关键字段说明

timezone.current_local_time：通过ICU/Intl计算的实际当地时间，自动处理夏令时调整。
timezone.observes_dst：是否实行夏令时。
language.native：该语言的本地写法（如"Deutsch"、"中文"）。
postal_format：用于邮政编码验证的正则表达式字符串，可用new RegExp(data.postal_format).test(input)进行验证。
calling_code：国际拨号前缀。

错误码说明

错误码	HTTP状态码	含义
`INVALID_IP`	400	IP地址格式错误
`PRIVATE_IP`	404	私有IP（RFC1918）、回环地址或保留地址
`IP_NOT_FOUND`	404	数据库中不存在该IP（极少发生）
`MISSING_IP`	400	未提供IP且缺少`CF-Connecting-IP`头