{"uid":"cap_mtdsl4ixOeUrQF87idsoO","slug":"agent402-tools-geocode-7f57ebf5","name":"agent402.tools Geocode","description":"Resolve a free-form address or place name to coordinates: lat/lon, display name, bounding box, place type. OpenStreetMap/Nominatim, no key. ?q=1600+Pennsylvania+Ave+Washington+DC&limit=1.","url":"https://agent402.tools/api/geocode","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":["q"],"properties":{"q":{"type":"string","description":"Free-form address or place name"},"limit":{"type":"number","description":"Results to return, 1-10 (default 1)"},"countryCodes":{"type":"string","description":"Comma-separated ISO-3166-1 alpha-2 codes to restrict, e.g. us,ca (optional)"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","required":["query","count","results","source"],"properties":{"count":{"type":"integer"},"query":{"type":"string"},"source":{"type":"string"},"results":{"type":"array","items":{"type":"object","properties":{"lat":{"type":"number"},"lon":{"type":"number"},"osm":{"type":"string"},"type":{"type":"string"},"class":{"type":"string"},"importance":{"type":"number"},"boundingBox":{"type":"object"},"displayName":{"type":"string"}}}}}}}}}},"responseSchema":{"type":"json","example":{"count":1,"query":"1600 Pennsylvania Ave NW, Washington, DC","source":"nominatim.openstreetmap.org (ODbL)","results":[{"lat":38.8976633,"lon":-77.0365739,"osm":"way/238241022","type":"attraction","class":"tourism","importance":0.78,"boundingBox":{"east":-77.0362519,"west":-77.0368537,"north":38.897829,"south":38.8974908},"displayName":"White House, 1600, Pennsylvania Avenue Northwest, Washington, District of Columbia, 20500, United States"}]}},"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_Nxe2Eym1zgB68Ul23V3YA","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":"Resolves a free-form address or place name to geographic coordinates (lat/lon), bounding box, display name, and place type using OpenStreetMap/Nominatim — no API key required.","exampleAgentPrompt":"What are the latitude and longitude coordinates for 1600 Pennsylvania Ave, Washington DC? Just return the top result.","exampleUseCases":null,"resultDescription":"Returns structured geocoding data including latitude, longitude, a human-readable display name, a bounding box (min/max lat/lon), and place type classification (e.g. building, city, road) based on OpenStreetMap data.","failureModes":["Address not found — returns empty array if Nominatim cannot match the query","Ambiguous place name returns unexpected location — mitigated by setting countryCodes filter","Payment failure — x402 payment of $0.003 USDC not processed, request rejected","Rate limiting or Nominatim upstream unavailability causes timeout or 5xx error","Invalid query parameter (missing q) returns validation error"],"whenToPreferThis":"Choose this endpoint when you need to convert a free-form address or place name to geographic coordinates without managing your own API key or quota. It is especially suitable for one-off geocoding needs in agentic workflows, when you want OpenStreetMap-backed results at low cost per call, and when you need bounding box or place type metadata alongside the coordinates.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-13T12:47:28.701Z","isFirstParty":false}