{"uid":"cap_c-Mnj2haSxcC6GEMPQN7U","slug":"osm-geocoding-address-to-coordinates-42a929c9","name":"OSM Geocoding – Address to Coordinates","description":"51 REST endpoints for AI agents. Weather, news, crypto, stocks, products, courses, real estate, and 42 more. Pay per call in USDC/USDT via x402.","url":"https://engedi.digi-life17.workers.dev/api/geocoding","method":"GET","headers":{},"bodySchema":null,"responseSchema":{},"example":{"request":{"input":{"queryParams":{"query":"Eiffel Tower, Paris"}}},"response":{"_meta":{"cached":false,"source":"nominatim-osm","freshness":"real_time","confidence":0.9,"last_updated":"2026-07-01T05:12:22.326Z"},"count":1,"query":"Eiffel Tower, Paris","results":[{"lat":48.8582599,"lon":2.2945006,"map":"https://www.openstreetmap.org/?mlat=48.8582599&mlon=2.2945006","name":"Tour Eiffel, 5, Avenue Anatole France, Quartier du Gros-Caillou, Paris 7e Arrondissement, Paris, Île-de-France, France métropolitaine, 75007, France","type":"tower","address":{"city":"Paris","road":"Avenue Anatole France","state":"Île-de-France","region":"France métropolitaine","suburb":"Paris 7e Arrondissement","country":"France","quarter":"Quartier du Gros-Caillou","man_made":"Tour Eiffel","postcode":"75007","country_code":"fr","house_number":"5","city_district":"Paris","ISO3166-2-lvl4":"FR-IDF","ISO3166-2-lvl6":"FR-75C"},"importance":0.6205937724353116}],"success":true,"_discovery":{"examples":[{"path":"/api/flights","price":"$0.10","method":"GET","params":"origin=JFK&destination=LHR&date=2026-07-01"},{"path":"/api/domain-check","price":"$0.001","method":"GET","params":"domain=example.com"},{"path":"/api/translate","price":"$0.005","method":"GET","params":"text=hello&target=fr"},{"path":"/api/joke","price":"$0.001","method":"GET"},{"path":"/api/real-estate","price":"$0.10","method":"GET","params":"city=Austin&state=TX"}],"networks":["Base","Polygon","Arbitrum","Avalanche","Sei","Solana"],"protocol":"x402","categories":["Finance","Travel","Weather","Location","News","Commerce","Knowledge","Content","Environment","Work","Local","Education","Property","Utility"],"price_range":"$0.001 - $0.10","more_endpoints":"/api","paid_endpoints":43}}},"exampleRequest":{"input":{"queryParams":{"query":"Eiffel Tower, Paris"}}},"tags":["x402"],"displayCostAmount":"0.005","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.005/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_S7LHitrFa7_aDZgmTvNMq","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.005","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Converts an address or place name into geographic coordinates using OpenStreetMap data","exampleAgentPrompt":"What are the latitude and longitude coordinates for 1600 Pennsylvania Avenue NW, Washington DC?","exampleUseCases":null,"resultDescription":"Returns a data object with geographic coordinates (latitude/longitude) for the queried address or place, along with metadata including a confidence score, the data source (OpenStreetMap), whether the result was cached, and a last_updated timestamp. The success field indicates whether geocoding succeeded.","failureModes":["Address or place name not found in OSM — returns success: false or empty data","Ambiguous query matching multiple places — lower confidence score or first-match result","Network timeout on the upstream OSM Nominatim service","Malformed or missing query parameter — likely 400 error","Rate limiting or payment failure — 402 response requiring x402 payment"],"whenToPreferThis":"Choose this endpoint when you need to convert a freeform address or place name to coordinates and want an OSM-backed result with a confidence score. Good for agents that need lightweight geocoding without requiring a Google Maps API key. Prefer over alternatives when cost-per-call matters ($0.005 USDC) and OSM coverage is sufficient for your use case.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T13:02:46.964Z","isFirstParty":false}