Install Jentic One Beta
Jentic One is a self-hosted execution layer for AI agents. It lets your agent call the ipdata.co IP Enrichment 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://jentic.com/install.sh?src=apis&api=%2Fapis%2Fipdata.co%2Fmain" | shStep 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%2Fipdata.co%2Fmain" | 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.
What an agent can do with ipdata.co IP Enrichment API.
Geolocate an IP address with country, region, and city
Return threat intelligence flags for an IP
Resolve mobile carrier, timezone, and currency for an IP
Look up ASN and network ownership for an IP
Enrich many IP addresses in a single bulk request
GET STARTED
Request a single field for an IP to trim the response
Patterns agents use ipdata.co IP Enrichment API for, with concrete tasks.
★ IP risk and geolocation enrichment
A fraud or access flow needs both where an IP is and whether it is risky. ipdata returns geolocation alongside threat intelligence flags, carrier, and ASN in one lookup, so an application can score a request from a single call. Field-level lookups trim the response when only one attribute is needed.
Look up an IP and return its country, ASN, and threat flags
Bulk address enrichment with residency
A pipeline needs enrichment for many IPs while keeping data in a chosen region. ipdata accepts a bulk request and offers United States and European hosts, letting a team enrich logs at volume through the endpoint that fits their residency requirements. Each result carries the full enrichment record.
Send a batch of IP addresses to the European host and return the enrichment record for each
AI agent request scoring
An AI agent evaluating an incoming request can enrich the source IP before it acts. The agent resolves geolocation, carrier, and threat flags, and uses them to decide whether to proceed, with the lookup gated behind the operation the operator has allowed. All calls are read-only.
Given a source IP, resolve its threat flags and country and return a proceed or block signal
4 endpoints — ipdata is an ip enrichment api that returns geolocation, threat intelligence, mobile carrier, timezone, currency, and asn data for any ip address.
METHOD
PATH
DESCRIPTION
/
Look up the calling device's IP
/{ip_address}
Look up a specific IP address
/{ip_address}/{field}
Look up a single field for an IP
/bulk
Bulk IP address lookup
/
Look up the calling device's IP
/{ip_address}
Look up a specific IP address
/{ip_address}/{field}
Look up a single field for an IP
/bulk
Bulk IP address lookup
What agents get from Jentic-routed access to this vendor.
Setup
Wiring ipdata by hand means provisioning an api-key, choosing between the United States and European hosts for data residency, and appending the key as a query parameter on every call. 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 ipdata call is a read against the enrichment service. You decide which operations are callable, and you can point an agent at a single regional host.
Credential isolation
Your ipdata 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.
Intent-based discovery
Agents find ipdata through Jentic's intent search: a query such as 'enrich an IP address' matches the lookup operations, which the agent then calls with your stored credential.
Alternatives and complements available in the Jentic catalogue.
Specific to using ipdata.co IP Enrichment API through Jentic.
What can an AI agent do with the ipdata API?
An agent can enrich an IP address with geolocation, threat intelligence, mobile carrier, timezone, currency, and ASN data, request a single field, or enrich many addresses in a bulk request. It is a read-only IP enrichment service.
How does the ipdata API authenticate?
ipdata authenticates with an api-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 ipdata 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 ipdata call is read-only, an agent can never modify data through it.
Does ipdata support regional data residency?
Yes. ipdata offers separate United States and European hosts, so you can send lookups to the regional endpoint that fits your data residency needs. Both hosts expose the same enrichment fields.
How do I connect the ipdata API to my AI agent with Jentic?
Install Jentic One with its setup script, import the ipdata API from the Jentic API Directory, and store your key once. Your agent can then call the lookup operations you allow.
For Agents
Lets an AI agent enrich IP addresses through ipdata with geolocation, threat, carrier, and ASN data for single, field-level, or bulk lookups.
Use for: I need geolocation and threat data for an IP, Check whether an IP is a known threat, Resolve the ASN and carrier for an IP address, Enrich a list of IPs in one request
Not supported: Does not handle IP blocking, DNS resolution, or user tracking. Use it for IP geolocation and enrichment lookups only.
ipdata is an IP enrichment API that returns geolocation, threat intelligence, mobile carrier, timezone, currency, and ASN data for any IP address. A lookup resolves a single address or a chosen field, and a bulk endpoint enriches many addresses at once. The service offers separate United States and European hosts so callers can keep requests in a chosen region.