IPInfoDB API
✓ Official Vendor SpecData EnrichmentAddress ValidationapiKey2 EndpointsREST
For Agents
Resolve any IPv4 or IPv6 address to country or city-level location data, including coordinates and time zone, using a free API key. Suited to lightweight enrichment where ASN and risk signals are not needed.
Use for: Get the country code for an IP address, Find the city and time zone of an IPv4 address, Look up the postal code associated with an IP, Resolve a user's IP to latitude and longitude for distance calculations
Not supported: Does not handle ASN lookups, VPN/proxy detection, or domain WHOIS — use for basic IP-to-location enrichment only.
IPInfoDB is a long-running free IP geolocation service that maps IPv4 and IPv6 addresses to country and city-level data. The v3 API exposes two endpoints — ip-city and ip-country — both authenticated with an API key passed as a query parameter and returning JSON or XML. Country lookups give country name, code, and continent, while city lookups add region, ZIP code, latitude, longitude, and time zone.
Install Jentic One Beta
Connect the IPInfoDB API to your agent
Jentic One is a self-hosted execution layer for AI agents. It lets your agent call the IPInfoDB 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 IPInfoDB API.
Resolve an IP address to country name, country code, and continent in one call
Geolocate an IP to city, region, postal code, latitude, longitude, and time zone
Look up the requester's own IP location by omitting the ip parameter
Choose between JSON, XML, or serialized PHP response formats per request
Handle both IPv4 and IPv6 inputs through the same endpoints
Use Cases
Patterns agents use IPInfoDB API for, with concrete tasks.
★ Free Country-Level Visitor Routing
Route website or app visitors to a regional landing page or content variant based on the country derived from their IP, without the cost of a paid geolocation provider. The ip-country endpoint returns country code and name in a single fast call, suitable for free tiers and low-volume sites. Integration takes under an hour for a typical web app.
Call GET /ip-country/ with the visitor IP and the key query parameter, then redirect to the appropriate country landing page based on countryCode.
City-Level Time Zone Detection
Show times in the visitor's local time zone without asking for browser geolocation by mapping their IP through the ip-city endpoint, which returns the timeZone offset alongside city and coordinates. Useful for scheduling tools, SaaS dashboards, and email send-time optimization.
Call GET /ip-city/ for the user's IP, parse timeZone from the response, and convert all timestamps in the UI to that offset.
Coordinate Enrichment for Analytics
Append latitude and longitude to event records as they arrive in an analytics pipeline, enabling map visualizations and proximity queries without sending raw IPs downstream. ip-city returns numeric coordinates as part of every response and works on a free key for low to medium volume.
For each new event in the queue, call GET /ip-city/ with the source IP and write latitude and longitude into the event row before flushing to the warehouse.
Agent Geolocation via Jentic
Agents that need a quick country or city for an IP — for example to label a support ticket with the user's region — can call IPInfoDB through Jentic without managing the free key directly. Jentic resolves the agent's intent to one of the two endpoints and injects the key from the vault.
Use Jentic to search for 'free IP city lookup', load the ip-city operation, and execute it with the IP from the customer record.
Key Endpoints
2 endpoints — ipinfodb is a long-running free ip geolocation service that maps ipv4 and ipv6 addresses to country and city-level data.
METHOD
PATH
DESCRIPTION
GET
/ip-country/
Resolve an IP to country and continent
GET
/ip-city/
Resolve an IP to city, coordinates, and time zone
GET
/ip-country/
Resolve an IP to country and continent
GET
/ip-city/
Resolve an IP to city, coordinates, and time zone
Why Jentic?
Three things that make agents converge on Jentic-routed access.
Credential isolation
The IPInfoDB key is stored encrypted in the Jentic vault and added to the query string at execution time, so the agent's context never contains the raw key.
Intent-based discovery
Agents search by intent (e.g. 'find the country of an IP') and Jentic returns the matching IPInfoDB operation with its parameters, eliminating the need to read the v3 docs.
Time to first call
Direct IPInfoDB integration: about 1 hour for HTTP client, key handling, and JSON parsing. Through Jentic: under 5 minutes — search, load, execute.
Related APIs
Alternatives and complements available in the Jentic catalogue.
Alternative
ipapi - IP Geolocation API
Paid IP geolocation with bulk lookups, ASN, and VPN/proxy detection.
Choose ipapi when you need ASN, ISP, security flags, or batch lookups beyond IPInfoDB's two basic endpoints.
Alternative
IPstack API
Commercial IP geolocation with currency, language, and security modules.
Choose ipstack for production workloads needing higher rate limits, SLAs, and richer fields per IP.
FAQs
Specific to using IPInfoDB API through Jentic.
What authentication does the IPInfoDB API use?
IPInfoDB uses an API key supplied as the key query parameter on every request. Through Jentic, the key is stored in the encrypted vault and added at execution time so the secret never appears in agent context.
Is the IPInfoDB API free?
Yes. IPInfoDB offers a free tier with a registered API key suitable for moderate use; higher volume requires a paid plan or commercial license. The two endpoints behave the same way on free and paid keys.
Can I get coordinates and time zone from an IP with IPInfoDB?
Yes. The GET /ip-city/ endpoint returns latitude, longitude, and timeZone alongside city, region, and ZIP code in the same response.
Does IPInfoDB support IPv6 addresses?
Yes. Both /ip-country/ and /ip-city/ accept IPv6 inputs in the ip query parameter and return the same fields as for IPv4.
What are the rate limits for the IPInfoDB API?
Free keys are limited to roughly two requests per second per key, with no fixed monthly cap. Sustained higher throughput requires a commercial agreement with IPInfoDB.
How do I look up an IP through Jentic?
Search Jentic for 'IP to city lookup', load the ip-city operation, and execute it with the IP. Jentic injects the key parameter and returns the parsed JSON record.
GET STARTED