Jentic OSThe workplace. An in-house AI platform for every employeeJentic OneSafe access. Agents reach your systems without holding keysJentic AIRThe foundation. Gets your existing platforms ready for AI
Pricing

GET STARTED

API DirectoryBrowse 10,000+ APIs ready for AI agent integrationDocumentationGuides and API reference

TOOLS

API ScoringCheck your AI readiness using our scorecardArazzo UIVisualize Arazzo workflows as interactive documentationArazzo EditorBuild and edit multi-step API workflows visually

COMMUNITY

GitHubOpen source projects and examplesOpen StandardsBuilt on open specs. Never locked in.
All ResourcesEverything in one placeBlogLatest articles and insightsTech Talk NewsletterAPIs, AI agents, architecture and strategyWebinarsLive sessions and on-demand recordingsReports & WhitepapersOriginal research on enterprise AI
About UsOur mission and teamCareersJoin our teamContactGet in touch
Try it now
Jentic OSJentic OneJentic AIR
Pricing
API DirectoryDocumentationAPI ScoringArazzo UIArazzo EditorGitHubOpen Standards
All ResourcesBlogTech Talk NewsletterWebinarsReports & Whitepapers
About UsCareersContact
Try it now
JenticJentic
Products
  • Jentic OS
  • Jentic One
  • Jentic AIR
For Developers
  • API Directory
  • Documentation
  • GitHub
Company
  • About Jentic
  • Careers
  • Contact Us
  • Trust Centre
ISO/IEC 27001:2022 certification badge issued by Prescient SecurityISO/IEC 27001:2022 certification badge issued by Prescient Security

Information Security Management System

Certified to ISO/IEC 27001:2022 by Prescient Security

AICPA SOC for Service Organizations logoAICPA SOC for Service Organizations logo

SOC 2® Type 1 report

Audited by Prescient Assurance

Terms & Conditions•Privacy Policy•
© 2026 Jentic Technology Ltd. All rights reserved.
2 Grattan Court East, Dublin, D02 VX86, Ireland
Switch to light modeSwitch to dark mode
APIs / Data Enrichment / IP2Location.io IP Geolocation API
IP2Location.io IP Geolocation API logo

IP2Location.io IP Geolocation API

34
AI ReadinessNon-Ready (F)34/100
See full scorecard
Community OpenAPI document · agent-readyData EnrichmentAddress ValidationapiKey1 EndpointsREST

Know of an official OpenAPI document? Contribute it →

For Agents

Resolve any IP address to country, city, ISP, ASN, time zone, and proxy flags so an agent can enrich logs or apply geo and risk rules.

Use for: I need to geolocate an IP address, Get the country and city for 8.8.8.8, Look up the ISP and ASN for a list of IPs, Retrieve the time zone for an IP

Not supported: Does not handle domain WHOIS, full threat intelligence, or device fingerprinting - use for IP geolocation and proxy flag lookups only.

IP2Location.io IP Geolocation API is a RESTful, JSON-first geolocation service that resolves an IPv4 or IPv6 address to country, region, district, city, latitude and longitude, ZIP code, time zone, ASN, ISP, domain name, network speed, weather station, mobile carrier, elevation, and usage type. The single-endpoint surface accepts the API key as a query parameter and returns the requested fields in a flat JSON object. It is a modern alternative to the legacy api.ip2location.com surface for teams that want a simple HTTPS lookup with proxy and VPN flags included.

Jentic One on GithubView OpenAPI Document

Install Jentic One Beta

Connect the IP2Location.io IP Geolocation API to your agent

Jentic One is a self-hosted execution layer for AI agents. It lets your agent call the IP2Location.io 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://jentic.com/install.sh?src=apis&api=%2Fapis%2Fip2location.io%2Fip2location-io" | sh
2

Step 2: Agent machine

# On the machine where your agent runs (keep this separate from the instance):
curl -fsSL "https://jentic.com/install.sh?src=apis&api=%2Fapis%2Fip2location.io%2Fip2location-io" | 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 IP2Location.io IP Geolocation API.

Resolve any IPv4 or IPv6 address to country, region, city, and ZIP code

Return ISP, domain, ASN, and connection type for an IP address

Surface proxy, VPN, and TOR flags alongside the geolocation response

