api-evangelist/ipgeolocation

# IPGeolocation.io (ipgeolocation) IPGeolocation.io 是一个多产品 IP 智能平台，提供 IP 定位、IP 安全/威胁情报、ASN 查询、滥用联系人、时区、天文学（日出、日落、月相、天体位置）和用户代理解析 API。所有端点都在 `https://api.ipgeolocation.io` 下提供，使用 API 密钥认证。免费计划每天提供 1,000 个积分；付费计划（从入门级到高级）从每月 150K 次请求到 5M 次请求不等，还有定制的企业级定价。 **URL:** [https://ipgeolocation.io/](https://ipgeolocation.io/) **运行：** [使用 Naftiko 的功能](https://github.com/naftiko/fleet?utm_source=api-evangelist&utm_medium=readme&utm_campaign=company-api-evangelist&utm_content=repo) ## 标签 Geocoding、IP 定位、IP 智能化、IP 安全、ASN 查询、滥用联系人、时区、天文学、用户代理、威胁情报、公共 API ## 时间戳 - **创建时间：** 2026-05-28 - **修改时间：** 2026-05-29 ## API ### IP 定位 将任何 IPv4 / IPv6 地址或域名解析为丰富的地理位置有效负载——国家、地区、城市、经纬度、邮政编码、货币、ASN、公司、时区、安全信号、滥用联系人和用户代理增强。包括单个查询（`GET /v3/ipgeo`）和批量查询（`POST /v3/ipgeo-bulk`，每个请求最多 50,000 个条目，付费计划）。 **人类 URL：** [https://ipgeolocation.io/ip-location-api.html](https://ipgeolocation.io/ip-location-api.html) #### 标签 - IP 定位、Geocoding、IP 智能化 #### 属性 - [文档](https://ipgeolocation.io/documentation/ip-geolocation-api.html) - [OpenAPI](openapi/ipgeolocation-ip-location-openapi.yml) - [PHP SDK](https://github.com/IPGeolocation/ip-geolocation-api-php) - [Python SDK](https://github.com/IPGeolocation/ip-geolocation-api-python-sdk) - [Java SDK](https://github.com/IPGeolocation/ip-geolocation-api-java-sdk) - [JavaScript SDK](https://github.com/IPGeolocation/ip-geolocation-api-javascript-sdk) - [TypeScript SDK](https://github.com/IPGeolocation/ip-geolocation-api-typescript-sdk) - [Node.js SDK](https://www.npmjs.com/package/ip-geolocation-api-javascript-sdk) - [Ruby SDK](https://github.com/IPGeolocation/ip-geolocation-ruby-sdk) - [Go SDK](https://github.com/IPGeolocation/ip-geolocation-go-sdk) - [.NET SDK](https://github.com/IPGeolocation/ip-geolocation-api-dotnet-sdk) - [Kotlin SDK](https://github.com/IPGeolocation/ip-geolocation-api-kotlin-sdk) - [Swift SDK](https://github.com/IPGeolocation/ip-geolocation-api-swift-sdk) - [Rust SDK](https://github.com/IPGeolocation/ip-geolocation-api-rust-sdk) - [C++ SDK](https://github.com/IPGeolocation/ip-geolocation-api-cpp-sdk) - [jQuery SDK](https://github.com/IPGeolocation/ip-geolocation-api-jquery-sdk) - [Naftiko 功能 - IP 定位](capabilities/ip-location-ip-geolocation.yaml) ### IP 安全 威胁情报 API，可检测 VPN、代理、Tor 出口节点、中继网络、机器人活动、垃圾邮件来源、住宅代理、云和数据中心 IP，并分配威胁分数。单个查询（`GET /v3/security`）和批量查询（`POST /v3/security-bulk`）。 **人类 URL：** [https://ipgeolocation.io/ip-security-api.html](https://ipgeolocation.io/ip-security-api.html) #### 标签 - IP 安全、威胁情报、VPN 检测、代理检测 #### 属性 - [文档](https://ipgeolocation.io/documentation/ip-security-api.html) - [OpenAPI](openapi/ipgeolocation-security-openapi.yml) - [Naftiko 功能 - IP 安全](capabilities/security-ip-security.yaml) ### ASN 查询 将 IP 或 ASN 解析为自治系统元数据——拥有组织、国家、类型（ISP、托管、教育、政府）、IP 范围、对等方和上下游关系。 **人类 URL：** [https://ipgeolocation.io/asn-api.html](https://ipgeolocation.io/asn-api.html) #### 标签 - ASN 查询、网络智能化 #### 属性 - [文档](https://ipgeolocation.io/documentation/asn-api.html) - [OpenAPI](openapi/ipgeolocation-asn-openapi.yml) - [Naftiko 功能 - ASN 查询](capabilities/asn-asn-lookup.yaml) ### IP 滥用联系人 任何 IPv4/IPv6 地址的注册来源滥用联系人信息——RIR、滥用电子邮件、网络/路由、国家以及注册元数据。对于安全运营、下架工作流程和合规性非常有用。 **人类 URL：** [https://ipgeolocation.io/abuse-contact-api.html](https://ipgeolocation.io/abuse-contact-api.html) #### 标签 - 滥用联系人、安全运营 #### 属性 - [文档](https://ipgeolocation.io/documentation/abuse-contact-api.html) - [OpenAPI](openapi/ipgeolocation-abuse-openapi.yml) - [Naftiko 功能 - IP 滥用联系人](capabilities/abuse-ip-abuse-contact.yaml) ### 时区 从名称（例如 `America/New_York`）、IP 地址或经纬度坐标解析时区。返回当前日期/时间、UTC 偏移量、DST 状态、DST 转换窗口、机场/locode 元数据以及一个转换端点，用于在两个时区之间转换时间戳。 **人类 URL：** [https://ipgeolocation.io/timezone-api.html](https://ipgeolocation.io/timezone-api.html) #### 标签 - 时区、日期和时间 #### 属性 - [文档](https://ipgeolocation.io/documentation/timezone-api.html) - [OpenAPI](openapi/ipgeolocation-timezone-openapi.yml) - [Naftiko 功能 - 时区](capabilities/timezone-timezone.yaml) ### 天文学 任何日期和位置的天文学数据——日出、日落、正午、民用/航海/天文黄昏阶段、月升、月落、月相、照明百分比以及太阳和月亮的仰角/方位角。包括 `/astronomy/timeSeries` 端点，用于日期范围。 **人类 URL：** [https://ipgeolocation.io/astronomy-api.html](https://ipgeolocation.io/astronomy-api.html) #### 标签 - 天文学、日出日落、月相 #### 属性 - [文档](https://ipgeolocation.io/documentation/astronomy-api.html) - [OpenAPI](openapi/ipgeolocation-astronomy-openapi.yml) - [Naftiko 功能 - 天文学](capabilities/astronomy-astronomy.yaml) ### 用户代理 将用户代理字符串解析为浏览器、引擎、设备和操作系统属性。支持单个（`GET /v3/user-agent`——基于头部的，或 `POST /v3/user-agent`——基于主体的）和批量查询（`POST /v3/user-agent-bulk`）。 **人类 URL：** [https://ipgeolocation.io/user-agent-api.html](https://ipgeolocation.io/user-agent-api.html) #### 标签 - 用户代理、设备检测、浏览器检测 #### 属性 - [文档](https://ipgeolocation.io/documentation/user-agent-api.html) - [OpenAPI](openapi/ipgeolocation-user-agent-openapi.yml) - [Naftiko 功能 - 用户代理](capabilities/user-agent-user-agent.yaml) ## 常见属性 - [网站](https://ipgeolocation.io/) - [文档](https://ipgeolocation.io/documentation) - [定价](https://ipgeolocation.io/pricing.html) - [注册](https://app.ipgeolocation.io/signup) - [仪表板](https://app.ipgeolocation.io/) - [GitHub 组织](https://github.com/IPGeolocation) - [组合 OpenAPI 规范](https://github.com/IPGeolocation/openapi) - [CLI](https://github.com/IPGeolocation/cli) - [MCP 服务器](https://github.com/IPGeolocation/ipgeolocation-io-mcp) - [Steampipe 插件](https://github.com/IPGeolocation/steampipe-plugin-ipgeolocation) - [Vercel Edge 中间件](https://github.com/IPGeolocation/vercel-middleware) - [n8n 节点](https://github.com/IPGeolocation/n8n-nodes-ipgeolocation) - [Google Sheets 扩展](https://github.com/IPGeolocation/google-sheets) - [Elasticsearch Ingest 处理器](https://github.com/IPGeolocation/es-ipgeo-ingest-processor) - [MMDB CLI (mmdbio)](https://github.com/IPGeolocation/mmdbio) - [数据库读取器](https://github.com/IPGeolocation/ipgeolocation-database-reader) - [Splunk 应用](https://github.com/IPGeolocation/splunk-docs) - [public-apis 列表](https://github.com/public-apis/public-apis) - [计划](plans/ipgeolocation-plans-pricing.yml) - [速率限制](rate-limits/ipgeolocation-rate-limits.yml) - [FinOps](finops/ipgeolocation-finops.yml) - [词汇表](vocabulary/ipgeolocation-vocabulary.yml) - [规则](rules/ipgeolocation-rules.yml) - [JSON-LD 上下文](json-ld/ipgeolocation-context.jsonld) ## 功能 | 名称 | 描述 | |------|-------------| | 7-产品 API 套件 | IP 定位、IP 安全、ASN 查询、滥用联系人、时区、天文学和用户代理解析——所有这些都由一个 API 密钥提供。 | | 批量端点 | 批量查询端点（每个请求最多 50,000 个条目）用于 IP 定位、IP 安全和用户代理解析，付费计划。 | | 14 个官方 SDK | PHP、Python、Java、JavaScript、TypeScript、Node、Ruby、Go、.NET、Kotlin、Swift、Rust、C++ 和 jQuery 的第一方 SDK。 | | MCP 服务器 | 官方模型上下文协议服务器，将每个产品（地理、安全、ASN、时区、天文学、用户代理）作为 MCP 工具暴露给 Claude、Cursor、Copilot 和其他 MCP 感知客户端。 | | Edge 和平台集成 | Vercel Edge 中间件、Cloudflare 友好客户端、Steampipe 插件、Elasticsearch Ingest 处理器、n8n 节点、Google Sheets 扩展、Splunk 应用、WordPress / Shopify / Pipedream / Zapier / Make 集成。 | | MMDB 数据库产品 | 可下载的 MMDB 数据库，用于离线地理位置、安全、ASN、公司、滥用联系人、WHOIS、托管和住宅代理查询（Geo Standard、Geo Advance、Security Pro 级别）。 | ## 用例 | 名称 | 描述 | |------|-------------| | 个性化并本地化 Web 体验 | 检测访客的国家、货币和时区，以在边缘定制语言、定价和内容。 | | 合规性和地理封锁 | 通过在 Vercel/CDN 边缘阻止或重定向来自特定国家或网络的流量来执行制裁、年龄门或许可规则。 | | 防欺诈和滥用 | 使用 VPN/代理/Tor 检测、威胁评分和 ASN 类型（托管与住宅）对注册、登录和交易进行评分。 | | SOC 分级和下架 | 在事件响应和滥用报告期间解决滥用联系人和 ASN 拥有者。 | | 安排和天文学 | 使用高精度日出/日落和月相数据为安排、照明自动化、农业和天文台工具提供动力。 | | 受众分析 | 使用国家、城市、ISP 和设备信息丰富日志和分析事件，以细分用户和仪表板。 | ## 集成 | 名称 | 描述 | |------|-------------| | Vercel Edge 中间件 | 在 Vercel 边缘进行地理封锁、重定向和检测 VPN/代理/Tor。 | | Splunk 应用 | 用 IP 智能化丰富 Splunk 事件。 | | Elasticsearch Ingest 处理器 | 丰富索引到 Elasticsearch 的文档。 | | Steampipe 插件 | 通过 SQL 查询 IP 智能化。 | | n8n 节点 | n8n 工作流程自动化的第一方节点。 | | Google Sheets 扩展 | 直接从电子表格中查找 IP。 | | Zapier | 在 IP 智能化丰富时触发工作流程。 | | Make (Integromat) | 将 IP 查询组合到 Make 场景中。 | | Pipedream | Pipedream 自动化的源步骤。 | | WordPress 插件 | 个性化并保护 WordPress 网站。 | | Shopify 应用 | 地理路由 Shopify 客户并执行区域规则。 | | Microsoft Copilot 连接器 | 在 Microsoft Copilot 中显示 IP 智能化。 | | Maltego 转换 | 在 Maltego 调查中从 IP 转换到 ASN、地理和安全。 | ## 解决方案 | 名称 | 描述 | |------|-------------| | 实时 API 查询 | 通过 HTTPS 在 50 毫秒内提供 IP 智能化，使用单个 API 密钥。 | | 可下载的 MMDB 数据库 | 可离线使用的 MMDB 文件（Geo Standard、Geo Advance、Security Pro 级别），用于嵌入式或断开连接的使用场景。 | | Edge 和平台集成 | 用于个性化和地理封锁的 Vercel、Cloudflare Workers 和其他边缘运行时的内置中间件，无需额外跳转。 | ## 艺术品 按格式组织可机器读取的 API 规范。 ### OpenAPI - [IPGeolocation.io：滥用联系人 API](openapi/ipgeolocation-abuse-openapi.yml) - [IPGeolocation.io：ASN 查询 API](openapi/ipgeolocation-asn-openapi.yml) - [IPGeolocation.io：天文学 API](openapi/ipgeolocation-astronomy-openapi.yml) - [IPGeolocation.io：IPGeolocation API](openapi/ipgeolocation-ip-location-openapi.yml) - [IPGeolocation.io：IP 安全 API](openapi/ipgeolocation-security-openapi.yml) - [IPGeolocation.io：日期、时间和时区 API](openapi/ipgeolocation-timezone-openapi.yml) - [IPGeolocation.io：用户代理 API](openapi/ipgeolocation-user-agent-openapi.yml) ### JSON Schema 从七个 OpenAPI 规范中提取的 47 个模式。请参阅 [json-schema/](json-schema/）。 ### JSON 结构 从 JSON 模式生成的 47 个 JSON 结构（json-structure.org）文件。请参阅 [json-structure/](json-structure/）。 ### JSON-LD 八个 JSON-LD 1.1 上下文文档——每个 API 一个，还有一个主组合上下文——在 [json-ld/](json-ld/）： - [ipgeolocation-context.jsonld](json-ld/ipgeolocation-context.jsonld) — 组合主上下文 - [ipgeolocation-ip-location-context.jsonld](json-ld/ipgeolocation-ip-location-context.jsonld) - [ipgeolocation-security-context.jsonld](json-ld/ipgeolocation-security-context.jsonld) - [ipgeolocation-asn-context.jsonld](json-ld/ipgeolocation-asn-context.jsonld) - [ipolocation-abuse-context.jsonld](json-ld/ipgeolocation-abuse-context.jsonld) - [ipgeolocation-timezone-context.jsonld](json-ld/ipgeolocation-timezone-context.jsonld) - [ipgeolocation-astronomy-context.jsonld](json-ld/ipgeolocation-astronomy-context.jsonld) - [ipgeolocation-user-agent-context.jsonld](json-ld/ipgeolocation-user-agent-context.jsonld) ### 示例 从每个模式生成的 47 个 JSON 示例有效负载——每个模式一个——在 [examples/](examples/）。 ## 功能 Naftiko 功能按自包含、平面文件业务界面组织。每个文件内联其自己的 `consumes` 块以及一个 REST 暴露器和 MCP 暴露器。 | 功能 | API | 操作 | 文件 | |---|---|---|---| | IP 定位 | IP 定位 | 2 | [capabilities/ip-location-ip-geolocation.yaml](capabilities/ip-location-ip-geolocation.yaml) | | IP 安全 | IP 安全 | 2 | [capabilities/security-ip-security.yaml](capabilities/security-ip-security.yaml) | | ASN 查询 | ASN 查询 | 1 | [capabilities/asn-asn-lookup.yaml](capabilities/asn-asn-lookup.yaml) | | IP 滥用联系人 | IP 滥用联系人 | 1 | [capabilities/abuse-ip-abuse-contact.yaml](capabilities/abuse-ip-abuse-contact.yaml) | | 时区 | 时区 | 2 | [capabilities/timezone-timezone.yaml](capabilities/timezone-timezone.yaml) | | 天文学 | 天文学 | 2 | [capabilities/astronomy-astronomy.yaml](capabilities/astronomy-astronomy.yaml) | | 用户代理 | 用户代理 | 3 | [capabilities/user-agent-user-agent.yaml](capabilities/user-agent-user-agent.yaml) | ## 词汇表 - [IPGeolocation.io 词汇表](vocabulary/ipgeolocation-vocabulary.yml) — 统一分类法映射 7 个资源、7 个操作、7 个工作流程和 6 个角色，跨越操作（OpenAPI）和功能（Naftiko）维度。 ## 计划、速率限制和 FinOps - [计划和定价](plans/ipgeolocation-plans-pricing.yml) — 10 个计划（免费 + Starter/Plus/Pro/Business/Premium/Enterprise + 三个 MMDB 数据库级别）使用 API Commons 计划 0.1 模型。 - [速率限制](rate-limits/ipgeolocation-rate-limits.yml) — 免费 1,000/天硬上限；付费计划没有每秒/分钟/小时/天的上限（只有每月积分配额）。 - [FinOps](finops/ipgeolocation-finops.yml) — FOCUS 1.3 对齐的计费模型：分层月度订阅 + 每块超额计费表，加上定制的 MMDB 许可证报价。 ## 规则 - [IPGeolocation Spectral 规则](rules/ipgeolocation-rules.yml) — 13 个类别中的 38 个有见地的规则强制执行 IPGeolocation.io API 约定（HTTPS-only、v3-prefixed 路径、apiKey 查询认证、camelCase 操作Ids、snake/camel 模式属性、bulk-must-be-POST 等）。

标签：API服务, API认证, ASN查询, CMS安全, IP地址解析, IP安全, IP定位, IP智能, JavaScript, OpenVAS, PHP, Python, SYN扫描, 公共API, 公司信息, 可视化界面, 国家, 地区, 地理位置编码, 地理信息, 城市, 域名解析, 天体位置, 天文, 天文API, 天文API服务, 天文API认证, 天文位置, 天文信息, 天文数据, 天文数据API, 天文数据API服务, 天文数据API认证, 天文数据Java, 天文数据JavaScript, 天文数据PHP, 天文数据Python, 天文数据SDK, 天文数据服务, 天文数据查询, 天文数据解析, 天文时区, 天文服务, 天文查询, 威胁情报, 安全信号, 开发者工具, 无后门, 日出日落, 日志审计, 时区, 月相, 滥用联系人, 用户代理解析, 经纬度, 请求拦截, 货币信息, 逆向工具, 邮政编码