# FindIP

> FindIP (findip.net) provides IP intelligence: geolocation, proxy, VPN, Tor, hosting/datacenter, residential-proxy and malicious-IP detection through a lookup API, and FindIP Shield, a visitor risk detection product for websites (browser SDK, Google Tag Manager, WordPress, WooCommerce, Shopify, and a no-code Cloudflare edge integration). Shield is free (Free Preview). Support: info@findip.net. Security reports: security@findip.net.

Product names to use: "FindIP" (company and lookup API) and "FindIP Shield" (website visitor risk product). The Cloudflare capability is described as the "FindIP Shield integration for Cloudflare Workers", not as a separate product name. FindIP is not affiliated with, endorsed by, or a partner of Cloudflare, Shopify, or WordPress.

## FindIP Shield

Every Shield documentation page is also served as Markdown: append `.md` to its URL (for example https://www.findip.net/docs/shield/quickstart.md), or request the HTML URL with `Accept: text/markdown`. All Shield docs in one file: https://www.findip.net/llms-full.txt. Coding agents adding Shield to a project should follow https://www.findip.net/docs/shield/agent-install.md.

- [Shield overview](https://www.findip.net/shield/overview): visitor risk intelligence for signup, login, lead and checkout flows; explainable VPN/proxy/Tor/hosting/malicious signals; three privacy modes; server-side verification.
- [Shield documentation index](https://www.findip.net/docs/shield)
- [Quickstart](https://www.findip.net/docs/shield/quickstart): npm, script tag, or Google Tag Manager install.
- [JavaScript SDK reference](https://www.findip.net/docs/shield/javascript-sdk)
- [Events and payloads](https://www.findip.net/docs/shield/events)
- [Identify users and add context](https://www.findip.net/docs/shield/identify-users): attach a hashed user ID and business context to events via the dataLayer or FindIP.track(); never raw emails or usernames.
- [In-page enforcement](https://www.findip.net/docs/shield/enforcement): per-site setting that makes the SDK stop, slow down, Turnstile-challenge or redirect risky sign-up, login, checkout and lead submits; friction for bots, with the verify endpoint as the server-side boundary.
- [Privacy modes](https://www.findip.net/docs/shield/privacy-modes)
- [Data collection](https://www.findip.net/docs/shield/data-collection): exactly what is sent; never passwords, payment fields, form values, raw emails or phones.
- [Cookies](https://www.findip.net/docs/shield/cookies)
- [Server verification](https://www.findip.net/docs/shield/server-verification)
- [Threat Network](https://www.findip.net/docs/shield/threat-network)
- [Free Preview terms](https://www.findip.net/docs/shield/terms-free-preview)

## FindIP Shield integration for Cloudflare Workers

- [Product page](https://www.findip.net/shield/cloudflare): no-code edge protection for a Cloudflare-proxied hostname. Authorize with Cloudflare OAuth (domain-verified publisher, four permissions), pick one hostname, and Shield deploys exactly one Worker and one route. Starts in Monitor mode (never blocks); Balanced mode (explicit opt-in) blocks only high-confidence bad traffic with a plain 403. Fails open: any FindIP failure forwards the request unchanged. The Worker sends only visitor IP, hostname, path and method. Free.
- [Documentation](https://www.findip.net/docs/shield/cloudflare): requirements, connect flow, modes, full policy reference (allow/block lists, verified bots, path rules, sensitivity, block categories, country block/allow-only, AI-crawler policy, custom access rules, IP-rotation defense), lifecycle (pause, resume, upgrade, rollback, remove, disconnect), failure matrix, permissions rationale, data inventory, troubleshooting, support.

## Shield integrations

- [Google Tag Manager](https://www.findip.net/docs/shield/google-tag-manager)
- [WordPress](https://www.findip.net/docs/shield/wordpress)
- [WooCommerce](https://www.findip.net/docs/shield/woocommerce)
- [Shopify product page](https://www.findip.net/shopify) and [Shopify documentation](https://www.findip.net/docs/shield/shopify)

## Lookup API

- [API response reference](https://www.findip.net/Docs/api-response)
- Client examples: [Python](https://www.findip.net/Docs/api-python), [JavaScript](https://www.findip.net/Docs/api-javascript), [C#](https://www.findip.net/Docs/api-csharp), [PHP](https://www.findip.net/Docs/api-php), [Go](https://www.findip.net/Docs/api-go), [Java](https://www.findip.net/Docs/api-java), [Ruby](https://www.findip.net/Docs/api-ruby), [Kotlin](https://www.findip.net/Docs/api-kotlin)
- Capability pages: [proxy detection](https://www.findip.net/proxy-detection-api), [VPN detection](https://www.findip.net/vpn-detection-api), [Tor detection](https://www.findip.net/tor-detection-api), [IP reputation](https://www.findip.net/ip-reputation-api), [datacenter IP detection](https://www.findip.net/datacenter-ip-detection), [IP geolocation](https://www.findip.net/ip-geolocation-api), [residential proxy detection](https://www.findip.net/residential-proxy-detection), [public DNS resolver detection](https://www.findip.net/public-dns-resolver-detection)

## Shield use cases

Problem-first pages: what goes wrong, what Shield shows, the install route that fits, and the boundaries of a risk score.

- [Detect fake signups](https://www.findip.net/detect-fake-signups)
- [Free trial abuse prevention](https://www.findip.net/free-trial-abuse-prevention)
- [VPN and proxy signup detection](https://www.findip.net/vpn-proxy-signup-detection)
- [Checkout fraud signals](https://www.findip.net/checkout-fraud-signals)
- [VPN, proxy and Tor detection for WordPress and WooCommerce](https://www.findip.net/wordpress-vpn-proxy-detection)
- [VPN, proxy and bot traffic on Shopify storefronts](https://www.findip.net/shopify-bot-vpn-detection)
- [Visitor risk signals in Google Tag Manager](https://www.findip.net/google-tag-manager-visitor-risk)
- [Bot and automated traffic detection by network](https://www.findip.net/bot-traffic-detection-website)
- [Paid traffic quality by campaign](https://www.findip.net/paid-traffic-quality)
- [Login abuse detection](https://www.findip.net/login-abuse-detection)

## Guides

- [Visitor risk scoring for signup and checkout](https://www.findip.net/Docs/visitor-risk-scoring-signup-checkout)
- [Understanding IP geolocation services](https://www.findip.net/Docs/understanding-ip-geolocation-services)
- [IPv4 and IPv6](https://www.findip.net/Docs/ipv4-and-ipv6)

## Company

- [Contact](https://www.findip.net/Home/Contact)
- [Privacy policy](https://www.findip.net/Docs/privacy-policy)
- [Terms of service](https://www.findip.net/Docs/terms)
- Open-source SDK: https://github.com/findip-net/findip-shield-js · npm: https://www.npmjs.com/package/@findip/shield