{"uid":"cap_UjWwDzAFxXnUn7jXWgekF","slug":"bizintel-api-ip-geolocation-lookup-bc322163","name":"BizIntel API – IP Geolocation Lookup","description":"Resolves geographic city, region, ISP, and coordinates for an IP address via ip-api.com.","url":"https://bizintel-api.hahavoid0.workers.dev/geography/ip-lookup","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":{"type":"object","required":["ip"],"properties":{"ip":{"type":"string","description":"Target IP address"}}},"type":{"type":"string","const":"http"},"method":{"enum":["POST"],"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":{"type":"json","example":{"result":{"city":"Ashburn","country":"United States","regionName":"Virginia"},"warnings":[],"supported":true,"confidence":"high","data_as_of":"2026-06","disclaimer":"Informational support only. Not legal, tax, medical, veterinary, or financial advice. Verify with the cited official source or a qualified professional before acting."}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.02","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_qclIR61A1Ew_kxjYOH3bK","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.001","costPer":"request","priority":0,"asset":null,"unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Resolves an IP address to its geographic location, returning city, region, and country with a confidence score.","exampleAgentPrompt":"Can you look up the geographic location of the IP address 8.8.8.8 and tell me what city, region, and country it maps to?","exampleUseCases":[{"title":"Fraud detection by IP origin","prompt":"I have a suspicious login from IP 185.220.101.34 — can you tell me what city and country that IP is located in so I can decide if it's risky?"},{"title":"Personalizing content by visitor location","prompt":"A visitor just hit our site from IP 203.0.113.57 — where are they located so I can serve them region-appropriate content?"},{"title":"Auditing server traffic geography","prompt":"We're seeing a spike in traffic from IP 91.108.4.1 — can you geolocate it and tell me which country and region it's coming from?"}],"resultDescription":"Returns a JSON object containing the resolved city, region name, and country for the given IP, along with a confidence level (e.g. 'high'), a data freshness date, and any warnings or disclaimers. Indicates whether the IP lookup is supported.","failureModes":["Invalid or malformed IP address returns an error or unsupported flag","Private/reserved IP ranges (e.g. 192.168.x.x) may return no location data or low confidence","Very new or unallocated IP blocks may yield outdated or missing results","Network timeouts from the upstream geolocation data source"],"whenToPreferThis":"Choose this endpoint when you need fast, pay-per-call IP-to-geography resolution without managing API keys, especially in agent workflows that require USDC micropayment billing via x402 on Base. Useful when you need city-level granularity with a confidence signal rather than just country-level data.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T18:42:53.464Z","isFirstParty":false}