Quickstart

Mountaya has four products behind one set of keys. Pick the one you are building with and make your first call. The Data API adds a short-lived, server-side session token; Map Embedding, the Map Studio API, and the Tile API need only a publishable key. Each path takes five minutes or less.

Get your keys

Keys come from your Mountaya dashboard under Settings → API keys. You get a publishable key (pk_…) that identifies your project and is safe to ship in a browser or mobile app; it authorizes everything here. If you call the Data API from a server, you also create a secret key (sk_…) that mints session tokens; keep it on a server you control and never expose it to a browser.

Each key carries scopes — embedding, tiles, resources, data, mcp and management — and each one authorizes a single product surface, so enable only what your integration needs. See authentication for the full key, scope, and session model.

Keep secret keys server-side

A leaked secret key can mint session tokens against your organization. Store it in an environment variable on your server and never ship it to a browser.

Make your first call

Choose your product and run its minimal example.

Drop the full map editor onto a page with a single <iframe> and your publishable key. No backend required.

<iframe
  src="https://app.mountaya.com/studio/embed?publishable_key=pk_your_publishable_key&terrain=topo"
  title="Mountaya map"
  width="100%"
  height="520"
  style="border: 0; border-radius: 8px;"
  loading="lazy"
></iframe>

That is a complete, interactive embed. Continue with the Map Embedding quickstart to select content and controls.

Choose your path

Map Embedding

Drop the full map editor into a page with one iframe. Publishable key only, about two minutes.

Data API

Query routing and geospatial data over GraphQL. Needs a server-side session token, about five minutes.

Map Studio API

Create an itinerary, draw a routed segment, and publish it. Publishable key and a member id, about five minutes.

Tile API

Render Mountaya basemaps and overlays in a map you already run. Publishable key only, about five minutes.

Next steps

Authentication

Keys, scopes, the session-token flow, query-parameter fallbacks, and rate limits in depth.

Core concepts

Coordinate order, resource types, units, activities, languages, and the API hostnames.

Tools

Connect an AI assistant to Mountaya over the MCP server, or install agent skills.