README.md

cool-ip-api

A package to get information from multiple IP APIs about the clients IP or another requested IP.

Installation

Requires python 3.10 and above.

pip install cool-ip-api

Usage

# Example with IPApiCom API
from cool_ip_api.provider.ip_api_com import IPAPICom

ip_api_com = IPAPICom()
ip_api_com.resolve() # Returns a pydantic model with the data from the API

Cli command

cool-ip-api
cool-ip-api 1.1.1.1

Supported APIs

Provider	Free plan available?	Rate limit	Check	IP Query
abstractapi.com	✅	20.000/month	api-key	✅
ip-api.com	✅	45/minute	ip	✅
ipwhois.io	✅	10.000/month	ip	✅
ipapi.co	✅	1.000/day	ip	✅
ipapi.com	✅	1.000/month	api-key	✅
ipify.org	✅	None	None	❌
ipinfo.io	✅	50.000/month	api-key	✅
myip.wtf	✅ (Donate)	1/minute	ip	❌

TODO

• Add more providers
  • geo.ipify.org
• Add bulk query support for providers that support it
• Add premium plan support for providers that support it
• Add more tests
  • Async tests
  • Rate limit tests
• Add more documentation