Quickstart

Mountaya has three products behind one set of keys. Pick the one you are building with and make your first call. Map Embedding and the Tile API need only a publishable key; the Data API adds a short-lived, server-side session token. 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 (data, tiles, and embedding) that gate which products it can reach, so enable the ones 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.

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.