Getting Started

Your first query in 5 minutes

1. Sign up at app.terranode.co

   Enter your email. You’ll receive a 6-digit verification code. No credit card required.

2. Get your API key

   After verifying, your API key is displayed and emailed to you. It looks like tn_.... Save it — you’ll need it for every request.

3. Enrich a location

   What does Terranode know about the Empire State Building?

   curl -s "https://api.terranode.co/v1/enrich?lat=40.7484&lng=-73.9856&system_dataset=us-counties" \
     -H "x-api-key: YOUR_API_KEY" | jq .

   {
     "summary": {
       "datasets_queried": 1,
       "datasets_matched": 1,
       "requests_charged": 1
     },
     "results": [
       {
         "dataset": "us-counties",
         "type": "system",
         "version": 1,
         "match": true,
         "intersections": [
           {
             "properties": {
               "STATEFP": "36",
               "COUNTYFP": "061",
               "GEOID": "36061",
               "NAME": "New York",
               "NAMELSAD": "New York County"
             },
             "on_boundary": false,
             "distance_m": 0,
             "distance_mi": 0
           }
         ]
       }
     ],
     "errors": [],
     "latency_ms": 12,
     "api_version": "v1",
     "semantics_version": "0.1.0"
   }

4. Try all-dataset discovery mode

   Omit the dataset parameter to query everything at once:

   curl -s "https://api.terranode.co/v1/enrich?lat=40.7484&lng=-73.9856" \
     -H "x-api-key: YOUR_API_KEY" | jq .

What you can do

Operation	Description	Endpoint
Enrich	Everything Terranode knows about a location	GET /v1/enrich
Point in Polygon	Find which polygon contains a point	GET /v1/pip
Nearest	Find the N closest features to a point	GET /v1/nearest
Distance	Geodesic distance between two points	GET /v1/distance
Spatial Join	Batch enrich points with dataset attributes	POST /v1/spatial-join
Datasets	Upload and manage your own datasets	POST /v1/datasets
Usage	Check your quota and rate limits	GET /v1/usage

All operations work on pre-loaded US boundary datasets (states, counties, ZIP codes, Census tracts, and more) or your own uploaded data.

Integrations

Use the API without writing code:

• AI Agents (MCP) — give Claude Desktop, Cursor, or any MCP client spatial query tools
• n8n — add spatial operations to your n8n workflows via community node
• Zapier — use spatial operations as actions in your Zaps (early access)

Base URL

https://api.terranode.co/v1

All endpoints require the /v1 version prefix. Requests without it return 400.

Every request requires an x-api-key header. See Authentication.

The OpenAPI spec describes every endpoint, parameter, and response.