Geocode an address, coordinates: place or address name to latitude and longitude

$0.002 per call · failed calls are never charged · no account or subscription: pay per call with a card key or USDC

Geocode a place or address to latitude and longitude: a city, town, landmark or address name becomes coordinates, with country, region, population and elevation where known, best match first (Wikidata, CC0). Use to turn a place name into coordinates for maps, distance, weather or routing.

Run it free (25 free calls) Buy credits by card (from $1) Example result (JSON)

Try it with your own inputs

Place name

Uses one of your 25 free calls. Nothing is charged, and a call that fails is not counted.

Inputs

NameTypeDescription
name (required)stringPlace name
countintegerMax results (1-10, default 5)

Request

Over HTTP, with a card key from /credits:

curl -H "Authorization: Bearer adt_…" "https://agent-data-tools.revmesh2074.workers.dev/geocode/address?name=Uppsala"

Or one of your 25 free calls, no key:

curl "https://agent-data-tools.revmesh2074.workers.dev/geocode/address?name=Uppsala&trial=1"

Without a key, the same URL answers 402 Payment Required with x402 and MPP terms, so an agent with a wallet pays per call in USDC (Base, Polygon, Arbitrum or Solana over x402; Base or Tempo over MPP) and retries.

Example result

{
  "count": 1,
  "results": [
    {
      "name": "Uppsala",
      "description": "city in Sweden",
      "country": "Sweden",
      "region": "Uppsala Municipality",
      "lat": 59.858,
      "lon": 17.645,
      "population": 170000,
      "elevation": 15,
      "wikidataId": "Q…"
    }
  ],
  "source": "Wikidata (CC0 public domain)"
}

From an AI agent (MCP)

Add the MCP server to Claude, Cursor or any MCP client. This tool is geocode_address, and the first 25 successful calls are free:

https://agent-data-tools.revmesh2074.workers.dev/mcp

Related tools