POST

Convert an address or place name into latitude/longitude coordinates, with optional country filter. Powered by Nominatim (OpenStreetMap)

/v1/maps/geocode

Powered by OpenStreetMap

Request → Response

Examples from schemas.json.

Requestapplication/json
POST /v1/maps/geocode
Content-Type: application/json

{
  "q": "latest AI agent payments",
  "country_code": "example",
  "limit": 1
}
Responseapplication/json
HTTP/1.1 200 OK
Content-Type: application/json

// Endpoint-specific body after 402 settlement

Overview

Convert an address or place name into latitude/longitude coordinates, with optional country filter. Powered by Nominatim (OpenStreetMap).

Collaborative open geographic database powering Nominatim geocoding.

Request schema

Body: JSON · application/json

FieldTypeDescription
qstringrequired—
country_codestringoptional—
limitintegerrequiredmin: 1
IMPLEMENTATION
curl -X POST https://api.tools402.dev/v1/maps/geocode \
  -H "Content-Type: application/json" \
  -d '{
  "q": "latest AI agent payments",
  "country_code": "example",
  "limit": 1
}'

402 payment flow omitted — see Integrations for settlement.