{
  "id": "ip-geolocation-api",
  "slug": "ip-geolocation-api",
  "name": "IP Geolocation API",
  "provider": {
    "slug": "apistead-labs",
    "name": "APIStead Labs",
    "verified": true
  },
  "category": "Address & Location",
  "tagline": "Turn an IP into a place and network.",
  "description": "IP geolocation with country, region, city, coordinates, timezone and ASN. Works for public IPv4 and IPv6 addresses.",
  "agent_summary": "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.",
  "intent_phrases": [
    "look up an IP address",
    "find the country and city for an IP",
    "get the ASN for an IP",
    "enrich a request with IP location"
  ],
  "faqs": [],
  "code_examples": [],
  "price": {
    "min_usdc": 0.001,
    "max_usdc": 0.001,
    "unit": "per_call"
  },
  "payment": {
    "protocol": "x402",
    "protocol_version": 2,
    "network": "eip155:8453",
    "network_name": "Base",
    "asset": "USDC",
    "price_min_usdc": 0.001,
    "price_max_usdc": 0.001,
    "unit": "per_call",
    "pay_to": "0x2E9804240E493DD8daeBa4F341a5086b92cde235",
    "authoritative_source": "402_challenge"
  },
  "networks": [
    "base"
  ],
  "primary_network": "base",
  "verification": "verified",
  "verification_detail": {
    "state": "verified",
    "verified_routes": 2,
    "total_routes": 2,
    "last_verified_at": "2026-11-13T13:52:21.457Z",
    "receipt_url": "https://basescan.org/tx/0x638e71f65c2bcc4874eb8b4eb9fde19d59d9df33c94b12c95ead4913e1522d44"
  },
  "verified_routes": 2,
  "total_routes": 2,
  "reliability": {
    "score": 86,
    "band": "caution",
    "uptime30d": 86.36,
    "lastCheckedAt": "2026-11-14T03:35:09.910Z"
  },
  "last_verified_at": "2026-11-13T13:52:21.457Z",
  "receipt_url": "https://basescan.org/tx/0x638e71f65c2bcc4874eb8b4eb9fde19d59d9df33c94b12c95ead4913e1522d44",
  "base_url": "https://apistead.qd.je/api/v1",
  "mcp_endpoint": "https://apistead.qd.je/mcp",
  "docs_url": "https://apistead.qd.je/api",
  "tags": [
    "ip",
    "geolocation",
    "asn",
    "fraud",
    "localization",
    "network"
  ],
  "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"
  ],
  "links": {
    "docs": "https://apistead.qd.je/api",
    "json": "https://x402.apistead.qd.je/api/apis/ip-geolocation-api",
    "markdown": "https://x402.apistead.qd.je/api/apis/ip-geolocation-api/md",
    "routes": "https://x402.apistead.qd.je/agent/routes?id=ip-geolocation-api",
    "receipts": "https://x402.apistead.qd.je/agent/receipts?id=ip-geolocation-api",
    "api_reference": "https://x402.apistead.qd.je/api",
    "mcp_guide": "https://x402.apistead.qd.je/mcp-docs",
    "skill": "https://x402.apistead.qd.je/skill",
    "openapi": "https://x402.apistead.qd.je/openapi.json"
  },
  "demo": true,
  "long_description": "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.\n\nUse `/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.",
  "provider_detail": {
    "slug": "apistead-labs",
    "name": "APIStead Labs",
    "description": "First-party data APIs built and verified by APIStead. US ZIP codes, IP intelligence, geocoding, weather, email and public records, all priced per call.",
    "website": "https://apistead.qd.je",
    "verified": true,
    "firstParty": true
  },
  "routes": [
    {
      "method": "GET",
      "path": "/ip/me",
      "url": "https://apistead.qd.je/api/v1/ip/me",
      "price_usdc": 0.001,
      "pay_to": "0x2E9804240E493DD8daeBa4F341a5086b92cde235",
      "description": "Look up the caller's own public IP.",
      "example_request": "GET https://apistead.qd.je/api/v1/ip/me",
      "example_response": {
        "ip": "203.0.113.10",
        "city": "London",
        "country": "United Kingdom",
        "country_code": "GB"
      },
      "verified": true,
      "last_checked_at": "2026-11-14T03:35:09.673Z",
      "latency_ms": 11,
      "uptime_30d": 86.87
    },
    {
      "method": "GET",
      "path": "/ip/{ip}",
      "url": "https://apistead.qd.je/api/v1/ip/{ip}",
      "price_usdc": 0.001,
      "pay_to": "0x2E9804240E493DD8daeBa4F341a5086b92cde235",
      "description": "Look up a public IPv4 or IPv6 address.",
      "example_request": "GET https://apistead.qd.je/api/v1/ip/8.8.8.8",
      "example_response": {
        "ip": "8.8.8.8",
        "asn": "AS15169",
        "city": "San Jose",
        "region": "California",
        "source": "ipwho.is",
        "country": "United States",
        "latitude": 37.3394,
        "timezone": "America/Los_Angeles",
        "longitude": -121.895,
        "country_code": "US"
      },
      "verified": true,
      "last_checked_at": "2026-11-14T03:35:09.600Z",
      "latency_ms": 3,
      "uptime_30d": 85.86
    }
  ],
  "changelog": [
    {
      "version": "1.0.0",
      "title": "Initial verified release",
      "body": "The route is live and settlement-verified on Base mainnet. Health checks, public receipts and agent-readable records are available.",
      "type": "release",
      "author": "APIStead Labs",
      "published_at": "2026-11-11T16:54:23.726Z"
    }
  ],
  "generated_at": "2026-11-14T04:08:41.698Z"
}