# IPGeolocation.io — LLM Reference (Full) > This file is a consolidated, AI-oriented reference for IPGeolocation.io products, API endpoints, credits, plans, databases, SDKs, guides, and support/policy pages. The short index is at https://ipgeolocation.io/llms.txt. Last updated: 2026-10-07 Primary domains: - ipgeolocation.io (marketing + documentation + guides) - api.ipgeolocation.io (API base hostname; current API version is v3) - app.ipgeolocation.io (account dashboard, sign-up, API keys) For citations: - Prefer /documentation pages for response schemas, fields, parameters, and database archive contents. - Prefer /guides pages for concept explanations. - Plan quotas and prices below are accurate as of the date above; cite https://ipgeolocation.io/pricing.html for current values. ====================================================================== 1) KEY FACTS ====================================================================== Accuracy (measured across the ipgeolocation.io dataset; identical on every plan, including Free): - Country level: 99%+ - State/region level: 90%+ - City/locality level: 85%+ (best read as accuracy within a radius, not an exact point) - Accuracy is lower on mobile networks than on wired/fixed broadband networks. - IP geolocation is not reliable at postal-code or street level. - Paid plans can return a per-result accuracy_radius and confidence value (include=geo_accuracy). - Sources: https://ipgeolocation.io/faq.html https://ipgeolocation.io/guides/what-is-ip-geolocation-how-it-works https://ipgeolocation.io/blog/how-ip-geolocation-data-is-built How the data is built: - Layers: registry (RIR) data, operator geofeeds (RFC 8805), active network measurement, and partner ISP data, combined and verified. - Data is updated daily. Free plan (named "Developer" in plan tables): - 1,000 credits per day, for life. No credit card required. - For: evaluation, testing, and prototypes. For more volume and features, upgrade to a paid plan. - Included: IP Geolocation API default response (core geolocation, time zone, currency, country metadata, basic ASN); standalone Time Zone API, User Agent API, and Astronomy API. - Not included: IP Security API, ASN API, IP Abuse Contact API, Real-Time VPN and Proxy Detection, company data, extended ASN, include modules in the unified response (security, abuse, user_agent, geo_accuracy, dma_code, hostname), bulk endpoints, POST user-agent parsing, Request Origin (CORS) authentication, domain lookups, and non-English responses. - On the free plan, include=* returns the same default response as a request without include. - Requesting a non-English lang value with a free key returns HTTP 401. Rate limits: - No per-second or per-minute rate limits on any plan. - HTTP 429 is returned only when quota is exhausted: on Free, after 1,000 credits in a day; on paid plans, after the plan quota (and any enabled surcharge allowance) is used. Reliability: - 99.99% SLA (see https://ipgeolocation.io/tos.html). Live status: https://status.ipgeolocation.io/ - All endpoints are HTTPS, including on the free plan. ====================================================================== 2) PRODUCT MAP (names as used on ipgeolocation.io) ====================================================================== APIs (v3): - IP Geolocation API https://ipgeolocation.io/ip-location-api.html - IP Security API https://ipgeolocation.io/ip-security-api.html - Real-Time Proxy & VPN Detection https://ipgeolocation.io/real-time-proxy-and-vpn-detection.html - ASN API https://ipgeolocation.io/asn-api.html - IP Abuse Contact API https://ipgeolocation.io/ip-abuse-contact-api.html - Time Zone API https://ipgeolocation.io/timezone-api.html - Astronomy API https://ipgeolocation.io/astronomy-api.html - User Agent API https://ipgeolocation.io/user-agent-api.html Databases (download): - IP Geolocation Database https://ipgeolocation.io/ip-geolocation-database.html - IP Security Database https://ipgeolocation.io/ip-security-database.html - IP to ASN Database https://ipgeolocation.io/ip-asn-database.html - IP to Company Database https://ipgeolocation.io/ip-company-database.html - IP Abuse Contact Database https://ipgeolocation.io/ip-abuse-contact-database.html - IP WHOIS Database https://ipgeolocation.io/ip-whois-database.html - ASN WHOIS Database https://ipgeolocation.io/asn-whois-database.html - Residential Proxy Database https://ipgeolocation.io/residential-proxy-database.html - IP to Hosting Database https://ipgeolocation.io/ip-hosting-database.html Database bundles: - Geo Standard Databases https://ipgeolocation.io/geo-standard-databases.html - Security Pro Databases https://ipgeolocation.io/security-pro-databases.html - Geo Advance Databases https://ipgeolocation.io/geo-advance-databases.html Developer tools: - IPGeolocation.io MCP Server https://ipgeolocation.io/integrations/ipgeolocation-io-mcp - IPGeolocation CLI https://ipgeolocation.io/cli/ipgeolocation - MMDBio CLI https://ipgeolocation.io/cli/mmdbio ====================================================================== 3) PLANS AND CREDITS ====================================================================== API plans (as of 2026-10-06; see https://ipgeolocation.io/pricing.html): Plan Billing Price Credits Surcharge credits Developer Free $0 1,000 / day none (hard cap) Starter Monthly $19 150K / month 25K per $5 Starter Yearly $190 1.8M / year 25K per $5 Plus Monthly $49 500K / month 40K per $5 Plus Yearly $490 6M / year 40K per $5 Pro Monthly $79 1M / month 50K per $5 Pro Yearly $790 12M / year 50K per $5 Business Monthly $129 2M / month 65K per $5 Business Yearly $1,290 24M / year 65K per $5 Premium Monthly $249 5M / month 85K per $5 Premium Yearly $2,490 60M / year 85K per $5 Enterprise Custom Custom Custom Custom - All paid tiers include the same features; they differ by included credits and overage pricing. - Credits reset each billing period and do not roll over. - Overage (surcharge) is billed when the quota is exceeded and surcharge is enabled. Credit costs (per successful lookup; see https://ipgeolocation.io/documentation/credits-usage.html): - /v3/ipgeo default response .......................................... 1 - /v3/ipgeo + include=dma_code,geo_accuracy,hostname,user_agent ........ 1 - /v3/ipgeo + include=abuse ............................................ 2 - /v3/ipgeo + include=security ......................................... 3 - /v3/ipgeo + include=security,abuse (or include=*) .................... 4 - /v3/ipgeo-bulk ............................. same rules, per valid IP - /v3/security, /v3/security-bulk ...................................... 2 - /v3/abuse ............................................................ 1 - /v3/asn .............................................................. 1 - /v3/timezone, /v3/timezone/convert ................................... 1 - /v3/user-agent, /v3/user-agent-bulk ...................... 1 per user agent - /v3/astronomy ........................................................ 1 - Real-Time VPN and Proxy Detection .................................... 3 (+2 with include=security; +1 for location/asn/company; 6 with include=all) - The X-Credits-Charged response header reports credits charged per request. ====================================================================== 4) AUTHENTICATION, TRANSPORT, AND RESPONSE SHAPING ====================================================================== Docs: - https://ipgeolocation.io/documentation/api-authentication.html - https://ipgeolocation.io/documentation/api-response-formats.html Authentication: - API key: pass apiKey=API_KEY as a query parameter. - Request Origin (CORS, paid plans only): register allowed origins in the dashboard to call the API from browsers without exposing a key. See https://ipgeolocation.io/tutorials/secure-api-key-before-production Transport: - HTTPS on https://api.ipgeolocation.io/v3/ Output formats: - JSON (default). XML via output=xml. Response shaping (most endpoints): - fields=... return only these fields/paths (e.g. fields=location.country_name,asn.organization) - excludes=... remove fields/paths (e.g. excludes=location.continent_code,currency) - include=... add optional modules (IP Geolocation API: security, abuse, user_agent, geo_accuracy, dma_code, hostname, liveHostname, or * for all) - lang=... localized place names (paid plans; e.g. lang=cn) Utility: - GET https://api.ipgeolocation.io/v3/getip returns the caller's public IP (output=text or output=xml also supported) ====================================================================== 5) API: IP GEOLOCATION API (v3) ====================================================================== Docs: - https://ipgeolocation.io/documentation/ip-location-api.html Endpoints: - GET https://api.ipgeolocation.io/v3/ipgeo?apiKey=API_KEY&ip=IP_OR_DOMAIN - GET https://api.ipgeolocation.io/v3/ipgeo?apiKey=API_KEY (no ip: looks up the caller's IP) - POST https://api.ipgeolocation.io/v3/ipgeo-bulk?apiKey=API_KEY (paid; up to 50,000 IPs) Body: {"ips":["1.1.1.1","2.56.188.34", ...]} Key behaviors: - ip accepts IPv4, IPv6, or a domain name (domain lookup on paid plans). - Free response: location, country metadata, currency, time zone, basic ASN. - Paid response adds: company, extended ASN, and optional include modules. - include=security adds the security object (same fields as the IP Security API). - include=abuse adds the abuse contact object. - include=user_agent parses the caller's User-Agent header. - include=geo_accuracy adds accuracy_radius and confidence. Typical response shape (high level): - ip - location (continent, country, state/province, district, city, zipcode, latitude, longitude, ...) - country_metadata, currency, time_zone - asn, company (paid) - security, abuse, user_agent (when included) ====================================================================== 6) API: IP SECURITY API (v3) ====================================================================== Docs: - https://ipgeolocation.io/documentation/ip-security-api.html Endpoints (paid): - GET https://api.ipgeolocation.io/v3/security?apiKey=API_KEY&ip=IP - POST https://api.ipgeolocation.io/v3/security-bulk?apiKey=API_KEY Body: {"ips":["145.223.7.7","2.56.188.35"]} - Also available inside the unified response: /v3/ipgeo?...&include=security Security signals include: - threat_score - is_tor, is_proxy, proxy_provider_names, proxy_confidence_score, proxy_last_seen - is_residential_proxy - is_vpn, vpn_provider_names, vpn_confidence_score, vpn_last_seen - is_relay, relay_provider_name - is_anonymous, is_known_attacker, is_bot, is_spam - is_cloud_provider, cloud_provider_name ====================================================================== 7) REAL-TIME PROXY & VPN DETECTION ====================================================================== Docs: - https://ipgeolocation.io/documentation/real-time-proxy-and-vpn-detection.html Product page / live demo: - https://ipgeolocation.io/real-time-proxy-and-vpn-detection.html How it works: - A client-side JavaScript (like a CAPTCHA widget) that runs live network tests in the visitor's browser, instead of a server-side IP lookup against a static list. - Catches new VPN exits, proxies, and residential proxies at the moment a user acts (login, checkout). - No API key in the page; requests are authorized by Request Origin. Paid plans only (free trial on request). - A verdict takes a few seconds: start monitoring early and read the result at the decision point. Quick start: Response includes: - public_ip, public_ip_country_code - live_vpn_proxy_detection: is_anonymous, confidence_score, proxy_score, vpn_score - visitor_actual_location ====================================================================== 8) API: ASN API (v3) ====================================================================== Docs: - https://ipgeolocation.io/documentation/asn-api.html Endpoints (paid): - GET https://api.ipgeolocation.io/v3/asn?apiKey=API_KEY&asn=AS_NUMBER - GET https://api.ipgeolocation.io/v3/asn?apiKey=API_KEY&ip=IP Optional data via include=...: - peers, upstreams, downstreams, routes, whois_response Note: - Basic ASN data also appears in IP Geolocation API responses (free); extended ASN on paid plans. ====================================================================== 9) API: IP ABUSE CONTACT API (v3) ====================================================================== Docs: - https://ipgeolocation.io/documentation/ip-abuse-contact-api.html Endpoints (paid): - GET https://api.ipgeolocation.io/v3/abuse?apiKey=API_KEY&ip=IP - Also via unified response: /v3/ipgeo?...&include=abuse Response includes: - abuse contact: route, country, name, organization, kind, address, emails, phone_numbers ====================================================================== 10) API: TIME ZONE API (v3) ====================================================================== Docs: - https://ipgeolocation.io/documentation/timezone-api.html Time zone lookup (free and paid): - GET https://api.ipgeolocation.io/v3/timezone?apiKey=API_KEY&ip=IP - GET https://api.ipgeolocation.io/v3/timezone?apiKey=API_KEY&lat=40.7128&long=-74.0060 - GET https://api.ipgeolocation.io/v3/timezone?apiKey=API_KEY&location=London,UK - GET https://api.ipgeolocation.io/v3/timezone?apiKey=API_KEY&tz=Australia/Lord_Howe - GET https://api.ipgeolocation.io/v3/timezone?apiKey=API_KEY&iata_code=LHR - GET https://api.ipgeolocation.io/v3/timezone?apiKey=API_KEY&icao_code=KATL - GET https://api.ipgeolocation.io/v3/timezone?apiKey=API_KEY&lo_code=DEBER Time conversion: - GET https://api.ipgeolocation.io/v3/timezone/convert?apiKey=API_KEY&tz_from=...&tz_to=...&time=... - Also supports pairs: lat_from/long_from + lat_to/long_to, location_from/location_to, iata_from/iata_to, icao_from/icao_to, locode_from/locode_to Typical response shape: - time zone name, offset, DST offset, current local date/time, DST transition details - converted time for /convert ====================================================================== 11) API: ASTRONOMY API (v3) ====================================================================== Docs: - https://ipgeolocation.io/documentation/astronomy-api.html Endpoints (free and paid): - GET https://api.ipgeolocation.io/v3/astronomy?apiKey=API_KEY&lat=...&long=...&date=YYYY-MM-DD - GET https://api.ipgeolocation.io/v3/astronomy?apiKey=API_KEY&ip=... - GET https://api.ipgeolocation.io/v3/astronomy?apiKey=API_KEY&location=New York, US - GET https://api.ipgeolocation.io/v3/astronomy?apiKey=API_KEY&lat=...&long=...&elevation=10 - GET https://api.ipgeolocation.io/v3/astronomy?apiKey=API_KEY&time_zone=Europe/London - GET https://api.ipgeolocation.io/v3/astronomy/timeSeries?apiKey=API_KEY&lat=...&long=...&dateStart=YYYY-MM-DD&dateEnd=YYYY-MM-DD Notes: - If date is omitted, the current date is used. No attribution required on any plan. Response includes: - sunrise, sunset, solar noon, day length, civil/nautical/astronomical twilight, golden hour, blue hour - moonrise, moonset, moon phase, illumination - sun and moon altitude, azimuth, and distance ====================================================================== 12) API: USER AGENT API (v3) ====================================================================== Docs: - https://ipgeolocation.io/documentation/user-agent-api.html Endpoints: - GET https://api.ipgeolocation.io/v3/user-agent?apiKey=API_KEY (parses the User-Agent request header) - POST https://api.ipgeolocation.io/v3/user-agent?apiKey=API_KEY (paid; body {"uaString":"..."}) - POST https://api.ipgeolocation.io/v3/user-agent-bulk?apiKey=API_KEY (paid) Body: {"uaStrings":["Mozilla/5.0 ...", ...]} - Also via unified response (paid): /v3/ipgeo?...&include=user_agent Response includes: - device, operating system, browser/agent, layout engine classification ====================================================================== 13) DATABASES (DOWNLOAD) ====================================================================== Docs hub: - https://ipgeolocation.io/documentation/databases.html Pricing: - https://ipgeolocation.io/db-pricing.html Formats and updates: - CSV and MMDB for every database except IP WHOIS and ASN WHOIS, which ship as Gzip-compressed newline-delimited JSON (one record per line, organization and contacts embedded); custom formats on request. - Updated daily or weekly depending on update plan. - Place-name translations in multiple languages. - Also available on Snowflake Marketplace: https://ipgeolocation.io/integrations/snowflake Geo Standard Databases (https://ipgeolocation.io/geo-standard-databases.html): - IP to Country Database https://ipgeolocation.io/documentation/ip-country-database.html - IP to City Database https://ipgeolocation.io/documentation/ip-geolocation-standard-database.html - IP to ISP Database, IP to City+ISP Database Security Pro Databases (https://ipgeolocation.io/security-pro-databases.html): - IP Security Database https://ipgeolocation.io/documentation/ip-security-database.html - IP to Hosting Database https://ipgeolocation.io/documentation/ip-hosting-database.html - Residential Proxy Database https://ipgeolocation.io/documentation/residential-proxy-database.html - IP City+Security Database, IP City+ISP+Security Database Geo Advance Databases (https://ipgeolocation.io/geo-advance-databases.html): - IP Geolocation Database (Advance) https://ipgeolocation.io/documentation/ip-geolocation-advance-database.html - IP to ASN Database https://ipgeolocation.io/documentation/ip-asn-database-lite.html - IP to ASN (Deep) Database https://ipgeolocation.io/documentation/ip-asn-database-extended.html - IP to Company Database https://ipgeolocation.io/documentation/ip-company-database.html - IP Abuse Contact Database https://ipgeolocation.io/documentation/ip-abuse-contact-database.html - IP WHOIS Database https://ipgeolocation.io/documentation/ip-whois-database.html - ASN WHOIS Database https://ipgeolocation.io/documentation/asn-whois-database.html - Combined: IP Company+ASN, IP City+Company+ASN, IP City+Company+ASN+Abuse, IP City+Company+ASN+Security, IP City+Company+ASN+Abuse+Security API vs database: - See https://ipgeolocation.io/guides/ip-geolocation-api-vs-database-guide ====================================================================== 14) GUIDES (2026) ====================================================================== Index: https://ipgeolocation.io/guides.html - What Is IP Geolocation? How It Works in 2026 https://ipgeolocation.io/guides/what-is-ip-geolocation-how-it-works How IP geolocation works, accuracy by level (99%+ country, 90%+ region, 85%+ city), what disrupts accuracy, use cases, API vs database. - What is an IP Address and How Does It Work? https://ipgeolocation.io/guides/what-is-an-ip-address-and-how-does-it-work IPv4 vs IPv6, address types, assignment chain, what an IP reveals. - What Is the Difference Between Unicast, Anycast, Multicast, and Broadcast? https://ipgeolocation.io/guides/unicast-anycast-multicast-and-broadcast-explained The four delivery methods and how anycast affects geolocation accuracy. - What Is an ASN? Autonomous System Numbers Guide https://ipgeolocation.io/guides/what-is-an-asn ASN types, BGP, examples, and ASN lookup for any IP. - What is an ISP and How is it Different From an ASN? https://ipgeolocation.io/guides/what-is-an-isp-and-how-is-it-different-from-an-asn - What Is a Regional Internet Registry, and What Does It Do? https://ipgeolocation.io/guides/what-is-a-regional-internet-registry The five RIRs (AFRINIC, APNIC, ARIN, LACNIC, RIPE NCC), IANA, LIRs, and WHOIS. - How to Get a Visitor's Real IP Address in Your Backend https://ipgeolocation.io/guides/get-real-client-ip-address X-Forwarded-For, X-Real-IP, CF-Connecting-IP, which to trust, avoiding spoofing. - What Is IP Enrichment and Why Logs Need It https://ipgeolocation.io/guides/what-is-ip-enrichment-and-why-logs-need-it Enriching logs with geolocation, ASN, company, and threat data; Python and Node.js code. - IP Geolocation: API vs Database Guide https://ipgeolocation.io/guides/ip-geolocation-api-vs-database-guide When to use an API or a downloadable database; MMDB vs CSV. - How to Geo-Block Visitors by Country in Your Application https://ipgeolocation.io/guides/how-to-geo-block-visitors-by-country-in-your-application JavaScript, Python, PHP; CDN vs WAF vs DNS vs application; VPN/proxy bypass. - How to Geo Redirect Visitors to Localized Pages using IP Location https://ipgeolocation.io/guides/how-to-geo-redirect-visitors-to-localized-pages JavaScript and PHP redirects with SEO guidance. - How to Set Up a Geofeed (RFC 8805 + RFC 9632 Guide) https://ipgeolocation.io/guides/how-to-set-up-a-geofeed - What Are Bogon IP Addresses? https://ipgeolocation.io/guides/what-are-bogon-ip-addresses Full IPv4 and IPv6 bogon lists, risks, filtering. - Bogon vs Martian Addresses: What's the Difference and How to Filter Them? https://ipgeolocation.io/guides/bogon-vs-martian-addresses ====================================================================== 15) BLOG AND TUTORIALS (selected) ====================================================================== Blog (index: https://ipgeolocation.io/blog.html): - IP Geolocation Data: Built, Not Guessed https://ipgeolocation.io/blog/how-ip-geolocation-data-is-built - Residential Proxy Detection: How It Works, Why It's Hard https://ipgeolocation.io/blog/how-residential-proxy-detection-works - What Is VPN Detection and How Does It Work? https://ipgeolocation.io/blog/what-is-vpn-detection-and-how-does-it-work - Your VPN Isn't Secret: How We Detect Risky & Hidden IPs https://ipgeolocation.io/blog/your-vpn-is-not-secret-how-we-detect-risky-hidden-ips - iCloud Private Relay vs Cloudflare WARP, Explained https://ipgeolocation.io/blog/icloud-private-relay-vs-cloudflare-warp-explained - What Are the Best VPN and Proxy Detection APIs in 2026? https://ipgeolocation.io/blog/what-are-the-best-vpn-and-proxy-detection-apis - Benefits of IP Geolocation: 8 Real Business Outcomes https://ipgeolocation.io/blog/benefits-of-ip-geolocation-8-real-business-outcomes Tutorials (index: https://ipgeolocation.io/tutorials.html): - Getting Started with IP Geolocation API https://ipgeolocation.io/tutorials/getting-started-with-ip-geolocation-api - IP Geolocation in Python https://ipgeolocation.io/tutorials/ip-geolocation-in-python - IP Geolocation in JavaScript (Node+Browser) https://ipgeolocation.io/tutorials/ip-geolocation-in-javascript - IP Geolocation in PHP https://ipgeolocation.io/tutorials/ip-geolocation-in-php - Secure Your API Key Before Production https://ipgeolocation.io/tutorials/secure-api-key-before-production - Add Geolocation to Your Shopify Store https://ipgeolocation.io/tutorials/add-geolocation-to-shopify - IP Geolocation in Google Tag Manager https://ipgeolocation.io/tutorials/ip-geolocation-in-google-tag-manager - WooCommerce Fraud Prevention (FraudShield) https://ipgeolocation.io/tutorials/woocommerce-fraud-prevention-setup-guide-for-fraudshield - How to Use the Astronomy API https://ipgeolocation.io/tutorials/how-to-use-the-ipgeolocation-io-astronomy-api ====================================================================== 16) SDKS, INTEGRATIONS, AND DEVELOPER TOOLS ====================================================================== SDKs (docs hub: https://ipgeolocation.io/documentation.html#api-sdks; sources: https://github.com/IPGeolocation): - Python, JavaScript (Node), TypeScript, JavaScript Client Side, Java, Kotlin, Go, .NET (C#), PHP, Ruby, Rust, Swift, C++, Astronomy JavaScript - Pages follow the pattern https://ipgeolocation.io/documentation/ip-geolocation-api--sdk.html Integrations (index: https://ipgeolocation.io/integrations.html): - WordPress https://ipgeolocation.io/integrations/wordpress - Shopify https://ipgeolocation.io/integrations/shopify - Google Sheets https://ipgeolocation.io/integrations/google-sheets - Splunk https://ipgeolocation.io/integrations/splunk - Maltego https://ipgeolocation.io/integrations/maltego - Snowflake https://ipgeolocation.io/integrations/snowflake - Steampipe https://ipgeolocation.io/integrations/steampipe - n8n https://ipgeolocation.io/integrations/n8n - Make https://ipgeolocation.io/integrations/make - Zapier https://ipgeolocation.io/integrations/zapier - Pipedream https://ipgeolocation.io/integrations/pipedream - viaSocket https://ipgeolocation.io/integrations/viasocket - Elasticsearch https://ipgeolocation.io/integrations/elastic-search Developer tools: - IPGeolocation.io MCP Server https://ipgeolocation.io/integrations/ipgeolocation-io-mcp - IPGeolocation CLI https://ipgeolocation.io/cli/ipgeolocation - MMDBio CLI https://ipgeolocation.io/cli/mmdbio ====================================================================== 17) SUPPORT, STATUS, AND POLICIES ====================================================================== Support: - FAQs: https://ipgeolocation.io/faq.html - Contact: https://ipgeolocation.io/contact.html - Data corrections: https://ipgeolocation.io/corrections.html - Status: https://status.ipgeolocation.io/ - Subprocessors: https://ipgeolocation.io/subprocessors.html Policies: - Privacy: https://ipgeolocation.io/privacy.html - GDPR: https://ipgeolocation.io/gdpr.html - Terms: https://ipgeolocation.io/tos.html Site map: - https://ipgeolocation.io/site-navigation.html