proxy-ip-check

Identify an IP's ASN owner, ISP, country and network type — residential, hosting/datacenter, proxy/VPN or mobile carrier.

Zero dependencies. No API key. Works from a single function call or the command line.

This is the Python port of the npm package proxy-ip-check (JS source: proxy-ip-check) — same behaviour, same data sources.

Install

pip install proxy-ip-check

Command line

$ proxy-ip-check 8.8.8.8

  IP           8.8.8.8
  ASN          AS15169
  AS name      GOOGLE
  ISP          Google LLC
  Location     United States, California, Mountain View
  Type         HOSTING / DATACENTER
  Source       ip-api.com

$ proxy-ip-check 114.114.114.114

  IP           114.114.114.114
  ASN          AS137702
  AS name      China Mobile
  ISP          China Mobile
  Location     China, Jiangsu, Nanjing
  Type         PROXY / VPN RANGE
  Source       ip-api.com

Multiple IPs and JSON output (for scripts, pipelines and LLM agents):

proxy-ip-check 8.8.8.8 1.1.1.1 --json

Python API

from proxy_ip_check import lookup, is_residential

r = lookup('8.8.8.8')
print(r['asn'])               # 'AS15169'
print(r['asName'])            # 'GOOGLE'
print(r['networkType'])       # 'hosting'
print(r['isResidentialLike']) # False

# Quick boolean check (True / False / None when undecidable)
if is_residential(ip) is False:
    print('this looks like a datacenter IP — risky for account operations')

Why ASN instead of "IP type databases"

Third-party IP-type databases guess. The ASN is a registration fact — an IP either belongs to a consumer broadband ISP or to a datacenter / cloud provider. Most anti-fraud systems evaluate this signal first, which is why it is the most reliable single indicator of whether an IP will be treated as a real household user.

Returned fields

Data sources & limits

1. ip-api.com (primary) — free tier, 45 requests/minute per IP. Exposes hosting, proxy and mobile flags.
2. ipinfo.io (fallback) — used automatically when the primary fails.

Please respect the free-tier rate limit. For bulk validation, add a throttle (e.g. one request per 1.5 s) and cache results.

Related resources

• Price comparison (20+ providers): https://socks5ip.com.cn/jiagezhongxin/
• Free IP quality checker (web): https://socks5ip.com.cn/ip-check-center/
• Dataset: proxy IP pricing in China (CSV/JSON): https://github.com/socks5ip/proxy-ip-pricing
• Source code (this Python package): https://github.com/socks5ip/proxy-ip-check-py
• npm version: https://www.npmjs.com/package/proxy-ip-check

License

MIT

Disclaimer

proxy-ip-check queries public IP-intelligence APIs and reports what they return. It is a diagnostic helper, not a guarantee: an IP labelled residential can still be blocked by a specific platform, and different risk engines weigh signals differently. Always verify against the platform you actually care about.