{"uid":"cap_wblRUExmUm-j2Ftzcrxg5","slug":"agenttools-ip-geolocation-lookup-1fc762be","name":"AgentTools IP Geolocation Lookup","description":"Geolocate any IPv4/IPv6 address (or the caller's own IP when omitted) via ipwho.is: country, region, city, coordinates, timezone, ASN/network owner and currency. Cached 24 hours per IP. Use this when an agent needs to where is an IP address? Country, city, ASN, timezone.","url":"https://agentstoolshub.com/api/v1/live/ip-lookup?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET"],"type":"string"},"queryParams":{"type":"object","required":[],"properties":{"ip":{"type":"string","description":"Leave empty to look up the caller's IP"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.005","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.005/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_LUpDf-VMcBTOBQZx5T_Je","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.005","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Geolocates any IPv4 or IPv6 address (or the caller's own IP) returning country, region, city, coordinates, timezone, ASN, network owner, and currency via ipwho.is","exampleAgentPrompt":"Can you look up where the IP address 203.0.113.45 is located — I need the country, city, timezone, and who owns that network?","exampleUseCases":[{"title":"Visitor country detection for content routing","prompt":"I'm getting traffic from the IP 185.220.101.32 — can you tell me what country and region it's from so I know how to route the request?"},{"title":"Timezone lookup for scheduling across users","prompt":"What timezone is the IP address 116.202.120.181 in? I need to know so I can schedule a meeting at the right local time for that user."},{"title":"ASN and ISP identification for security review","prompt":"Can you tell me who owns the IP 45.83.64.1 — like the ASN number and network name? I'm trying to figure out if it's a known hosting provider or residential connection."}],"resultDescription":"A JSON object containing the IP address's geographic location (country, country code, region, city, latitude, longitude), timezone identifier, ASN number, network/ISP name, and the local currency — sourced from ipwho.is and cached for 24 hours per IP.","failureModes":["Invalid IP format returns a validation error","Private or reserved IP ranges (e.g. 192.168.x.x) may return no geolocation data","Newly allocated IPs not yet in the ipwho.is database may return incomplete results","Rate limits or upstream ipwho.is outages may result in 503 or timeout responses","Payment failure (x402) blocks the request before execution"],"whenToPreferThis":"Choose this endpoint when an agent needs a quick, single-call IP geolocation that bundles country, city, coordinates, timezone, ASN, and currency in one response. It is ideal for enriching log data, personalizing content, detecting fraud patterns, or scheduling across time zones. The 24-hour cache makes it cost-efficient for repeated lookups of the same IP. Prefer alternatives if you need real-time ISP data without caching, bulk batch processing, or highly detailed threat intelligence beyond basic geolocation.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-12T12:44:58.149Z","isFirstParty":false,"canonicalSlug":"agenttools-ip-geolocation-lookup-1fc762be"}