{"uid":"cap_WdlmnSRSSBqRA02roRHLg","slug":"api-acre-reverse-geocode-be2f1874","name":"API Acre Reverse Geocode","description":"Resolve one latitude/longitude pair into bounded, great-circle-distance-ranked nearby GeoNames populated places with country, first-level region, population, timezone, feature code, and source freshness without a request-time network call.","url":"https://apiacre.com/v1/data/reverse-geocode?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"limit":{"type":"integer"},"latitude":{"type":"number"},"longitude":{"type":"number"},"radius_km":{"type":"number"}}},"responseSchema":{"type":"json","example":{"data":{"query":{"limit":3,"latitude":51.5074,"radiusKm":10,"longitude":-0.1278},"source":{"dataset":"GeoNames cities500","provider":"GeoNames","aliasRecords":766415,"placeRecords":235408,"snapshotBuiltOn":"2026-08-18"},"matched":true,"results":[{"name":"London","rank":1,"admin1":{"code":"ENG","name":"England"},"country":{"code":"GB","iso3":"GBR","name":"United Kingdom","continentCode":"EU"},"geonameId":2643743}],"version":"apiacre-reverse-geocode/1","limitations":["Coverage follows the GeoNames cities500 extract: populated places above 500 r...","This endpoint returns nearby populated places, not street addresses, parcels,...","The nearest populated place is not proof of the queried coordinate's postal a...","Distances are rounded great-circle distances between coordinates and place ce...","The search radius is capped at 500 km and results use the bundled 2026-08-18 ..."],"candidateCount":99,"resultsTruncated":true},"meta":{"cached":false,"sources":[],"warnings":[],"duration_ms":42,"next_actions":[{"path":"/v1/data/us-weather-forecast","title":"Global weather forecast","method":"POST","reason":"Use the queried coordinates for a separately authorized current global forecast.","service":"data.us-weather-forecast"}]},"service":"data.reverse-geocode","version":"1","request_id":"018f1f54-7f38-7ba2-8dc3-5f90272d9f1a"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.002","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.002/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_wD7ZGHydzm7ELQqose156","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.002","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Converts a latitude/longitude coordinate pair into nearby GeoNames populated places ranked by great-circle distance, with country, region, population, timezone, and feature metadata — served from a bundled dataset with no external network call.","exampleAgentPrompt":"What are the 3 nearest populated places within 10 km of latitude 51.5074, longitude -0.1278? I need their country, region, and timezone.","exampleUseCases":[{"title":"Tag photos with nearest city name","prompt":"I have a photo taken at latitude 48.8566, longitude 2.3522 — what are the top 5 nearest populated places within 20 km, along with their country and region, so I can tag it correctly?"},{"title":"Validate delivery address region","prompt":"We have a package drop point at latitude 40.7128, longitude -74.0060 — can you find the closest populated place within 15 km and tell me its country and first-level admin region?"},{"title":"Assign timezone from device GPS","prompt":"A user's device reported GPS coordinates 35.6895, 139.6917 — what populated places are within 25 km and what timezone do they fall in? Give me up to 5 results ranked by distance."}],"resultDescription":"A JSON object containing a ranked list of nearby GeoNames populated places, each with place name, geoname ID, great-circle distance rank, country (name, ISO2, ISO3, continent code), first-level administrative region (code and name), and dataset metadata including snapshot build date, total alias and place record counts, and whether results were truncated. Also includes query echo, candidate count, and next-action hints for related endpoints.","failureModes":["Missing or invalid latitude/longitude returns a validation error","radius_km exceeding 500 km is capped or rejected","No populated places within the specified radius returns matched: false with empty results","Malformed JSON body causes a 400 error","Very remote coordinates (open ocean, polar regions) may yield zero results within any reasonable radius"],"whenToPreferThis":"Choose this endpoint when you need fast, offline-resolved reverse geocoding to populated places (not street addresses) with structured administrative hierarchy, timezone, and population data from GeoNames — especially when determinism, low latency, and no external dependency at request time matter. Prefer it over street-address geocoders when the use case involves city/region attribution, timezone assignment, or place-name tagging rather than postal precision.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-10T00:47:28.265Z","isFirstParty":false,"canonicalSlug":"api-acre-reverse-geocode-be2f1874"}