{"uid":"cap_Kcpm3MIadyCKEIAO-DeyC","slug":"ip-geolocation-proxy-detection-api-62b877a2","name":"IP Geolocation & Proxy Detection API","description":"IP geolocation for any public IPv4 or IPv6 address, plus the field that decides whether to believe it. reliability is returned FIRST: datacentre, VPN, proxy and Tor detection, and when the upstream omits it the verdict is unknown, never clean. Also location, network (asn, org, isp, domain) and timezone. Requires ?ip=. Errors: 400 missing_ip|bad_ip|private_ip (private, loopback, link-local and reserved ranges are refused), 404 no_location, 504 ip_timeout.","url":"https://x402.donnyautomation.com/ip","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":["ip"],"properties":{"ip":{"type":"string","description":"Public IPv4 or IPv6 address, e.g. 8.8.8.8. Private, loopback, link-local and reserved ranges are refused."}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"ip":"8.8.8.8","ts":"2026-08-03T00:00:00.000Z","network":{"asn":15169,"isp":"Google LLC","org":"Google LLC","domain":"google.com"},"version":"IPv4","location":{"city":"San Jose","region":"California","country":"United States","latitude":37.336,"longitude":-121.891,"countryCode":"US"},"timezone":{"id":"America/Los_Angeles","isDst":true,"utcOffset":"-07:00"},"reliability":{"verdict":"VPN / proxy / hosting detection was NOT returned by the upstream for this address — this is unknown, not clean…","likelyMasked":null,"signalsAvailable":false}}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.01","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.01/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_4fiy_iJXw2D-aD5A0_PtO","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns country, region, city, postcode, coordinates, timezone, ASN, ISP, and proxy/VPN/Tor detection for any public IPv4 or IPv6 address.","exampleAgentPrompt":"Can you look up the geolocation and proxy/VPN status for IP address 203.0.113.42? I want to know the country, city, ISP, and whether it's coming from a datacenter or anonymizer.","exampleUseCases":[{"title":"Fraud detection for new signups","prompt":"We have a new user registration from IP 185.220.101.5 — can you check what country and city it's from, and whether it's a VPN, proxy, Tor node, or datacenter IP?"},{"title":"Personalizing content by visitor location","prompt":"I have a web visitor with IP 8.8.8.8 — what country, region, and timezone are they in so I can serve them localized content?"},{"title":"Identifying hosting provider behind suspicious traffic","prompt":"I'm seeing unusual API calls from 104.21.34.56 — can you find out what ASN, ISP, and organization own that IP, and whether it's a cloud or datacenter host?"}],"resultDescription":"Returns a structured JSON object with geolocation fields (country, region, city, postcode, latitude, longitude, timezone), network fields (ASN, org, ISP, domain), and anonymizer detection fields (datacenter, VPN, proxy, Tor). Missing upstream signals are reported as 'unknown' rather than clean/false, so absence of a signal is never silently treated as a negative.","failureModes":["Private, loopback, link-local, or reserved IP ranges are refused with an error","Malformed or non-IP input strings will be rejected","Upstream data gaps result in 'unknown' values rather than errors","IPv6 geolocation may have lower accuracy than IPv4"],"whenToPreferThis":"Choose this endpoint when you need both geolocation and proxy/anonymizer detection in a single call, especially when you require honest 'unknown' signals rather than a false-clean response for missing data. It is well-suited for fraud detection, access control, and content personalization pipelines that need to see ASN/ISP/hosting-provider context alongside location. Prefer it over pure geolocation APIs when distinguishing datacenter vs. residential vs. anonymized traffic matters.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T18:47:03.751Z","isFirstParty":false}