跳转到内容
POST AI agent ready /v1/ip/lookup

IP 地理定位 API - 免费 IP 地址查找

返回 IP 地址的地理位置数据，包括国家/地区、城市、地区、坐标、时区、ASN 和 Cloudflare 数据中心。 如果未提供 IP，则使用调用者自己的 IP。

Parameters

string

IPv4 or IPv6 address to geolocate. Omit to look up the caller's own IP.

Code examples

curl -X POST https://api.botoi.com/v1/ip/lookup \
  -H "Content-Type: application/json" \
  -d '{"ip":"203.0.113.1"}'

When to use this API

按访问者位置个性化内容

在页面加载时检测访问者所在的国家/地区和城市，以显示本地化的价格、语言或运输选项。 SaaS 结帐页面可以调用此端点以根据访问者的国家/地区代码预填充货币选择器。

支付渠道中的欺诈评分

将交易的 IP 地理位置与存档的账单地址进行比较。 标记 IP 解析到与发卡机构不同的国家/地区的订单，并通过手动审核路由标记的交易。

用于访问审核的合规性日志记录

将每个管理员登录的国家和地区记录到内部仪表板。 生成按地理位置分组的访问事件月度报告，以满足 SOC 2 或 GDPR 审核要求。

Frequently asked questions

IP 地理定位数据的准确度如何？
国家级准确率达到99%以上。 城市级准确度因地区而异，但主要 ISP 的准确度通常为 80-90%。 移动运营商 IP 和 VPN 可能会解析为运营商总部，而不是用户的物理位置。
该端点是否支持 IPv6 地址？
是的。 在 ip 字段中传递任何有效的 IPv6 地址。 响应包含与 IPv4 查找相同的地理位置字段。
如果我省略 ip 参数会发生什么？
端点返回呼叫者自己的 IP 地址的地理位置数据。 这对于在没有任何客户端 JavaScript 的情况下检测网站访问者的位置非常有用。
ASN 字段是什么？
ASN 代表自治系统编号。 它标识拥有 IP 地址块的网络运营商（例如 Comcast、AWS 或 Cloudflare）。 as_organization 字段为您提供人类可读的名称。
该端点有速率限制吗？
根据您的 IP，匿名请求每分钟限制为 5 个。 根据您的计划，使用 API 密钥进行身份验证的请求会获得更高的限制。

Get your API key

Free tier includes 5 requests per minute with no credit card required. Upgrade for higher limits.

Sign up free View full docs