Look up time zone and usage type for an IP in the same call

Look up mobile carrier, MCC, and MNC for IPs that resolve to cellular networks

Geolocate the visitor IP from a request handler with a single GET

Use Cases

Patterns agents use IP2Location.io IP Geolocation API for, with concrete tasks.

★ Visitor Geolocation for Personalisation

Web applications can call the endpoint with the visitor IP and read country, city, and time zone to personalise content, route to the closest region, or pre-fill a currency selector. The single-endpoint surface keeps the integration small enough to do on the request path during cold starts.

Look up a visitor IP and return the country code, city, and currency for content personalisation.

Log Enrichment with Proxy Flags

Operations and security teams can enrich access logs with country, ISP, ASN, and proxy or VPN flags in one call, then aggregate the result into per-region and per-network dashboards. Bundling proxy detection into the geolocation response avoids a second API for trust signals.

For each unique IP in a log file, call IP2Location.io and write country, ISP, asn, and is_proxy back to the row.

Trust and Safety Triage

Risk teams can flag accounts whose recent logins resolve to commercial VPNs, hosting providers, or known proxy ranges. The response includes is_proxy, proxy_type, and usage_type so the triage decision is a single API call.

Look up an IP and raise a risk flag if is_proxy is true or usage_type is 'DCH'.

Agent-Driven IP Enrichment

An AI agent connected via Jentic can enrich a list of suspect IPs with location, ISP, and proxy flags by issuing one search query through Jentic. The agent does not need to remember the query parameters; Jentic surfaces the input schema with the optional fields documented.

For each IP in a list of 25, call IP2Location.io via Jentic and return a JSON summary keyed by IP with country, isp, and is_proxy.

Key Endpoints

1 endpoints — ip2location.

METHOD

PATH

DESCRIPTION

GET

/

Geolocate an IP address with optional proxy flags

GET

/

Geolocate an IP address with optional proxy flags

Jentic AI Readiness Score

This API is usable in Jentic One now. Its AI-readiness score against Jentic's framework shows where it stands today and where improvements would make it even easier for agents to use.

I

IP2Location.io IP Geolocation API

- Non-Ready (F)
34/100
94
Foundational Compliance
62
Developer Experience & Jentic Compatibility
13
AI-Readiness & Agent Experience
94
Agent Usability
100
Security
50
AI Discoverability
Powered by JenticScoring Framework 1.0.0 | Scoring Engine 0.4.0
Show dimension breakdown
94

Foundational Compliance

Base layer of spec validity and structural soundness.

Grade: A+Signals: 4
99%

Lint Results

Aggregated quality score from linter diagnostics, weighted by severity.

100%

Resolution Completeness

Percentage of `$ref` references that resolve successfully.

100%

Specification Validity

Checks whether the API description parses successfully and conforms to its declared specification (e.g., OpenAPI).

75%

Structural Integrity

Structural correctness score based on schema issues using logarithmic dampening.

62

Developer Experience & Jentic Compatibility

Clarity, completeness, and ingestion readiness for developers and tooling.

Grade: B-Signals: 4
22%

Example Density

How richly the API is illustrated with examples.

100%

Example Validity

Percentage of examples that conform to their schemas.

25%

Response Coverage

Percentage of operations with complete response definitions (success, client error, server error).

100%

Tooling Readiness

Health of API ingestion, bundling, and resolution within Jentic pipelines.

13

AI-Readiness & Agent Experience

Semantic breadth, depth, and agent comprehension for AI systems.

Grade: FSignals: 4
50%

Description Coverage

Coverage of descriptions across API elements.

0%

Error Standardization

Coverage of RFC 9457 Problem Details for error responses.

0%

OperationId Quality

Coverage, uniqueness, and casing consistency of operationIds for AI inference.

0%

Summary Coverage

Coverage of summaries across operations/tags/info.

94

Agent Usability

Functional utility, complexity comfort, and AI orchestration readiness.

Grade: A+Signals: 1
94%

Complexity Comfort

Agent comfort level based on API operational and structural complexity.

100

Security

Trust, risk posture, and security compliance.

Grade: A+Signals: 1
100%

Authentication Strength

