# IP Geolocation Lookup API

> IP Geolocation Lookup API is a paid API for AI agents from ipgeo.payapi.market, paid per call via x402, $0.001/call, status unknown (last checked 2026-10-17).

Resolves an IPv4 or IPv6 address to geographic and network metadata including city, region, country, ISP, ASN, coordinates, timezone, and datacenter/VPN/proxy flags.

## Facts

- Endpoint: POST https://ipgeo.payapi.market/lookup/ip?utm_source=zero.xyz
- Price: $0.001/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-17
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/ip-geolocation-lookup-api-9819ba0a
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_Ja7kAiCamc9Qjo8UBJUNK

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability ip-geolocation-lookup-api-9819ba0a -d '<json body>'
```

Example prompt: Can you look up where the IP address 203.0.113.47 is located — I need the city, country, ISP, and whether it's a datacenter or VPN?

## When to prefer this

Choose this endpoint when you need a single, fast IPv4 or IPv6 geolocation with rich network metadata (ASN, ISP, datacenter/VPN/proxy flags) via a pay-per-call x402 micropayment model — ideal for agents that need on-demand IP intelligence without a subscription. Prefer over alternatives when you specifically need proxy/datacenter detection alongside geographic data in one call.

## Known failure modes

- IP not found in database — 'found: false' returned with empty location fields
- Invalid IP format — malformed IPv4/IPv6 string causes a 400 or error response
- Private/reserved IP ranges (e.g. 192.168.x.x, 10.x.x.x) may return no geolocation data
- Payment failure via x402 protocol results in 402 response before lookup is attempted
- Rate limiting or quota exhaustion may return 429 errors

## How this service works

IP geolocation, batch lookup, distance calculation, and caller-IP introspection with x402 payments.

## Output

Returns a JSON object with the IP's city, region, country, country code, latitude, longitude, timezone, postal code, ISP, ASN, organization, and boolean flags for datacenter, VPN, and proxy status. Also includes a 'found' field indicating whether the IP was successfully resolved and the data source used.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "ip": {
   "type": "string",
   "description": "IPv4 or IPv6 address to geolocate, e.g. '8.8.8.8'."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "ip": "8.8.8.8",
  "asn": "AS15169",
  "isp": "Google LLC",
  "org": "Google Public DNS",
  "city": "Ashburn",
  "found": true,
  "is_vpn": null,
  "region": "Virginia",
  "source": "ip-api.com",
  "country": "United States",
  "is_proxy": null,
  "latitude": 39.03,
  "timezone": "America/New_York",
  "longitude": -77.5,
  "postal_code": "20149",
  "region_code": "VA",
  "country_code": "US",
  "is_datacenter": true
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/ip-geolocation-lookup-api-9819ba0a/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from ipgeo.payapi.market](https://www.zero.xyz/host/ipgeo.payapi.market/llms.txt)