ipapi - IP Geolocation API
Browse all Ipapi APIs✓ Official Vendor SpecData EnrichmentAddress ValidationapiKey3 EndpointsREST
For Agents
Resolve an IP address to country, city, time zone, currency, and connection details so an agent can enrich logs or personalise content by location.
Use for: I need to geolocate an IP address, Get the country and city for the requester IP, Look up the time zone and current local time for an IP, Retrieve the currency for the visitor's country
Not supported: Does not handle proxy or VPN detection, domain WHOIS, or threat intelligence — use for IP geolocation, currency, and time-zone lookups only.
ipapi is a hosted IP geolocation service that resolves IPv4 and IPv6 addresses to country, region, city, latitude and longitude, time zone, currency, and connection details. The API exposes three endpoints: a requester-IP lookup, a single-IP lookup, and a bulk lookup that resolves several IPs in one comma-separated request. It is a long-standing alternative for teams that want an HTTPS-only geolocation surface with currency and time-zone fields built into the response.
Install Jentic One Beta
Connect the ipapi - IP Geolocation API to your agent
Jentic One is a self-hosted execution layer for AI agents. It lets your agent call the ipapi - IP Geolocation 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 ipapi - IP Geolocation API.
Resolve any IPv4 or IPv6 address to country, region, city, and ZIP code
Geolocate the requesting IP without supplying it explicitly via /check
Bulk lookup several IPs in one call by comma-separating them in the path
Return time zone, current local time, and GMT offset for an IP
Surface the local currency code, name, and symbol alongside the geolocation
Pull connection details such as ASN, ISP, and connection type for an IP
Use Cases
Patterns agents use ipapi - IP Geolocation API for, with concrete tasks.
★ Currency and Locale Personalisation
E-commerce and SaaS sites can call /check on a request to detect the visitor's country, currency, and time zone in one call, then pre-fill the currency selector and apply locale-specific copy. Bundling currency into the geolocation response avoids a second lookup against a separate ISO data source.
Call /check with no IP from the server-side handler and pre-fill the currency selector with the returned currency_code.
Time Zone-Aware Scheduling
Scheduling and notification platforms can resolve a user's IP to a time zone and local time, then schedule emails or push notifications for a sensible local hour. The response includes the IANA time zone id and the GMT offset so the scheduler does not have to look them up separately.
Look up an IP and return the IANA time zone id along with the next local 09:00 timestamp for a notification.
Bulk Log Enrichment
Operations teams can pass several IPs at once via the bulk endpoint to enrich access logs or audit traces with country, city, ISP, and ASN, which is cheaper than firing one request per IP. The response is keyed by IP so the result merges back into the source row easily.
Bulk-resolve 10 IPs from a log row and return country, city, and ISP for each.
Agent-Driven Visitor Insight
An AI agent connected via Jentic can call /check on a request handler, read the country, currency, and time zone, and pick the right localisation rules without the developer wiring three look-up libraries. The agent searches Jentic by intent rather than juggling ipapi's three endpoints by hand.
On a request handler, call ipapi /check via Jentic and return a JSON object with country, currency_code, and timezone.id.
Key Endpoints
3 endpoints — ipapi is a hosted ip geolocation service that resolves ipv4 and ipv6 addresses to country, region, city, latitude and longitude, time zone, currency, and connection details.
METHOD
PATH
DESCRIPTION
GET
/check
Geolocate the requesting IP
GET
/{ip}
Geolocate a single IP address
GET
/{ips}
Bulk geolocate multiple IPs
GET
/check
Geolocate the requesting IP
GET
/{ip}
Geolocate a single IP address
GET
/{ips}
Bulk geolocate multiple IPs
Why Jentic?
Three things that make agents converge on Jentic-routed access.
Credential isolation
The ipapi access_key is stored encrypted in the Jentic vault and injected as the access_key query parameter at execution time, so the raw key never enters the agent context or logs.
Intent-based discovery
Agents search Jentic by intent ('geolocate an IP', 'get currency for visitor') and Jentic returns the ipapi operation with its input schema, exposing the bulk path when several IPs need to be resolved in one call.
Time to first call
Direct ipapi integration: under an hour for the access_key flow. Through Jentic: a few minutes for search, load, execute.
Related APIs
Alternatives and complements available in the Jentic catalogue.
FAQs
Specific to using ipapi - IP Geolocation API through Jentic.
What authentication does the ipapi API use?
ipapi uses an access_key query parameter on every request. Through Jentic the key is held in the encrypted vault and appended at execution time so the raw key never enters the agent context.
Can ipapi return the currency for the visitor's country?
Yes. The response includes a currency object with the ISO code, English name, plural name, and symbol alongside the geolocation fields, which is useful for currency selectors and pricing display.
Can I bulk lookup IPs in one call?
Yes. Comma-separate the IPs in the path (for example /1.1.1.1,8.8.8.8) and ipapi returns an array keyed by IP. This is the recommended pattern for log-enrichment workloads.
What are the rate limits for the ipapi API?
Free plans cap monthly volume; paid plans raise the cap and unlock HTTPS plus additional response fields. The exact monthly volume per plan is documented at https://ipapi.com and surfaces as quota errors in the response when exhausted.
How do I geolocate an IP through Jentic?
Search Jentic for 'geolocate an IP with ipapi', load the schema for GET /{ip}, and execute with the ip parameter. Run pip install jentic, then await client.search, await client.load, await client.execute.
Does ipapi support IPv6?
Yes. The /{ip} endpoint accepts IPv4 and IPv6 addresses and returns the same response shape for both, so an agent can pass either family without branching.
GET STARTED