canonical: https://jentic.com/apis/ipapi.com/main

# ipapi - IP Geolocation API

ipapi is an IP geolocation API that returns location data for any IPv4 or IPv6 address. A lookup provides country, region, city, latitude and longitude, timezone, currency, and connection details, and a bulk endpoint resolves many addresses in one request. A requester lookup returns the caller's own IP details.

## For AI agents

Lets an AI agent geolocate IPv4 and IPv6 addresses through ipapi, returning country, city, coordinates, timezone, and currency for single or bulk lookups.

## Scope

Does not handle IP blocking, threat scoring, or DNS resolution. Use it for IP geolocation lookups only.

## Capabilities

- Geolocate any IPv4 or IPv6 address
- Return country, region, city, and coordinates for an IP
- Resolve timezone and currency details for an IP
- Look up many IP addresses in a single bulk request
- Identify the caller's own IP details

## Use cases

### Visitor geolocation

A web product needs to localize content or detect region from a visitor's IP. ipapi resolves an address to country, region, city, and coordinates along with timezone and currency, so an application can tailor language, pricing, or routing from a single lookup. The requester endpoint returns the caller's own IP when no address is supplied.

Example prompt: Look up an IP address and return its country, city, and timezone

### Bulk IP enrichment

A data pipeline needs location fields for a list of IP addresses. ipapi accepts many addresses in one bulk request and returns the geolocation record for each, letting a team enrich logs or leads without a call per row. Results carry the same fields as a single lookup.

Example prompt: Submit a batch of IP addresses and return the country and city for each

### AI agent location context

An AI agent handling a request can add location context from the caller's IP. The agent resolves the address to a region, timezone, and currency, and uses it to route or localize its next step, with the lookup gated behind the operation the operator has allowed. All calls are read-only.

Example prompt: Given a visitor IP, resolve its timezone and currency and return them for localization

## Key endpoints

| Method | Path | Description |
| --- | --- | --- |
| GET | `/check` | Look up the requester's own IP |
| GET | `/{ip}` | Look up a single IP address |
| GET | `/{ips}` | Bulk lookup for multiple IP addresses |

## Key resources

- **Standard lookup** — Resolve a single IPv4 or IPv6 address to its geolocation record
- **Bulk lookup** — Resolve many IP addresses in one request
- **Requester lookup** — Return the geolocation details of the caller's own IP

## Why Jentic

- **Setup:** Wiring ipapi by hand means provisioning an access key, appending it as a query parameter on every call, and handling both single and bulk lookup shapes. Install Jentic One once, import the API from the Jentic API Directory, and store the credential once for your agent to reuse.
- **Permission scoping:** Scope your agent to the lookup operations it needs, since every ipapi call is a read against the geolocation service. You decide which operations are callable, so an agent gets exactly the lookups you grant.
- **Credential handling:** Your ipapi access key is stored once, encrypted, by your own Jentic One instance and injected only at execution time. It never enters the agent's prompt, logs, or context.
- **Discovery method:** Agents find ipapi through Jentic's intent search: a query such as 'geolocate an IP address' matches the lookup operations, which the agent then calls with your stored credential.

## Related APIs

- **IP-API** — IP geolocation lookups with a free tier
- **IP2Location.io** — IP geolocation with detailed location and network fields
- **IP2Proxy** — Detect proxies, VPNs, and anonymizers behind an IP
- **Abstract API** — A suite of enrichment APIs including IP geolocation and validation

## FAQ

### What can an AI agent do with the ipapi API?

An agent can geolocate a single IPv4 or IPv6 address, resolve many addresses in a bulk request, and read the caller's own IP details, returning country, city, coordinates, timezone, and currency. It is a read-only geolocation lookup.

### How does the ipapi API authenticate?

ipapi authenticates with an access key passed as a query parameter on each request. Jentic injects the key at execution time so it stays out of the agent's context.

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

Yes. Your Jentic One instance decides which operations an agent may call, so you can permit only the lookups a workflow needs. Because every ipapi call is read-only, an agent can never modify data through it.

### What data does an ipapi lookup return?

A lookup returns country, region, city, latitude and longitude, timezone, currency, and connection details for an IPv4 or IPv6 address, with a bulk option for resolving many addresses at once.

### How do I connect the ipapi API to my AI agent with Jentic?

Install Jentic One with its setup script, import the ipapi API from the Jentic API Directory, and store your access key once. Your agent can then call the lookup operations you allow.