IPDataInfo/ipdata-python

# IPData.info Python SDK — 免费 IP 地理定位与威胁情报 API [](https://pypi.org/project/ipdatainfo/) [](../../actions/workflows/ci.yml) [](./LICENSE) [**ipdata.info**](https://ipdata.info) 的官方 Python 客户端 — 一个免费、 快速的 IP 地理定位、ASN 和威胁情报 API。查询任何 IPv4 或 IPv6 地址的国家、城市、 ASN、时区、货币和安全标志（代理/VPN/Tor/托管）。由 [ipdata.info](https://ipdata.info) 提供支持。 ## 获取免费 API key 公共端点**免费 — 50 次请求/分钟，无需注册，无需 key**。如需更高的 速率限制和批量查询，[**在 ipdata.info/register 创建免费 API key**](https://ipdata.info/register) 并在您的 [控制面板](https://ipdata.info/dashboard) 中进行管理。 ## 安装 ``` pip install ipdatainfo ``` ## 快速入门 ``` from ipdatainfo import Client # 免费版 — 无需 API key。如需更高限额 + 批量处理，请在 https://ipdata.info/register 获取免费 key # 并使用 Client(api_key="...")。 client = Client() info = client.lookup("8.8.8.8") print(info.city, info.country, info.asn_org) # Mountain View United States Google LLC ``` ## 方法 | 方法 | 返回内容 | |--------|-----------------| | `lookup(ip="")` | 完整的地理定位记录（如省略则查询自身 IP） | | `geo(ip)` | 地理信息子集（城市/地区/国家/纬度/经度/时区） | | `asn(ip)` | 某个 IP 的 ASN 及 ISP/注册机构 | | `batch(ips)` | 一次性查询多个 IP（**需要 API key**） | | `asn_detail(n)` | ASN 详情，包含前缀 | | `asn_whois_history(n)` | ASN whois 历史记录 | | `asn_changes()` | ASN 变更动态 | | `threat_domain/threat_hash/threat_url(x)` | 威胁情报查询（域名 / 文件哈希 / URL） | 完整响应 schema：[ipdata.info API 文档](https://ipdata.info/docs) · [SDK 契约](https://ipdata.info/docs/sdks)。 ## 配置 ``` from ipdatainfo import Client client = Client( api_key="KEY", # sent as X-Api-Key; switches to pro.ipdata.info base_url="https://ipdata.info", # override the host timeout=10.0, # seconds ) ``` 非 2xx 响应引发的错误将作为 `ipdatainfo.IpDataError` 抛出，并包含 `.status` 和 `.message`。 ## 速率限制 - 免费版 (`ipdata.info`)：50 次请求/分钟，无需 key。 - 付费版 (`pro.ipdata.info`)：更高限制 + `batch`，需配合 [API key](https://ipdata.info/register) 使用。 ## 其他 SDK 12 个官方 SDK — 完整列表请见 [**ipdata.info/docs/sdks**](https://ipdata.info/docs/sdks)：Python、Node.js、Go、 PHP、Java、Rust、.NET、Kotlin、Swift、Dart、Bash、Objective-C。 ## 许可证 MIT © [ipdata.info](https://ipdata.info)

标签：API客户端, ASN查询, IP地理定位, Python, 威胁情报, 开发者工具, 无后门, 逆向工具