{"uid":"cap_bcGhHljIA67sI1eQJD3Qp","slug":"molcloud-ip-geolocation-lookup-a3623ac4","name":"MolCloud IP Geolocation Lookup","description":"41 pay-per-request AI, search, headless browser, crypto alpha & memory APIs for autonomous agents settling in USDC on Base via x402 v2.","url":"https://api.molcloud.net/api/security/ip-geo?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method","queryParams"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET","HEAD","DELETE"],"type":"string"},"queryParams":{"type":"object","properties":{"ip":{"type":"string","description":"Optional IP address to inspect"}}}}},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string","const":"json"},"example":{"type":"object","required":["status","endpoint"],"properties":{"data":{"type":"object"},"payer":{"type":"string"},"status":{"enum":["success"],"type":"string"},"endpoint":{"type":"string"}}}}}}},"responseSchema":{"type":"json","example":{"report":{"ip":"1.1.1.1","asn":13335,"country":"US"},"status":"success","endpoint":"/api/security/ip-geo"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.003","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.003/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.003","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.003","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_0kx2XkDo7yXVbYExTIR9-","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.003","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Looks up geolocation and ASN data for a given IP address, returning country, ASN, and network metadata.","exampleAgentPrompt":"What country and ASN is the IP address 203.0.113.42 associated with? I need the geolocation details.","exampleUseCases":[{"title":"Fraud detection by IP origin","prompt":"Check where this IP address 185.220.101.5 is coming from — I want the country and ASN so I can decide whether to flag this login attempt as suspicious."},{"title":"Identify visitor network for analytics","prompt":"Can you look up the geolocation and network info for IP 8.8.8.8? I want to know the country and ASN it belongs to for my traffic analytics."},{"title":"Security audit of incoming requests","prompt":"I'm seeing a lot of traffic from 45.33.32.156 — can you find out what country and autonomous system that IP is registered to so I can assess the risk?"}],"resultDescription":"Returns a JSON object with the queried IP address, its ASN number, and the country code it is associated with, plus a status field and the endpoint path. Example: {\"report\":{\"ip\":\"1.1.1.1\",\"asn\":13335,\"country\":\"US\"},\"status\":\"success\",\"endpoint\":\"/api/security/ip-geo\"}.","failureModes":["Invalid IP address format returns an error","Missing or malformed query parameter may return a 400 error","Unpaid or failed x402 payment returns a 402 Payment Required response","Rate limiting or quota exhaustion may return a 429 error","IP address not found in geolocation database may return empty or null data fields"],"whenToPreferThis":"Choose this endpoint when you need lightweight, pay-per-use IP geolocation and ASN lookup with no subscription, settling in USDC on Base via x402. Ideal for AI agents that need to enrich incoming request metadata, detect geographic origin for fraud or compliance purposes, or identify network operators on demand without maintaining a database subscription.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-17T12:41:04.054Z","isFirstParty":false,"canonicalSlug":"molcloud-ip-geolocation-lookup-a3623ac4"}