Geocoding API: place name to latitude and longitude

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

Find places by name in Wikidata (CC0) and get their coordinates, description, country, administrative region, population and elevation where recorded, best match first. Cities, towns, landmarks and other places with coordinates. Use before weather, sun or distance lookups, or to tell two places of the same name apart.

When to use it

Turn a city, town or landmark name into coordinates
Tell two places with the same name apart by country and region
Prepare coordinates for weather, sun or distance lookups

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

Inputs

Name	Type	Description
`name` (required)	string	Place name
`count`	integer	Max results (1-10, default 5)

Request

Over HTTP, with a card key from /credits:

curl -H "Authorization: Bearer adt_…" "https://tools.funwords.eu/geocode?name=Uppsala"

Or one of your 25 free calls, no key:

curl "https://tools.funwords.eu/geocode?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, and the first 25 successful calls are free:

https://tools.funwords.eu/mcp

Questions

Where does the data come from?

Wikidata (CC0), best match first, with population and elevation where recorded.

How do I pay?

Each successful call costs $0.01; failed calls are not charged. The first 25 calls are free. Then pay with card credits (from $1; the key goes in an Authorization header or, for clients that can only fetch a URL, as api_key= in the URL) or per call in USDC over x402 or MPP. No account is needed.