{"uid":"cap_yt8fvZeXmddppZxPcDgtp","slug":"sitecheck-geocode-8e01f6a4","name":"SiteCheck Geocode","description":"Place names to coordinates and back: up to 5 matches for a name, or the place at a coordinate. Each match has a display name, latitude and longitude, country code and type. Attribution: © OpenStreetMap contributors, ODbL. Results are cached seven days.","url":"https://api.sitecheck-api.workers.dev/api/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":[],"properties":{"q":{"type":"string","description":"Place name, e.g. Berlin"},"lat":{"type":"string","description":"For reverse geocoding: latitude"},"lon":{"type":"string","description":"For reverse geocoding: longitude"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"query":{"q":"Berlin"},"source":"https://nominatim.openstreetmap.org search (OpenStreetMap data, cached 7 days)","results":[{"lat":52.5173885,"lon":13.3951309,"name":"Berlin","type":"administrative","countryCode":"DE","displayName":"Berlin, Deutschland"}],"checkedAt":"2026-10-14T04:49:23.637Z","attribution":"© OpenStreetMap contributors, ODbL"}},"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_DNmzBgqSO9K-7wu8vFiDg","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 to geographic coordinates (forward geocoding) or coordinates to a place name (reverse geocoding) using OpenStreetMap/Nominatim data.","exampleAgentPrompt":"What are the latitude and longitude coordinates for Berlin, Germany?","exampleUseCases":[{"title":"Enrich user location for downstream APIs","prompt":"I have a user who entered 'Tokyo' as their city — can you get me the latitude and longitude for Tokyo so I can pass it to a weather API?"},{"title":"Reverse geocode GPS coordinates","prompt":"I have coordinates 48.8566, 2.3522 — what city and country is that?"},{"title":"Map multiple office locations","prompt":"I need the geographic coordinates for our three offices: Munich, Singapore, and São Paulo. Can you look them up one by one?"}],"resultDescription":"Returns a JSON object with the original query, results array containing lat/lon, place name, type (e.g. administrative), country code, and display name, plus a source attribution string, checkedAt timestamp, and OpenStreetMap attribution notice. Results are cached for 7 days.","failureModes":["Place name not found or too ambiguous — empty results array returned","Invalid or out-of-range lat/lon for reverse geocoding — empty or error response","Missing required query parameter (neither q nor lat/lon provided) — likely 400 error","Rate limiting or upstream Nominatim unavailability — service error","Truncated or misspelled place names may return wrong or no results"],"whenToPreferThis":"Choose this endpoint when you need a simple, pay-per-call geocoding lookup without managing API keys for Google Maps or similar services. It is ideal for AI agents that occasionally need coordinates for a place name or want to reverse-geocode a coordinate, especially when already using other SiteCheck tools. Results are cached for 7 days, making it cost-efficient for repeated lookups of common cities.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-19T20:28:56.828Z","isFirstParty":false,"canonicalSlug":"sitecheck-geocode-8e01f6a4"}