{"uid":"cap_6lZDCfaSCMlZGE6_NZVF7","slug":"suverse-ip-geolocation-via-ip-api-com-5abff2d4","name":"Suverse IP Geolocation (via ip-api.com)","description":"Geolocate an IP address via keyless ip-api.com. Returns country, region, city, zip, lat/lon, timezone, ISP, org and AS number. For agents enriching IPs with location and network owner.","url":"https://proxy.suverse.io/v1/data/suverse-net-ip-geo","method":"POST","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method","bodyType","body"],"properties":{"body":{"properties":{}},"type":{"type":"string","const":"http"},"method":{"enum":["POST","PUT","PATCH"],"type":"string"},"bodyType":{"enum":["json","form-data","text"],"type":"string"}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.0015","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"settled","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.0015/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.05","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.05","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_WK8f63iDiUSNG0Ampr-Zj","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.05","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Geolocates an IP address and returns country, region, city, ZIP, lat/lon, timezone, ISP, organization, and AS number via ip-api.com (keyless proxy).","exampleAgentPrompt":"Can you geolocate the IP address 8.8.8.8 and tell me which country, city, ISP, and AS number it belongs to?","exampleUseCases":[{"title":"Fraud detection IP screening","prompt":"I need to check the IP address 185.220.101.45 — can you tell me what country and ISP it's associated with, along with its AS number? I'm trying to figure out if it's suspicious traffic."},{"title":"Log enrichment for security team","prompt":"We have a web server log entry from IP 203.0.113.72 — can you look up its geolocation, timezone, and organization so we can add that context to our incident report?"},{"title":"Personalization by visitor IP","prompt":"A user just connected from IP 91.108.4.1 — what city, country, and timezone does that IP map to so we can show them localized content?"}],"resultDescription":"Returns a JSON object with the IP's geographic details (country, region, city, ZIP, latitude, longitude, timezone) and network details (ISP name, organization, and AS number), sourced from ip-api.com.","failureModes":["Invalid or malformed IP address returns an error or empty result","Private/reserved IP ranges (e.g. 192.168.x.x, 10.x.x.x) may return no location data","ip-api.com rate limits or downtime cause proxy failures","Missing or malformed request body returns a 4xx error","Payment failure via x402 protocol blocks the request"],"whenToPreferThis":"Choose this endpoint when you need a keyless, pay-per-call IP geolocation lookup without managing api-api.com API keys directly. It is ideal for agents that need to enrich individual IPs with full location and network owner metadata on-demand, especially in agentic workflows where credential management is impractical.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T00:53:20.908Z","isFirstParty":false}