{"uid":"cap_IjSiJZWITN1LeyEzYeHMo","slug":"meterly-ai-geobyip-ip-geolocation-lookup-ba1625bb","name":"Meterly.Ai GeoByIP — IP Geolocation Lookup","description":"Pay-per-call API infrastructure for AI agents, bots, and developers. Access 95+ premium APIs with USDC payments on Base Mainnet via x402 protocol.","url":"https://meterly-ai.vercel.app/api/v1/geobyip","method":"POST","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","HEAD","DELETE"],"type":"string"},"queryParams":{"type":"object","required":["query"],"properties":{"url":{"type":"string","description":"URL to process"},"limit":{"type":"number","description":"Maximum results to return"},"query":{"type":"string","description":"Search query or input data"},"username":{"type":"string","description":"Username or profile identifier"}}}},"additionalProperties":false}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.05","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.05/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_SOrDBl8NsLq2a7BOHbiUz","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":"Looks up geographic location information (country, city, region, coordinates) for a given IP address or hostname query","exampleAgentPrompt":"What country and city is the IP address 203.0.113.42 located in? Use the geobyip lookup to find out.","exampleUseCases":[{"title":"Fraud detection for payment transactions","prompt":"Can you check where the IP address from that last transaction came from? Look up its location and let me know if it's in an unusual country for this customer."},{"title":"Content delivery region optimization","prompt":"I need to find out which cities and regions our users are connecting from. Can you geolocate these IP addresses and group them by timezone so we can optimize our CDN routing?"},{"title":"Security incident investigation","prompt":"We detected suspicious login attempts from several IP addresses. Please look up the geographic locations and ISP information for each one so we can see if they're coming from the same country or region."}],"resultDescription":"Returns a JSON object containing geographic details for the queried IP address, including country, city, region, approximate coordinates, ISP, and timezone information.","failureModes":["Invalid or malformed IP address returns error or empty result","Private/reserved IP ranges (e.g. 192.168.x.x) may return no geolocation data","Payment failure or insufficient USDC balance causes 402 response","Rate limiting or quota exceeded returns error response","Ambiguous query string that is not a valid IP or hostname may return unexpected results"],"whenToPreferThis":"Choose this endpoint when you need quick, pay-per-call IP geolocation without maintaining an API subscription — especially in autonomous agent workflows that process occasional IP lookups and pay with USDC on Base Mainnet via x402. Prefer this over self-hosted or subscription-based geo APIs when cost-per-call flexibility and crypto payment rails are priorities.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T12:32:41.065Z","isFirstParty":false}