Skip to content
APIStead
Address & LocationVerifiedPreview

IP Geolocation API

Turn an IP into a place and network.

About this API

Agents use IP data for fraud checks, localization, content routing, analytics and network diagnostics. This API returns a compact, stable shape with the fields that matter and a confidence-friendly `source` label.

Use `/ip/me` to inspect the caller's own address, or `/ip/{address}` for a specific public IP. Private and reserved ranges are rejected with a clear error instead of a misleading location.

For AI agents

Turn a public IP address into approximate country, region, city, timezone, ASN and organisation data.

Scope

Approximate location only. Not for identity, precise location, private IPs or fraud decisions without another signal.

Endpoints

MethodRoutePrice
GET/ip/me$0.001
GET/ip/{ip}$0.001

Example request

request
GET https://apistead.qd.je/api/v1/ip/me

Example response

200 application/json
{
  "ip": "203.0.113.10",
  "city": "London",
  "country": "United Kingdom",
  "country_code": "GB"
}

Verification

Verified2 of 2 routes verified

APIStead paid one named route from its own wallet, received real product back, and published the on-chain USDC receipt. The badge covers that route, not the whole listing.

Last verified
13 Nov 2026

Use cases

  • Localize a request by the caller's IP
  • Add an IP risk signal to a fraud workflow
  • Resolve an IP to a city and timezone

Agent intents

Phrases an agent can use to find this route.

look up an IP addressfind the country and city for an IPget the ASN for an IPenrich a request with IP location

Changelog

1.0.0release11 Nov 2026

Initial verified release

The route is live and settlement-verified on Base mainnet. Health checks, public receipts and agent-readable records are available.

By APIStead Labs