Skip to content
Free static example · no wallet required

Global reverse geocode

Inspect the exact response envelope first. When you need current analysis for your own input, one successful x402 call costs $0.002 USDC on Base or Solana.

Run a fresh result · $0.002 USDCReview schemaRaw JSON
No accountNo subscriptionExact USDC priceFresh calls only are paid
Full response envelope

What you receive

Demonstration data only. The paid endpoint returns a fresh result and settlement receipt.

{
  "request_id": "018f1f54-7f38-7ba2-8dc3-5f90272d9f1a",
  "service": "data.reverse-geocode",
  "version": "1",
  "data": {
    "version": "apiacre-reverse-geocode/1",
    "query": {
      "latitude": 51.5074,
      "longitude": -0.1278,
      "radiusKm": 10.0,
      "limit": 3
    },
    "candidateCount": 99,
    "matched": true,
    "resultsTruncated": true,
    "results": [
      {
        "rank": 1,
        "geonameId": 2643743,
        "name": "London",
        "country": {
          "code": "GB",
          "name": "United Kingdom",
          "iso3": "GBR",
          "continentCode": "EU"
        },
        "admin1": {
          "code": "ENG",
          "name": "England"
        },
        "coordinates": {
          "latitude": 51.50853,
          "longitude": -0.12574
        },
        "population": 8961989,
        "timezone": "Europe/London",
        "featureCode": "PPLC",
        "modifiedOn": "2026-08-17",
        "distanceKm": 0.19
      },
      {
        "rank": 2,
        "geonameId": 6615507,
        "name": "St James's",
        "country": {
          "code": "GB",
          "name": "United Kingdom",
          "iso3": "GBR",
          "continentCode": "EU"
        },
        "admin1": {
          "code": "ENG",
          "name": "England"
        },
        "coordinates": {
          "latitude": 51.5073,
          "longitude": -0.13982
        },
        "population": 10361,
        "timezone": "Europe/London",
        "featureCode": "PPLX",
        "modifiedOn": "2024-04-09",
        "distanceKm": 0.832
      },
      {
        "rank": 3,
        "geonameId": 6545173,
        "name": "Soho",
        "country": {
          "code": "GB",
          "name": "United Kingdom",
          "iso3": "GBR",
          "continentCode": "EU"
        },
        "admin1": {
          "code": "ENG",
          "name": "England"
        },
        "coordinates": {
          "latitude": 51.5144,
          "longitude": -0.13535
        },
        "population": 19634,
        "timezone": "Europe/London",
        "featureCode": "PPLX",
        "modifiedOn": "2023-07-17",
        "distanceKm": 0.937
      }
    ],
    "source": {
      "provider": "GeoNames",
      "dataset": "GeoNames cities500",
      "snapshotBuiltOn": "2026-08-18",
      "placeRecords": 235408,
      "aliasRecords": 766415,
      "homeUrl": "https://www.geonames.org/",
      "downloadUrl": "https://download.geonames.org/export/dump/",
      "license": "CC BY 4.0",
      "licenseUrl": "https://creativecommons.org/licenses/by/4.0/",
      "attribution": "GeoNames (CC BY 4.0; https://www.geonames.org/).",
      "transformation": "API Acre applies a bounded spatial lookup and great-circle distance ranking to the bundled populated-place snapshot.",
      "networkRequestsMade": 0
    },
    "limitations": [
      "Coverage follows the GeoNames cities500 extract: populated places above 500 residents and administrative seats through PPLA4, subject to source completeness and accuracy.",
      "This endpoint returns nearby populated places, not street addresses, parcels, points of interest, administrative boundary containment, or navigation routes.",
      "The nearest populated place is not proof of the queried coordinate's postal address, municipality, jurisdiction, or service area.",
      "Distances are rounded great-circle distances between coordinates and place centroids; they are not road, walking, or travel distances.",
      "The search radius is capped at 500 km and results use the bundled 2026-08-18 snapshot; an empty result does not prove that no settlement or named feature exists nearby."
    ]
  },
  "meta": {
    "duration_ms": 42,
    "cached": false,
    "sources": [],
    "warnings": [],
    "next_actions": [
      {
        "service": "data.us-weather-forecast",
        "title": "Global weather forecast",
        "reason": "Use the queried coordinates for a separately authorized current global forecast.",
        "method": "POST",
        "path": "/v1/data/us-weather-forecast",
        "price": "$0.003",
        "input_template": {
          "latitude": "$request.latitude",
          "longitude": "$request.longitude",
          "forecast_type": "day_night",
          "units": "si",
          "periods": 6,
          "include_current_conditions": false,
          "include_active_alerts": false,
          "timezone": "$result.data.results[0].timezone"
        },
        "use_output": "Treat the nearby place as context rather than boundary proof. The forecast is a separate paid request and current source coverage can vary by coordinates.",
        "handoff_path": "/catalog/data.us-weather-forecast",
        "checkout_path": "/try/data.us-weather-forecast",
        "sample_path": "/samples/data.us-weather-forecast",
        "maximum_atomic_usdc": "3000",
        "handoff_payment_required": false,
        "executes_automatically": false,
        "authorization_required": true
      }
    ]
  }
}
Example request

Input JSON

{
  "latitude": 51.5074,
  "longitude": -0.1278,
  "radius_km": 10,
  "limit": 3
}
Delivery contract

One paid POST

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.

POST /v1/data/reverse-geocode

Inspect validation rules and output schema

Need current data?

Run this exact service.

The checkout verifies the request, selected network, USDC asset, recipient, and price before opening a wallet.

Continue · $0.002 USDC