{"uid":"cap_MoiP6g3GBKAT0iSpQ1lDB","slug":"scrapemole-pulse-geocoding-39b1cc02","name":"ScrapeMole Pulse Geocoding","description":"Pay-per-call \"state of the world\" lookups that language models cannot know on their own: official ECB exchange rates (latest, historical, conversion), the current time and DST-aware time-zone conversion for scheduling, global weather forecasts (MET Norway, by coordinates or place name), official US National Weather Service forecasts and active watches/warnings/advisories (by state, point, place or zone), the live Hacker News front page, public holidays for ~100 countries (list by year, check a date, next holidays, long weekends, available countries via Nager.Date), and geocoding / reverse geocoding (place or address ↔ coordinates via Photon and Nominatim over OpenStreetMap). Public, non-personal data with sources and licences in every response. USDC via x402, no accounts.\n\nPayments: x402 v2, scheme \"exact\", USDC on Base (eip155:8453). The payment is verified before the work and settled only when the response is 200. Terms: https://pulse.scrapemole.workers.dev/terms","url":"https://pulse.scrapemole.workers.dev/v1/geocode?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"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET"],"type":"string"},"queryParams":{"type":"object","required":["q"],"properties":{"q":{"type":"string","examples":["Vilnius"],"description":"Place name or address to resolve (aliases: place, address)."}},"additionalProperties":false}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"lat":54.687046,"lon":25.282911,"name":"Vilnius","note":"Public geographic data only (places, streets, addresses). Not for bulk scraping of personal contact data; attribution required when redistributing OSM-derived results.","type":"city","query":"Vilnius","source":"Photon (Komoot) over OpenStreetMap data; Nominatim fallback","country":"Lietuva","license":"ODbL 1.0 (OpenStreetMap contributors)","geocoder":"Photon (OpenStreetMap, ODbL)","sourceUrl":"https://photon.komoot.io","licenseUrl":"https://www.openstreetmap.org/copyright","countryCode":"LT","displayName":"Vilnius, Vilniaus miesto savivaldybė, Vilniaus apskritis, Lietuva"}},"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_KOPz4SRZbapPy6Wzf4cOX","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":"Converts a place name or address string into geographic coordinates (latitude/longitude) plus structured location metadata using Photon/Nominatim over OpenStreetMap.","exampleAgentPrompt":"What are the latitude and longitude coordinates for Vilnius, Lithuania? I need the geocoded location including country code and display name.","exampleUseCases":[{"title":"Coordinate lookup for weather queries","prompt":"I need the exact coordinates for Lyon, France so I can plug them into a weather forecast — can you geocode that city for me?"},{"title":"Address to coordinates for mapping","prompt":"Can you turn '10 Downing Street, London' into latitude and longitude coordinates so I can plot it on a map?"},{"title":"Validate and enrich user-submitted location","prompt":"A user typed 'Kyoto, Japan' as their city — can you geocode that and give me the official lat/lon, country code, and full display name so I can store it properly?"}],"resultDescription":"A JSON object containing latitude, longitude, place name, type (e.g. city), display name, country, country code, the source geocoder used (Photon or Nominatim), license (ODbL 1.0), license URL, source URL, and a note about permitted usage (not for bulk scraping of personal contact data; attribution required for OSM-derived results).","failureModes":["Place name not found — returns empty or error response if the query string doesn't match any known location","Ambiguous place names may resolve to unexpected countries or cities (e.g. 'Springfield' without context)","Very new or obscure addresses may not exist in OpenStreetMap data and will return no results","Malformed or empty query parameter causes a 400 bad request","Rate limiting or upstream Photon/Nominatim outage may cause temporary failures"],"whenToPreferThis":"Choose this endpoint when you need a simple, pay-per-call geocoding lookup without signing up for an API key, especially in agentic workflows where the agent needs to resolve a place name to coordinates on the fly. Prefer this over Google Maps or Mapbox geocoding when you want OSM-based open data with license transparency, USDC micropayment billing, and no account setup. Ideal for enriching location fields, preparing inputs for weather or time zone lookups, or resolving user-supplied location strings.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-21T18:38:47.061Z","isFirstParty":false,"canonicalSlug":"scrapemole-pulse-geocoding-39b1cc02"}