{"uid":"cap_aBLofF4oMLHZc-OazT_01","slug":"agenttools-ip-geolocation-lookup-78803182","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://agenttools-hub.vercel.app/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.002","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.002/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_v5JZfr_ROjL-llsqmMILy","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.002","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, cached 24 hours per IP.","exampleAgentPrompt":"Can you find out where the IP address 203.0.113.42 is located — country, city, timezone, and who owns the network?","exampleUseCases":[{"title":"Fraud detection geolocation check","prompt":"This login attempt came from IP 198.51.100.77 — can you tell me what country and city that IP is in, and who owns that network?"},{"title":"Identify caller's own location","prompt":"What country and timezone am I connecting from right now based on my current IP address?"},{"title":"Enrich server logs with location data","prompt":"Look up IP 45.33.32.156 for me — I need the country, region, ASN, and currency so I can tag this entry in my access log."}],"resultDescription":"Returns a JSON object with the queried IP's geolocation data including country name and code, region, city, latitude/longitude coordinates, timezone, ASN number, network/ISP owner name, and the currency used in that country. Data is cached for 24 hours per IP address.","failureModes":["Invalid or malformed IP address returns an error response","Private/reserved IP ranges (e.g. 192.168.x.x, 10.x.x.x) may return no or limited geolocation data","Upstream ipwho.is service unavailability causes lookup failure","Payment failure (insufficient USDC balance) blocks the request","Rate limiting if cache is bypassed or quota exceeded"],"whenToPreferThis":"Choose this endpoint when an agent needs structured geolocation metadata for an IP address including ASN/network owner and currency — not just country. It is ideal for fraud detection, access log enrichment, timezone inference from IP, and network attribution. The 24-hour cache makes it cost-efficient for repeated lookups of the same IP. Prefer over raw DNS or WHOIS lookups when structured, parsed output is needed immediately.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-02T12:41:29.283Z","isFirstParty":false,"canonicalSlug":"agenttools-ip-geolocation-lookup-78803182"}