Resolve one global city or locality name into bounded, population-ranked GeoNames coordina
Resolve one global city or locality name into bounded, population-ranked GeoNames coordinates, country and first-level-region identity, 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": {
"limit": 5,
"place": "London, GB"
},
"bodyType": "json",
"method": "POST",
"type": "http"
},
"output": {
"example": {
"data": {
"ambiguous": true,
"candidateCount": 2,
"candidateCountCapped": false,
"limitations": [
"Coverage follows the GeoNames cities500 extract: populated places above 500 r...",
"Matching is exact after Unicode-to-ASCII normalization; this endpoint does no...",
"Unqualified names can be ambiguous. Review country, first-level region, GeoNa...",
"Population-based ranking is a selection aid, not proof that the first candida...",
"Results use the bundled 2026-08-18 snapshot and can differ from newer GeoName..."
],
"query": {
"limit": 5,
"normalized": "london, gb",
"place": "London, GB"
},
"results": [
{
"country": {
"code": "GB",
"continentCode": "EU",
"iso3": "GBR",
"name": "United Kingdom"
},
"geonameId": 2643743,
"matchedNameType": "primary",
"name": "London",
"rank": 1
}
],
"resultsTruncated": false,
"source": {
"aliasRecords": 766415,
"dataset": "GeoNames cities500",
"placeRecords": 235408,
"provider": "GeoNames",
"snapshotBuiltOn": "2026-08-18"
},
"version": "apiacre-place-geocode/1"
},
"meta": {
"cached": false,
"duration_ms": 42,
"next_actions": [
{
"method": "POST",
"path": "/v1/data/us-weather-forecast",
"reason": "Use one selected place candidate's coordinates for a separately authorized cu...",
"service": "data.us-weather-forecast",
"title": "Global weather forecast"
}
],
"sources": [],
"warnings": []
},
"request_id": "018f1f54-7f38-7ba2-8dc3-5f90272d9f1a",
"service": "data.place-geocode",
"version": "1"
},
"type": "json"
}
},
"schema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"input": {
"additionalProperties": false,
"properties": {
"body": {
"properties": {
"limit": {
"type": "integer"
},
"place": {
"type": "string"
}
},
"required": [
"place"
],
"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": {
"ambiguous": {
"type": "boolean"
},
"candidateCount": {
"type": "integer"
},
"candidateCountCapped": {
"type": "boolean"
},
"limitations": {
"items": {
"type": "string"
},
"type": "array"
},
"query": {
"type": "object"
},
"results": {
"items": {
"type": "object"
},
"type": "array"
},
"resultsTruncated": {
"type": "boolean"
},
"source": {
"type": "object"
},
"version": {
"type": "string"
}
},
"required": [
"version",
"query",
"candidateCount",
"candidateCountCapped",
"ambiguous",
"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/place-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/place-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/place-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/2572.json, and this resource appears in /discovery/resources and /discovery/search.