{"uid":"cap_YJ9XtCnZH2iVN5tr3iEGM","slug":"util-beauty-net-ip-lookup-f61411b8","name":"util.beauty Net IP Lookup","description":"Metered web utilities for developers and AI agents: browser screenshot and PDF, crypto, DNS and net tools. Pay per request with x402 (USDC on Base) or prepaid API keys.","url":"https://util.beauty/v1/net/ip","method":"POST","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","properties":{"input":{"type":"object","properties":{"body":{"type":"object","description":"JSON request body (see OpenAPI for the utility schema).","additionalProperties":true}}},"output":{"type":"object","properties":{"example":{"type":"object","properties":{"ok":{"type":"boolean"},"utility":{"type":"string"},"requestId":{"type":"string"},"chargedCredits":{"type":"number"}},"additionalProperties":true}}}}},"responseSchema":{"type":"json","example":{"ok":true,"utility":"…","requestId":"req_…","chargedCredits":1}},"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_D3jY4CU6p8oD52nMSkPDK","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":"Looks up IP address information (geolocation, ASN, etc.) for a given IP or the caller's IP via a metered web utility","exampleAgentPrompt":"Can you look up the IP address 8.8.8.8 and tell me what country, city, and ISP it belongs to?","exampleUseCases":[{"title":"Geolocate suspicious login IP","prompt":"A user just logged in from IP 185.220.101.45 — can you look up where that IP is located and what network it belongs to?"},{"title":"Identify own public IP address","prompt":"What's my current public IP address and what does the geolocation say about it?"},{"title":"Enrich IP in security report","prompt":"I have this IP address 203.0.113.42 from a security alert — look it up and tell me the country, ASN, and ISP so I can add it to my incident report."}],"resultDescription":"Returns a JSON object with ok: true, a utility identifier, a requestId, chargedCredits count, and the IP lookup payload containing geolocation fields such as country, city, region, ISP, ASN, and related network metadata for the queried IP address.","failureModes":["Invalid or malformed IP address returns an error response","Payment failure (insufficient USDC balance or invalid API key) results in 402 response","Rate limiting or quota exhaustion","Private/reserved IP ranges may return limited or no geolocation data","Network timeout if upstream IP database is unavailable"],"whenToPreferThis":"Choose this endpoint when you need quick, pay-per-request IP geolocation and network lookups without a subscription, especially when operating as an AI agent with x402/USDC payment capability or a prepaid API key. Ideal for low-volume or bursty lookups where per-call pricing is preferable to a monthly plan.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-13T18:39:24.050Z","isFirstParty":false}