Resolve one latitude/longitude pair into bounded, great-circle-distance-ranked nearby GeoN
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.
2000 (raw units)
price
1
calls / 30d
1
unique payers
2026-09-01
updated
Provider
apiacre.com · discovered, not yet claimed by its owner
Payment (x402 accepts[])
[
{
"scheme": "exact",
"network": "eip155:8453",
"payTo": "0xa0BFa4f07281c9b248DC3AED2217836BcA24869B",
"asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
"amount": "2000",
"maxTimeoutSeconds": 300
},
{
"scheme": "exact",
"network": "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp",
"payTo": "B4CHWQeQn7GDLZD2aW6hpGG2bEseisBFLZYECA3HDLan",
"asset": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
"amount": "2000",
"maxTimeoutSeconds": 300
}
]Output schema
{
"bazaar": {
"info": {
"input": {
"body": {
"latitude": 51.5074,
"limit": 3,
"longitude": -0.1278,
"radius_km": 10
},
"bodyType": "json",
"method": "POST",
"type": "http"
},
"output": {
"example": {
"data": {
"candidateCount": 99,
"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 ..."
],
"matched": true,
"query": {
"latitude": 51.5074,
"limit": 3,
"longitude": -0.1278,
"radiusKm": 10
},
"results": [
{
"admin1": {
"code": "ENG",
"name": "England"
},
"country": {
"code": "GB",
"continentCode": "EU",
"iso3": "GBR",
"name": "United Kingdom"
},
"geonameId": 2643743,
"name": "London",
"rank": 1
}
],
"resultsTruncated": true,
"source": {
"aliasRecords": 766415,
"dataset": "GeoNames cities500",
"placeRecords": 235408,
"provider": "GeoNames",
"snapshotBuiltOn": "2026-08-18"
},
"version": "apiacre-reverse-geocode/1"
},
"meta": {
"cached": false,
"duration_ms": 42,
"next_actions": [
{
"method": "POST",
"path": "/v1/data/us-weather-forecast",
"reason": "Use the queried coordinates for a separately authorized current global forecast.",
"service": "data.us-weather-forecast",
"title": "Global weather forecast"
}
],
"sources": [],
"warnings": []
},
"request_id": "018f1f54-7f38-7ba2-8dc3-5f90272d9f1a",
"service": "data.reverse-geocode",
"version": "1"
},
"type": "json"
}
},
"schema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"input": {
"additionalProperties": false,
"properties": {
"body": {
"properties": {
"latitude": {
"type": "number"
},
"limit": {
"type": "integer"
},
"longitude": {
"type": "number"
},
"radius_km": {
"type": "number"
}
},
"required": [
"latitude",
"longitude"
],
"type": "object"
},
"bodyType": {
"enum": [
"json",
"form-data",
"text"
],
"type": "string"
},
"method": {
"enum": [
"POST",
"PUT",
"PATCH"
],
"type": "string"
},
"type": {
"const": "http",
"type": "string"
}
},
"required": [
"type",
"method",
"bodyType",
"body"
],
"type": "object"
},
"output": {
"properties": {
"example": {
"properties": {
"data": {
"additionalProperties": false,
"properties": {
"candidateCount": {
"type": "integer"
},
"limitations": {
"items": {
"type": "string"
},
"type": "array"
},
"matched": {
"type": "boolean"
},
"query": {
"type": "object"
},
"results": {
"items": {
"type": "object"
},
"type": "array"
},
"resultsTruncated": {
"type": "boolean"
},
"source": {
"type": "object"
},
"version": {
"type": "string"
}
},
"required": [
"version",
"query",
"candidateCount",
"matched",
"resultsTruncated",
"results",
"source",
"limitations"
],
"type": "object"
},
"meta": {
"properties": {
"cached": {
"type": "boolean"
},
"duration_ms": {
"type": "integer"
},
"next_actions": {
"items": {
"type": "object"
},
"type": "array"
},
"sources": {
"items": {
"type": "string"
},
"type": "array"
},
"warnings": {
"items": {
"type": "string"
},
"type": "array"
}
},
"required": [
"duration_ms",
"cached",
"sources",
"warnings",
"next_actions"
],
"type": "object"
},
"request_id": {
"type": "string"
},
"service": {
"type": "string"
},
"version": {
"type": "string"
}
},
"required": [
"request_id",
"service",
"version",
"data",
"meta"
],
"type": "object"
},
"type": {
"type": "string"
}
},
"required": [
"type"
],
"type": "object"
}
},
"required": [
"input"
],
"type": "object"
}
},
"payment-identifier": {
"info": {
"required": false
},
"schema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"id": {
"maxLength": 128,
"minLength": 16,
"pattern": "^[a-zA-Z0-9_-]+$",
"type": "string"
},
"required": {
"type": "boolean"
}
},
"required": [
"required"
],
"type": "object"
}
}
}Use it
curl
curl "https://apiacre.com/v1/data/reverse-geocode" # -> 402 Payment Required, accepts[] lists how to pay # retry with a PAYMENT-SIGNATURE (or PAYMENT header) once paid
JavaScript
const res = await fetch("https://apiacre.com/v1/data/reverse-geocode");
if (res.status === 402) {
const { accepts } = await res.json();
// pay one of accepts[] via an x402 client, then retry with the payment header
}Python
import httpx
res = httpx.get("https://apiacre.com/v1/data/reverse-geocode")
if res.status_code == 402:
accepts = res.json()["accepts"]
# pay one of accepts[] via an x402 client, then retry with the payment headerMachine-readable
Everything on this page is also available as clean JSON at /resources/2571.json, and this resource appears in /discovery/resources and /discovery/search.