Average quality of security schemes based on authentication method strength (weakest link for OAuth2).

50

AI Discoverability

Findability, semantic richness, and reasoning readiness.

Grade: C-Signals: 1
50%

Descriptive Richness

Clarity and depth of descriptions across API elements.

View full reportHow the score is calculatedMore about the dimensions

Score it yourself

Every API in the directory is allowlisted, so you can re-score it with no key required.

Score your own APIScoring CLI agent skill
npx @jentic/api-scorecard-cli score <openapi-url>

Why Jentic?

What agents get from Jentic-routed access to this vendor.

Setup

Wiring IP2Location.io by hand means registering for a key, passing it as the 'key' query parameter to api.ip2location.io, and parsing the fields you want out of each geolocation and proxy response. Through Jentic you install once, import IP2Location.io from the API Directory, store the key once, and your agent calls it.

Permission scoping

IP2Location.io exposes a single read-only lookup where the IP travels as a query parameter, so scope the agent to the operations it needs, such as geolocating an IP or reading a proxy flag. It remains a lookup client and cannot act beyond the operations you allow.

Credential isolation

Your IP2Location.io API key is stored once, encrypted, by your own Jentic One instance and injected as the 'key' query parameter at execution time. It never enters the agent's prompt, logs, or context.

Intent-based discovery

Agents search Jentic by intent such as 'geolocate an IP' or 'flag a VPN', and Jentic returns the IP2Location.io lookup operation with its input schema, including the optional fields parameter for trimming responses, so the agent calls the right endpoint without reading the docs.

Related APIs

Alternatives and complements available in the Jentic catalogue.

Alternative

IP2Location IP Geolocation

→

Legacy IP2Location surface that uses the 'package' parameter to select response fields.

Pick the legacy surface when the package selector matters for cost control; pick IP2Location.io for new builds with proxy detection included.

Alternative

ip-api

→

ip-api offers a free, no-key geolocation tier with the basic location, ISP, and ASN fields.

Pick ip-api when no API key is available and usage is non-commercial; pick IP2Location.io for commercial usage and bundled proxy detection.

Complementary

IP2Proxy

→

IP2Proxy is the dedicated proxy detection surface from the same vendor with deeper PX2-PX11 detection levels.

Use IP2Proxy alongside IP2Location.io when proxy and VPN classification needs the extended detection levels.

FAQs

Specific to using IP2Location.io IP Geolocation API through Jentic.

What authentication does the IP2Location.io API use?

The endpoint accepts an API key as the 'key' query parameter. 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 the IP2Location.io API tell me whether an IP is a VPN?

Yes. The response includes is_proxy and proxy_type fields on plans that enable proxy detection, and usage_type identifies hosting and data-center IPs that often carry commercial VPN traffic.

Does the IP2Location.io API support IPv6?

Yes. The same endpoint accepts IPv4 and IPv6 addresses and returns the same JSON shape for both, so an agent can pass either family without branching.

What are the rate limits for the IP2Location.io API?

Throughput is governed by the credit balance on the API key rather than a per-minute rate limit; each lookup consumes one credit and richer plans surface more fields. Remaining credits are visible in the IP2Location.io account dashboard.

How do I geolocate an IP through Jentic?

Search Jentic for 'geolocate an IP with IP2Location.io', load the schema for GET /, and execute with the ip parameter. Run pip install jentic, then await client.search, await client.load, await client.execute.

What is the difference between IP2Location.io and api.ip2location.com?

IP2Location.io is the modern JSON-first hosted surface with proxy detection bundled in; api.ip2location.com is the legacy surface that uses a 'package' parameter to select fields. Pick the .io surface for new builds.

Can I limit what my agent is allowed to do with the IP2Location.io API?

Yes. IP2Location.io exposes a single read-only lookup where the IP travels as a query parameter, and because your Jentic One instance is self-hosted, your own rules decide which operations and credentials the agent may use. You can scope the agent to just the lookup operations it needs, such as geolocating an IP or reading its proxy and VPN flag, and it cannot act beyond the operations you allow. The stored API key is injected only when the agent calls an operation you have permitted, so it stays a read-only lookup client.

GET STARTED

Start building with IP2Location.io IP Geolocation API

Explore with Jentic One
View OpenAPI Document