{"uid":"cap_Ja7kAiCamc9Qjo8UBJUNK","slug":"ip-geolocation-lookup-api-9819ba0a","name":"IP Geolocation Lookup API","description":"IP geolocation, batch lookup, distance calculation, and caller-IP introspection with x402 payments.","url":"https://ipgeo.payapi.market/lookup/ip?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"ip":{"type":"string","description":"IPv4 or IPv6 address to geolocate, e.g. '8.8.8.8'."}}},"responseSchema":{"type":"json","example":{"ip":"8.8.8.8","asn":"AS15169","isp":"Google LLC","org":"Google Public DNS","city":"Ashburn","found":true,"is_vpn":null,"region":"Virginia","source":"ip-api.com","country":"United States","is_proxy":null,"latitude":39.03,"timezone":"America/New_York","longitude":-77.5,"postal_code":"20149","region_code":"VA","country_code":"US","is_datacenter":true}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.001","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.001/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_TtHiTwMHqJKEyK6JxAc1A","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.001","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Resolves an IPv4 or IPv6 address to geographic and network metadata including city, region, country, ISP, ASN, coordinates, timezone, and datacenter/VPN/proxy flags.","exampleAgentPrompt":"Can you look up where the IP address 203.0.113.47 is located — I need the city, country, ISP, and whether it's a datacenter or VPN?","exampleUseCases":[{"title":"Fraud detection on signups","prompt":"This new account just registered from IP 185.220.101.5 — can you tell me if it's a VPN, proxy, or datacenter, and what country it's coming from?"},{"title":"Localize content for web visitors","prompt":"A visitor hit our site from IP 92.168.10.22 — what city, country, and timezone are they in so I can serve them the right regional content?"},{"title":"Investigate suspicious server traffic","prompt":"I'm seeing a lot of requests from 45.83.64.1 in our logs — can you geolocate it and tell me the ISP, ASN, and org behind it?"}],"resultDescription":"Returns a JSON object with the IP's city, region, country, country code, latitude, longitude, timezone, postal code, ISP, ASN, organization, and boolean flags for datacenter, VPN, and proxy status. Also includes a 'found' field indicating whether the IP was successfully resolved and the data source used.","failureModes":["IP not found in database — 'found: false' returned with empty location fields","Invalid IP format — malformed IPv4/IPv6 string causes a 400 or error response","Private/reserved IP ranges (e.g. 192.168.x.x, 10.x.x.x) may return no geolocation data","Payment failure via x402 protocol results in 402 response before lookup is attempted","Rate limiting or quota exhaustion may return 429 errors"],"whenToPreferThis":"Choose this endpoint when you need a single, fast IPv4 or IPv6 geolocation with rich network metadata (ASN, ISP, datacenter/VPN/proxy flags) via a pay-per-call x402 micropayment model — ideal for agents that need on-demand IP intelligence without a subscription. Prefer over alternatives when you specifically need proxy/datacenter detection alongside geographic data in one call.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-17T12:39:11.032Z","isFirstParty":false,"canonicalSlug":"ip-geolocation-lookup-api-9819ba0a"}