IPInfoDB API

Name: IPInfoDB API
Brand: IPInfoDB API
Availability: InStock

✓ 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.

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.

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 | sh

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 instance

Jentic 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

GET STARTED

Start building with IPInfoDB API

Explore with Jentic

View OpenAPI Document

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

Your IPInfoDB key is stored once, encrypted, by your own Jentic One instance and injected into the query string at execution time. It never enters the agent's prompt, logs, or context.

Intent-based discovery

Agents search Jentic by intent such as 'find the country of an IP', and Jentic returns the matching IPInfoDB operation with its input schema, so the agent calls the right endpoint without reading the v3 docs.

Time to first call

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.

Alternative

IPGeolocation.io API

Geolocation with astronomy, time-zone, and user-agent parsing in one provider.

Choose ipgeolocation.io if you also need time-zone conversion or user-agent details from the same vendor.

Complementary

MaxMind GeoIP API

Industry-grade geolocation and fraud-scoring database with REST and downloadable variants.

Use MaxMind when you need offline lookups, audited datasets, or its minFraud risk scoring.

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.

Can I limit what my agent is allowed to do with the IPInfoDB API?

Yes. Because Jentic One is self-hosted, you decide which of IPInfoDB's two read-only lookups your agent may call, so you can grant only the country lookup (GET /ip-country/) or only the city lookup (GET /ip-city/) as your rules require. The agent stays a lookup client that resolves an IP to location fields and cannot reach anything beyond the operations you allow. Your API key is held by your own instance and added to the query string at execution time, so it never enters the agent's prompt or logs.