POST AI agent ready /v1/ip/bulk

批量 IP 地理定位 API - 免费批量查找

在单个请求中返回多个 IP 地址的地理位置数据。包括调用者自己的 IP 信息以及每个请求的 IP 的结果。

Endpoint

curl -X POST https://api.botoi.com/v1/ip/bulk \
  -H "Content-Type: application/json" \
  -d '{"ips":["8.8.8.8","1.1.1.1"]}'

When to use this API

收集一天的分析事件后，提取唯一的访问者 IP 并通过批量端点发送它们。在加载到数据仓库进行地理报告之前，将国家/地区和城市数据附加到每个事件行。

将服务器、CDN 节点和负载均衡器 IP 的列表馈送到此端点。在地图上绘制返回的坐标，以可视化您的基础设施足迹并确定覆盖范围内的地理差距。

一次请求可以发送多少个 IP？

每个请求最多可以发送 100 个 IP 地址。对于较大的数据集，将它们分成批次并发送多个请求。

响应中是否包含我自己的IP？

是的。除了 ips 数组中每个 IP 的结果之外，响应还包括 caller_ip 字段，其中包含您自己 IP 的地理位置。

阵列中的重复 IP 是否得到处理？

重复的 IP 独立解决。 ips 数组中的每个条目都会获得自己的结果对象，即使同一 IP 出现多次也是如此。

如果批次中有一个 IP 无效，会发生什么情况？

端点返回所有有效 IP 的结果，并包含任何无法解析的 IP 的错误消息。请求不会因为一项错误的条目而完全失败。

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