API Acre · Data Reverse Geocode

import { wrapFetchWithPayment } from "@x402/fetch";
import { privateKeyToAccount } from "viem/accounts";

const account = privateKeyToAccount(process.env.PRIVATE_KEY);
const fetchWithPay = wrapFetchWithPayment(fetch, account);

const res = await fetchWithPay("https://apiacre.com/v1/data/reverse-geocode", {
  method: "POST",
  headers: { "Content-Type": "application/json" },
  body: JSON.stringify({
    "latitude": 51.5074,
    "limit": 3,
    "longitude": -0.1278,
    "radius_km": 10
  }),
});
const data = await res.json();

curl -X POST \
  "https://apiacre.com/v1/data/reverse-geocode" \
  -H "Content-Type: application/json" \
  -d '{"latitude":51.5074,"limit":3,"longitude":-0.1278,"radius_km":10}' \
  -H "X-PAYMENT: <signed x402 payment>"

{
  "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"
}