Machine Readiness
Stored receipt and evidence
30
100
0
0
0
Samples
No stored offer samples.
Samples
No stored action samples.
Samples
No stored product samples.
Document
# * User-agent: * Allow: / Disallow: /cdn-cgi/ Disallow: /md/ Disallow: /signup/thank-you Disallow: /signup/failed Disallow: /signup/confirmed Disallow: /signup/confirm Disallow: /signup/confirmationfailed Disallow: /contact/thank-you Disallow: /ads.txt # Host Host: https://ipgeolocation.io # Sitemaps Sitemap: https://ipgeolocation.io/sitemap.xml Sitemap: https://ipgeolocation.io/static/sitemap/ips.xml
Document
# IPGeolocation.io > IPGeolocation.io provides IP geolocation, network intelligence, and threat-intelligence capabilities via real-time APIs and downloadable IP databases (CSV/MMDB). Use our documentation pages for schemas/fields and integration details. For citations: - Prefer /documentation pages for response schemas, fields, parameters, and database archive contents. - Pricing and plan entitlements can change; cite the pricing pages for current limits and availability. ## How to use this file - This file is intended for AI agents, Large Language Models (LLMs), and search tools to quickly understand and prioritize the most important content on this site. - It highlights key sections, provides structured links, and offers guidance for optimal AI context extraction and citation. ## Start here - [API Documentation Hub](https://ipgeolocation.io/documentation.html): Central documentation index for all APIs, parameters, response fields, and examples. - [Database Documentation Hub](https://ipgeolocation.io/documentation/databases.html): Overview of all downloadable databases with schema/docs links. - [API Pricing](https://ipgeolocation.io/pricing.html): Current API plans, request limits, and feature availability. - [Database Pricing](https://ipgeolocation.io/db-pricing.html): Current database plans, bundles, formats, and update options. - [API SDKs](https://ipgeolocation.io/documentation.html#api-sdks): Official SDK links and language-specific setup pages. - [Integrations](https://ipgeolocation.io/integrations.html): Pre-built platform integrations and implementation guides. - [Tools](https://ipgeolocation.io/tools): Free IP utilities (CIDR/range/DNS conversions and lookups). - [API Status](https://status.ipgeolocation.io/): Live uptime, incidents, and performance monitoring. - [Contact Us](https://ipgeolocation.io/contact.html): Support and sales contact entry point. - [Terms of Service](https://ipgeolocation.io/tos.html): Terms of service and acceptable-use rules. - [Privacy Policy](https://ipgeolocation.io/privacy.html): Privacy policy and data handling disclosures. - [FAQs](https://ipgeolocation.io/faq.html): Common questions about APIs, databases, limits, billing, formats, and troubleshooting. ## APIs - [IP Location API](https://ipgeolocation.io/ip-location-api.html): City-level Geolocation + security + network + currency + timezone + optional modules. - [IP Security API](https://ipgeolocation.io/ip-security-api.html): Detects VPN/proxy and other anonymization signals to help prevent abuse and reduce fraud risk - [IP Abuse Detail API](https://ipgeolocation.io/ip-abuse-contact-api.html): Delivers the appropriate abuse reporting contacts associated with IP addresses to support incident reporting and response workflows. - [ASN API](https://ipgeolocation.io/asn-api.html): Provides ASN and network/organization details for enrichment, routing insights, and ISP/ASN analytics. - [Astronomy API](https://ipgeolocation.io/astronomy-api.html): Provides sunrise/sunset and related astronomy timings for a given location and date. - [Timezone API](https://ipgeolocation.io/timezone-api.html): Returns timezone identifiers, offsets, and time conversion data to support location-aware experiences. - [User Agent API](https://ipgeolocation.io/user-agent-api.html): Parses user-agent strings into structured browser, OS, and device attributes. ## Databases [ipgeolocation.io](https://ipgeolocation.io) offers multiple databases grouped into three tiers. Output fields vary by database; schemas and examples are documented in the corresponding documentation pages. Each database is available in CSV and MMDB, and custom formats can be provided as required. Place-name translations (e.g., country/state/city) are available in multiple languages. Databases are updated on a daily or weekly depending on the update plan selected. ### Standard Databases - [IP to Country Database](https://ipgeolocation.io/documentation/ip-country-database.html): Country-level IP geolocation with country metadata such as continent details, ISO codes, currency, and languages. - [IP to City Database](https://ipgeolocation.io/documentation/ip-geolocation-standard-database.html): City-level IP geolocation database. - [IP to ISP Database](https://ipgeolocation.io/geo-standard-databases.html): ISP information with country-level geolocation for an IP address. - [IP to City+ISP Database](https://ipgeolocation.io/geo-standard-databases.html): City-level geolocation combined with ISP information for an IP address. ### Security Databases - [IP Security Database](https://ipgeolocation.io/documentation/ip-security-database.html): Security and risk-related attributes for IP addresses (e.g., threat_score, is_proxy, proxy_provider, is_bot, is_cloud_provider, cloud_provider_name). - [IP Hosting Database](https://ipgeolocation.io/documentation/ip-hosting-database.html): Identifies hosting providers and infrastructure context when an IP is associated with a hosting company. - [IP Residential Proxy Database](https://ipgeolocation.io/residential-proxy-database.html): Residential proxy intelligence including provider attribution and the date the IP was observed by the crawler. - [IP City+Security Database](https://ipgeolocation.io/security-pro-databases.html): City-level geolocation combined with security-related attributes. - [IP City+ISP+Security Database](https://ipgeolocation.io/security-pro-databases.html): City-level geolocation, ISP information, and security-related attributes in a single database. ### Advanced Databases - [IP Geolocation Database](https://ipgeolocation.io/documentation/ip-geolocation-advance-database.html): Advanced city-level geolocation with additional granularity (e.g., accuracy_radius, confidence, dma_code, connection_type such as broadband/cable/leased line) compared to the standard IP-to-city database. - [IP ASN Details Lite Database](https://ipgeolocation.io/documentation/ip-asn-database-lite.html): Core ASN information for the network associated with an IP address. - [IP ASN Details Extended Database](https://ipgeolocation.io/documentation/ip-asn-database-extended.html): Expanded ASN dataset with more detailed ASN attributes. - [IP Company Details Database](https://ipgeolocation.io/documentation/ip-company-database.html): Company attribution for IP ranges (e.g., company_name, domain, type). - [IP Abuse Contacts Details Database](https://ipgeolocation.io/documentation/ip-abuse-contact-database.html): Abuse reporting contacts associated with IP addresses for operational and security workflows. - [IP Whois Database](https://ipgeolocation.io/documentation/ip-whois-database.html): Parsed and structured IP WHOIS records delivered in a clean, consistent format. - [ASN Whois Database](https://ipgeolocation.io/documentation/asn-whois-database.html): Parsed and structured ASN WHOIS records delivered in a clean, consistent format. - [IP Company+ASN Details Database](https://ipgeolocation.io/geo-advance-databases.html): Company attribution combined with core ASN details for the IP address. - [IP City+Company+ASN Details Database](https://ipgeolocation.io/geo-advance-databases.html): Advanced city-level geolocation combined with company attribution and ASN details. - [IP City+Company+ASN+Abuse Details Database](https://ipgeolocation.io/geo-advance-databases.html): Advanced city-level geolocation combined with company, ASN, and abuse contact details. - [IP City+Company+ASN+Security Database](https://ipgeolocation.io/geo-advance-databases.html): Advanced city-level geolocation combined with company, ASN, and security-related attributes. - [IP City+Company+ASN+Abuse+Security Database](https://ipgeolocation.io/geo-advance-databases.html): Advanced city-level geolocation combined with company, ASN, abuse contact, and security-related attributes. ## SDKs Official client libraries and SDK documentation for integrating IPGeolocation.io APIs in popular languages and runtimes. Use these pages for installation steps, authentication setup, and code examples. - [Java SDK](https://ipgeolocation.io/documentation/ip-geolocation-api-java-sdk.html) - [Python SDK](https://ipgeolocation.io/documentation/ip-geolocation-api-python-sdk.html) - [Go SDK](https://ipgeolocation.io/documentation/ip-geolocation-api-go-sdk.html) - [.NET (C#) SDK](https://ipgeolocation.io/documentation/ip-geolocation-api-c-sharp-dotnet-sdk.html) - [PHP SDK](https://ipgeolocation.io/documentation/ip-geolocation-api-php-sdk.html) - [Ruby SDK](https://ipgeolocation.io/documentation/ip-geolocation-api-ruby-sdk.html) - [TypeScript SDK](https://ipgeolocation.io/documentation/ip-geolocation-api-typescript-sdk.html) - [jQuery SDK](https://ipgeolocation.io/documentation/ip-geolocation-api-jquery-sdk.html) - [JavaScript SDK](https://ipgeolocation.io/documentation/ip-geolocation-api-javascript-sdk.html) - [JavaScript Client Side SDK](https://ipgeolocation.io/documentation/ip-geolocation-api-javascript-web-sdk.html) - [Astronomy JavaScript SDK](https://ipgeolocation.io/documentation/astronomy-api-sdk.html) ## Integrations Pre-built integrations and platform guides for using IPGeolocation.io data in common automation, ecommerce, CMS, SIEM/log-enrichment, and security workflows. - [WordPress](https://ipgeolocation.io/integrations/wordpress): Geo Redirects & Content Control plugin for country-based redirects, access control (allow/block by country), and location-based content rules/shortcodes;designed to avoid impacting admins and search bots. - [Shopify](https://ipgeolocation.io/integrations/shopify): Storefront recommendation + geo-redirect workflow for multi-region stores, with localized popup behavior and translation support for region/language-specific experiences. - [n8n](https://ipgeolocation.io/integrations/n8n): Official n8n node package and setup guide for building automated IP lookup workflows (geolocation, timezone, and security enrichment) inside n8n. - [Make](https://ipgeolocation.io/integrations/make): Make.com modules for geolocation (single/bulk), security checks, ASN, abuse contact, astronomy, timezone, and user-agent parsing;connection setup and module reference. - [Zapier](https://ipgeolocation.io/integrations/zapier): Zapier actions for enriching leads/events with IP intelligence (including bulk where supported) and enabling location-aware or risk-aware automations without code. - [Elasticsearch](https://ipgeolocation.io/integrations/elastic-search): Ingest processor plugin for enriching Elasticsearch documents with IP intelligence using IPGeolocation.io databases; designed for Kibana visualization and Logstash pipelines. ## Free IP Tools Browser-based utilities for working with IP addresses, CIDR notation, and DNS lookups. Use these pages for quick conversions, subnet calculations, and DNS resolution examples. - [IP To Integer](https://ipgeolocation.io/tools/ip-to-integer): Convert IPv4/IPv6 addresses to integer representations and back. - [CIDR To IPv4](https://ipgeolocation.io/tools/cidr-to-ipv4): IPv4 subnet calculator (mask, network/broadcast, usable range) from CIDR. - [CIDR To IPv6](https://ipgeolocation.io/tools/cidr-to-ipv6): IPv6 subnet calculator from CIDR/prefix notation. - [IP Range To CIDR](https://ipgeolocation.io/tools/ipv4-range-to-cidr): Convert start–end IP ranges into the minimal set of covering CIDR blocks. - [IPv4 to IPv6](https://ipgeolocation.io/tools/ipv4-to-ipv6): Convert IPv4 addresses to IPv6 mapped/equivalent representations. - [IP To Hostname](https://ipgeolocation.io/tools/ip-to-hostname): Reverse DNS (PTR) lookup to resolve hostnames from IP addresses. - [Hostname to IP](https://ipgeolocation.io/tools/hostname-to-ip): DNS forward lookup (A/AAAA) to resolve IP addresses from hostnames/domains. - [IP Converter](https://ipgeolocation.io/tools/ip-converter): Convert IPs between decimal/hex/octal and related formats. ## Explore (interactive pages) Interactive tools for demonstrations and quick lookups. Prefer /documentation pages for response schemas, field definitions, and parameters. - [What is my IP](https://ipgeolocation.io/what-is-my-ip/): Displays your public IP address and related basic context for quick verification and demos. - [Browse IP ranges](https://ipgeolocation.io/browse/ipv4): Explore IPv4 ranges/prefixes interactively (useful for examples and navigation, not for schema citations). - [Browse ASNs](https://ipgeolocation.io/browse/asn): Browse ASN records and associated network/organization context interactively. - [Browse ASNs by country](https://ipgeolocation.io/browse/asn/countries): Filter/browse ASNs grouped by country for quick exploration and examples. ## Trust, status, and social proof References for availability monitoring and third-party or customer validation. - [API Status](https://status.ipgeolocation.io/): Real-time service health, uptime history, and incident reporting. - [Wall of Love / Customer Stories](https://ipgeolocation.io/customers.html): Customer stories, quotes, and usage highlights for credibility and context. ## Support & Data corrections How to reach the team and report data issues. - [Contact us](https://ipgeolocation.io/contact.html): Primary support and sales contact channel for questions, issues, and requests. - [Submit IPGeo data corrections](https://ipgeolocation.io/corrections.html): Submit geolocation corrections and data-quality feedback (single or bulk, where supported). ## Company & legal Corporate information and legal/compliance references. - [About us](https://ipgeolocation.io/about-us.html): Company overview, mission, and background. - [Terms of Service](https://ipgeolocation.io/tos.html): Contractual terms governing API/database usage and acceptable use. - [Privacy Policy](https://ipgeolocation.io/privacy.html): Data collection, processing, and privacy disclosures. - [GDPR Compliance](https://ipgeolocation.io/gdpr.html): GDPR-related disclosures and user rights information. - [Subprocessors](https://ipgeolocation.io/subprocessors.html): List of subprocessors/service providers involved in delivering the service. - [Site map](https://ipgeolocation.io/site-navigation.html): Site-wide index for discovering key pages by category. ## Official profiles Official social and developer presence (useful for announcements, releases, and SDK sources). - [Facebook](https://www.facebook.com/ipgeolocationio):Official Facebook page for product updates, announcements, and community engagement. - [LinkedIn](https://www.linkedin.com/company/ipgeolocation-io): Company updates, product announcements, and hiring/news. - [GitHub](https://github.com/IPGeolocation): SDK repositories, examples, and developer resources. - [X/Twitter](https://x.com/ipgeolocationio): Short-form announcements and release notes. - [Bluesky](https://bsky.app/profile/ipgeolocation.bsky.social): Alternative social channel for announcements and updates.
Document
# IPGeolocation.io — LLM Reference (Full)
> This file is a consolidated, AI-oriented reference for IPGeolocation.io products, API endpoints, databases, SDKs, and support/policy pages.
Last updated: 2026-01-19
Primary domains:
- ipgeolocation.io (marketing + documentation)
- api.ipgeolocation.io (API base hostname)
- app.ipgeolocation.io (account dashboard)
======================================================================
1) QUICK PRODUCT MAP
======================================================================
APIs (v2):
- IP Geolocation API (geo + optional enrichments)
- IP Security API (VPN/proxy/Tor + threat intelligence)
- ASN API (ASN details: routes/peers/upstreams/downstreams/raw whois response)
- IP Abuse Contact API (abuse contact details)
- Timezone API (timezone lookup + time conversion)
- Astronomy API (sun/moon & twilight timings)
- User Agent API (UA parsing)
Databases (download):
- IP Geolocation DB
- IP Security DB
- IP Company DB
- IP to ASN DB
- IP Abuse Contact DB
- IP Whois DB
- ASN Whois DB
- IP Hosting DB
- Residential Proxy DB
SDKs:
- Language SDKs are published under the IPGeolocation GitHub organization and linked from the documentation hub.
======================================================================
2) AUTHENTICATION, TRANSPORT, AND RESPONSE SHAPING
======================================================================
Authentication:
- Use an API key (apiKey=...) for API calls.
- Some use cases can also be authorized by request origin (CORS/origin-based authorization), depending on plan/setup.
Transport:
- HTTPS endpoints on api.ipgeolocation.io.
Common output:
- JSON is the default. Some endpoints or features may support additional formats (see product docs).
Common response shaping patterns (varies by API):
- fields=... (select specific fields/paths; reduces payload)
- include=... (include optional objects such as network, location, time_zone, abuse, user_agent)
- excludes=... (exclude specific fields/paths)
======================================================================
3) API: IP GEOLOCATION API (v2)
======================================================================
Docs:
- https://ipgeolocation.io/ip-location-api.html
- https://ipgeolocation.io/documentation.html
Endpoints:
- GET https://api.ipgeolocation.io/v2/ipgeo?apiKey=API_KEY&ip=IP_OR_DOMAIN
- GET https://api.ipgeolocation.io/v2/ipgeo?apiKey=API_KEY (without ip: returns caller/client info)
- POST https://api.ipgeolocation.io/v2/ipgeo-bulk?apiKey=API_KEY (bulk lookup)
Key behaviors:
- ip can be IPv4/IPv6. Some examples also show passing a domain name.
- bulk endpoint accepts a JSON body like: {"ips":["1.1.1.1","1.2.3.4", ...]}
- fields can select nested paths such as:
- fields=location
- fields=location.country_name,network.asn.organization
- includes/excludes can be used to enrich or trim response payload.
- lang can localize response (plan-dependent; see docs).
Typical response shape (high level):
- ip
- location (country/state/city, lat/long, etc.)
- network (asn and/or company details depending on plan and includes)
- optional objects based on include/fields
======================================================================
4) API: IP SECURITY API (v2)
======================================================================
Docs:
- https://ipgeolocation.io/ip-security-api.html
Endpoint:
- GET https://api.ipgeolocation.io/v2/security?apiKey=API_KEY&ip=IP
Common enrichments:
- include=network (add ASN/company context)
- include=location (add geo fields)
- include=time_zone (add timezone object)
- include=country_metadata (add country metadata as documented)
- include=location,network (multiple)
Typical response shape (high level):
- ip
- security (VPN/proxy/Tor/threat-related signals)
- optional: location, network, time_zone, country_metadata
======================================================================
5) API: ASN API (v2)
======================================================================
Docs:
- https://ipgeolocation.io/asn-api.html
Endpoint:
- GET https://api.ipgeolocation.io/v2/asn?apiKey=API_KEY&asn=AS_NUMBER
Common enrichments via include=... (as documented):
- include=downstreams
- include=upstreams
- include=routes
- include=peers
- include=whois_response
Typical response shape (high level):
- asn object (organization, country, and optional arrays/fields from include=...)
Note:
- ASN details can also appear inside the IP Geolocation API responses under a network/asn object, depending on plan and fields/include usage.
======================================================================
6) API: IP ABUSE CONTACT API (v2)
======================================================================
Docs:
- https://ipgeolocation.io/ip-abuse-contact-api.html
Endpoint:
- GET https://api.ipgeolocation.io/v2/abuse?apiKey=API_KEY&ip=IP
Response shaping:
- excludes can remove specific abuse fields/paths (example docs show excluding abuse.handle, abuse.emails).
Also supported via IP Geolocation API enrichment:
- GET https://api.ipgeolocation.io/v2/ipgeo?apiKey=API_KEY&ip=IP&include=abuse
Typical response shape (high level):
- ip
- abuse contact details (structure depends on fields/excludes)
======================================================================
7) API: TIMEZONE API (v2)
======================================================================
Docs:
- https://ipgeolocation.io/timezone-api.html
Timezone lookup:
- GET https://api.ipgeolocation.io/v2/timezone?apiKey=API_KEY&ip=IP
- GET https://api.ipgeolocation.io/v2/timezone?apiKey=API_KEY&lat=...&long=...
- GET https://api.ipgeolocation.io/v2/timezone?apiKey=API_KEY&location=...
- GET https://api.ipgeolocation.io/v2/timezone?apiKey=API_KEY&tz=...
- GET https://api.ipgeolocation.io/v2/timezone?apiKey=API_KEY&lo_code=UNLOCODE
Time conversion:
- GET https://api.ipgeolocation.io/v2/timezone/convert?apiKey=API_KEY&location_from=...&location_to=...&time=...
- GET https://api.ipgeolocation.io/v2/timezone/convert?apiKey=API_KEY&iata_from=...&iata_to=...
Typical response shape (high level):
- timezone identifiers/names
- local date/time fields
- DST fields where applicable
- conversion output for convert endpoint
======================================================================
8) API: ASTRONOMY API (v2)
======================================================================
Docs:
- https://ipgeolocation.io/astronomy-api.html
Endpoint:
- GET https://api.ipgeolocation.io/v2/astronomy?apiKey=API_KEY&lat=...&long=...&date=YYYY-MM-DD
- GET https://api.ipgeolocation.io/v2/astronomy?apiKey=API_KEY&ip=...&date=YYYY-MM-DD
Notes:
- date must be YYYY-MM-DD; if omitted, current date is used (per docs examples).
Typical response shape (high level):
- sun timings (sunrise/sunset, twilight begin/end)
- moon timings (moonrise/moonset, phase)
- additional numeric fields (altitude/azimuth/distance, etc.) as documented
======================================================================
9) API: USER AGENT API (v2)
======================================================================
Docs:
- https://ipgeolocation.io/user-agent-api.html
Endpoint:
- GET https://api.ipgeolocation.io/v2/user-agent?apiKey=API_KEY
Provide the User-Agent string in the HTTP "User-Agent" header.
Also supported via IP Geolocation API enrichment:
- GET https://api.ipgeolocation.io/v2/ipgeo?apiKey=API_KEY&fields=location&include=user_agent
Provide the User-Agent string in the HTTP "User-Agent" header.
Typical response shape (high level):
- device/OS/browser/engine classification fields
- robot/hacker/anonymized indicators where applicable (as documented)
======================================================================
10) DATABASES (DOWNLOAD)
======================================================================
Docs hub:
- https://ipgeolocation.io/documentation/databases.html
Database pages:
- IP Geolocation Database: https://ipgeolocation.io/ip-geolocation-database.html
- IP Security Database: https://ipgeolocation.io/ip-security-database.html
- IP Company Database: https://ipgeolocation.io/ip-company-database.html
- IP to ASN Database: https://ipgeolocation.io/ip-asn-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
- IP Hosting Database: https://ipgeolocation.io/ip-hosting-database.html
- Residential Proxy Database: https://ipgeolocation.io/residential-proxy-database.html
Pricing:
- https://ipgeolocation.io/db-pricing.html
Formats:
- Database offerings commonly include CSV and MMDB options (see each database page for exact formats and field sets).
======================================================================
11) SDKS AND INTEGRATIONS
======================================================================
Documentation hub:
- https://ipgeolocation.io/documentation.html
Integrations:
- https://ipgeolocation.io/integrations.html
GitHub (SDK sources):
- https://github.com/IPGeolocation
======================================================================
12) 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