{"uid":"cap_DaHPPYnu_cFRBgm5bpL2D","slug":"suverse-geo-reverse-geocoding-bigdatacloud-bca4791c","name":"Suverse Geo Reverse Geocoding (BigDataCloud)","description":"Reverse-geocode lat/lon to country, state, city, locality and postcode via keyless BigDataCloud. Returns ISO codes and admin hierarchy. For agents turning coordinates into human-readable place names.","url":"https://proxy.suverse.io/v1/data/suverse-geo-reverse-bdc","method":"POST","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method","bodyType","body"],"properties":{"body":{"properties":{}},"type":{"type":"string","const":"http"},"method":{"enum":["POST","PUT","PATCH"],"type":"string"},"bodyType":{"enum":["json","form-data","text"],"type":"string"}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.002","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"settled","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.002/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.06","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.06","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_5G5q8oZzQgyL56auA5Q_G","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.06","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Reverse-geocodes latitude/longitude coordinates into human-readable place names including country, state, city, locality, and postcode with ISO codes and admin hierarchy.","exampleAgentPrompt":"What city, state, and country is at coordinates 37.7749° N, 122.4194° W? I need the full place name with ISO codes and postcode.","exampleUseCases":[{"title":"Tag photos with location names","prompt":"I have a batch of photos with GPS metadata — latitude 48.8566 and longitude 2.3522 — can you tell me the city, country, and postcode so I can label them properly?"},{"title":"Enrich delivery address from GPS drop","prompt":"A driver just dropped off at coordinates 51.5074, -0.1278 and I need to confirm the city, state, and postcode for the delivery record — can you look that up?"},{"title":"Identify country for compliance check","prompt":"We got a sign-up from someone at latitude 35.6762, longitude 139.6503 and I need to know the country and admin region so we can apply the right data regulations."}],"resultDescription":"Returns a structured location object including country name, ISO 3166-1 alpha-2 and alpha-3 country codes, principal subdivision (state/province), city name, locality, postcode, and the full administrative hierarchy for the given coordinates.","failureModes":["Invalid or out-of-range coordinates (e.g. lat > 90 or lon > 180) return an error or empty result","Coordinates in remote ocean areas may return country-level data only with no city or postcode","Malformed request body (missing lat/lon fields) returns a validation error","Upstream BigDataCloud service outage causes 502 or timeout"],"whenToPreferThis":"Use this endpoint when you need keyless reverse geocoding without managing your own API credentials, and you want ISO codes plus full admin hierarchy (country → state → city → locality → postcode) from a single call. Prefer it over forward geocoding services when you already have coordinates and need human-readable place names. It's especially suited for agentic pipelines that pay per-call via x402 without pre-registration.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-13T12:52:33.164Z","isFirstParty":false}