ipgeolocation.io API
✓ Official Vendor SpecMaps GeolocationGeocodingapiKey13 EndpointsREST
For Agents
Geolocate IP addresses, detect security threats (VPN, proxy, Tor), look up ASN and timezone data, and parse user-agent strings. Supports bulk lookups of up to 50,000 IPs per request.
Use for: I need to geolocate an IP address to its city and country, Check whether an IP address is a VPN or proxy, Find the timezone for a specific IP address, Get sunrise and sunset times for a given location and date
Not supported: Does not handle address-to-coordinate geocoding, route planning, or map rendering — use for IP-based geolocation, security detection, and astronomical data only.
Look up geolocation, security threat data, ASN details, timezone information, astronomy data, and user-agent metadata for any IPv4 or IPv6 address. The API supports single and bulk lookups (up to 50,000 IPs per request), timezone conversion between locations, astronomical event calculations for any date and coordinates, and browser/device detection from user-agent strings across 13 endpoints with multi-language responses.
Install Jentic One Beta
Connect the ipgeolocation.io API to your agent
Jentic One is a self-hosted execution layer for AI agents. It lets your agent call the ipgeolocation.io API, or any other public or private API you need. You set the rules, the agent never sees your credentials, and every call is logged.
Two steps, two machines. Install the instance in a safe environment, then register your agent from wherever it runs.
1
Step 1: Jentic One Host machine
# On the machine that will host your Jentic One instance:
curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | sh2
Step 2: Agent machine
# On the machine where your agent runs (keep this separate from the instance):
curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | sh
jentic register # connects your agent to your Jentic One instanceJentic One is in public beta. The setup above keeps your agent separate from the instance, which is what you want before using real credentials: an agent running as the same OS user as Jentic One can read its stored keys directly. Just evaluating? A single local install is fine to start. See the secure deployment guide for the tiers.
Capabilities
What an agent can do with ipgeolocation.io API.
Geolocate IPv4 and IPv6 addresses to country, city, coordinates, ISP, and currency in 12 languages
Detect VPNs, proxies, Tor exit nodes, and known attackers with threat confidence scores
Look up Autonomous System Number details including peers, routes, and upstream/downstream providers
Retrieve timezone and local time for any IP, coordinates, address, or IATA/ICAO airport code
Convert timestamps between timezones using location names, coordinates, or timezone identifiers
Calculate sunrise, sunset, moonrise, golden hour, and twilight phases for any location and date range
Parse user-agent strings into structured browser, device, and OS metadata
Use Cases
Patterns agents use ipgeolocation.io API for, with concrete tasks.
★ AI Agent IP Geolocation via Jentic
AI agents handling geo-targeted content delivery or access control can geolocate visitor IPs through Jentic. The agent passes an IP address and receives structured location data including country, city, coordinates, ISP, and local currency — enabling automated content localisation, pricing, and compliance checks.
Search Jentic for 'geolocate IP address', load the ipgeolocation.io /v3/ipgeo schema, and query with ip='8.8.8.8' to retrieve country, city, coordinates, and timezone
Fraud Detection and IP Security Screening
Payment processors, login systems, and anti-fraud platforms screen IP addresses for security threats before allowing transactions. The security endpoint returns VPN/proxy/Tor detection, threat scores, and known attacker flags — each lookup costs 2 credits and supports bulk analysis of up to 50,000 IPs for batch fraud reviews.
GET /v3/security with ip='198.51.100.23' to retrieve the threat_score, is_vpn, is_proxy, is_tor, and is_known_attacker flags
Timezone-Aware Scheduling and Communication
Scheduling applications and communication platforms determine the recipient's local time before sending notifications or booking meetings. The timezone endpoint accepts IPs, coordinates, addresses, or IATA codes and returns current local time, UTC offset, and DST status, while the conversion endpoint translates timestamps between any two timezones.
GET /v3/timezone with ip='203.0.113.50' to retrieve the timezone name, current local time, UTC offset, and DST status for scheduling
Astronomy and Solar Event Calculations
Weather apps, photography planning tools, and outdoor activity platforms calculate solar and lunar events for specific dates and locations. The astronomy endpoint returns sunrise, sunset, golden hour, twilight phases, moonrise, moonset, and moon illumination percentage, with time series support for date ranges up to 90 days.
GET /v3/astronomy with lat=40.7128, long=-74.0060, date='2026-06-21' to retrieve sunrise, sunset, golden hour, and moon phase for New York on the summer solstice
Key Endpoints
13 endpoints — look up geolocation, security threat data, asn details, timezone information, astronomy data, and user-agent metadata for any ipv4 or ipv6 address.
METHOD
PATH
DESCRIPTION
GET
/v3/ipgeo
Geolocate a single IP address or domain
POST
/v3/ipgeo-bulk
Bulk geolocate up to 50,000 IPs
GET
/v3/security
Detect security threats for an IP
GET
/v3/asn
Look up ASN details by AS number or IP
GET
/v3/timezone
Get timezone and local time for a location
GET
/v3/timezone/convert
Convert time between two timezones
GET
/v3/astronomy
Get sun/moon rise/set and astronomical data
GET
/v3/getip
Get the caller's IP address
GET
/v3/ipgeo
Geolocate a single IP address or domain
POST
/v3/ipgeo-bulk
Bulk geolocate up to 50,000 IPs
GET
/v3/security
Detect security threats for an IP
GET
/v3/asn
Look up ASN details by AS number or IP
GET
/v3/timezone
Get timezone and local time for a location
GET
/v3/timezone/convert
Convert time between two timezones
GET
/v3/astronomy
Get sun/moon rise/set and astronomical data
GET
/v3/getip
Get the caller's IP address
Why Jentic?
Three things that make agents converge on Jentic-routed access.
Credential isolation
ipgeolocation.io API keys are stored encrypted in the Jentic vault (MAXsystem). Agents receive scoped access — the apiKey query parameter is injected automatically and never exposed in the agent's context.
Intent-based discovery
Agents search by intent (e.g., 'geolocate an IP address' or 'detect VPN proxy') and Jentic returns matching ipgeolocation.io operations with their input schemas, so the agent can call the right endpoint without browsing docs.
Time to first call
Direct ipgeolocation.io integration: 1-3 days for auth, endpoint selection, and response parsing across 6 services. Through Jentic: under 30 minutes — search, load schema, execute.
Related APIs
Alternatives and complements available in the Jentic catalogue.
FAQs
Specific to using ipgeolocation.io API through Jentic.
What authentication does the ipgeolocation.io API use?
The API uses an API key passed as a query parameter named 'apiKey' on every request. The free plan allows 1,000 requests per day. Through Jentic, this key is stored encrypted in the credential vault and appended automatically — agents never handle the raw key.
Can I geolocate multiple IP addresses in one request?
Yes. The /v3/ipgeo-bulk endpoint accepts a POST request with an array of up to 50,000 IP addresses or domain names. Each IP in the array returns the same geolocation fields as the single-IP endpoint, making batch processing efficient.
What are the rate limits for the ipgeolocation.io API?
The free plan allows 1,000 requests per day with a 429 status returned when exceeded. Paid plans offer higher daily and per-second limits. Security lookups cost 2 credits per IP. Bulk endpoints count each IP in the array as a separate credit.
How do I detect whether an IP is a VPN or proxy through Jentic?
Install the SDK with pip install jentic and search for 'detect VPN proxy IP'. Jentic returns the ipgeolocation.io /v3/security operation schema. Pass the target IP and receive is_vpn, is_proxy, is_tor, threat_score, and confidence scores.
Can I get astronomy data for a range of dates?
Yes. The /v3/astronomy/timeSeries endpoint accepts dateStart and dateEnd parameters (maximum 90-day span) along with coordinates. It returns an array of astronomy objects — one per day — with sunrise, sunset, moonrise, moon phase, golden hour, and twilight data.
Does the timezone endpoint support conversion between two zones?
Yes. The /v3/timezone/convert endpoint accepts source and target locations (by timezone name, coordinates, or address) plus a timestamp. It returns the converted time, hour difference, and minute difference between the two zones.
GET STARTED