Mapize API

A versioned, provider-agnostic REST API over your datasets and maps. Every response carries a schema_version and speaks canonical shapes only — never a vendor payload. Questions? Sign in and this page will show our email directly, or use the form below.

Questions

Base URL

https://mapize.com/v1

Authentication

Send your API key as a bearer token. Create and manage keys on the API keys screen.

Authorization: Bearer <api-key>

readList and read datasets, maps, and sync history.
writeCreate datasets, push rows, trigger refresh, and create shares.

Rate limits & billing

Requests are rate-limited per key for fairness and abuse protection only. API usage is never metered or billed by call count — your plan governs what you can do, not how many calls you make.

Endpoints

POST/v1/datasetswriteIdempotency-Key

Create a dataset from pushed rows.

Request

{
  "name": "Stores",
  "rows": [
    {
      "row_key": "s1",
      "cells": {
        "Name": "Acme",
        "Street": "1 Main St",
        "City": "Austin"
      }
    }
  ]
}

Response

{
  "schema_version": 1,
  "dataset_id": "ds_1",
  "name": "Stores",
  "row_count": 1,
  "columns": [],
  "schema": {},
  "created_at": "2026-07-03T00:00:00.000Z"
}

GET/v1/datasetsread

List your datasets.

Response

{
  "schema_version": 1,
  "datasets": [
    {
      "dataset_id": "ds_1",
      "name": "Stores",
      "row_count": 1,
      "created_at": "2026-07-03T00:00:00.000Z"
    }
  ]
}

GET/v1/datasets/{id}read

Read one dataset's canonical shape.

Response

{
  "schema_version": 1,
  "dataset_id": "ds_1",
  "name": "Stores",
  "row_count": 1,
  "columns": [],
  "schema": {},
  "created_at": "2026-07-03T00:00:00.000Z"
}

POST/v1/datasets/{id}/rowswriteIdempotency-Key

Append or upsert rows (idempotent).

Request

{
  "rows": [
    {
      "row_key": "s2",
      "cells": {
        "Name": "Beta",
        "Street": "2 Oak Ave"
      }
    }
  ]
}

Response

{
  "schema_version": 1,
  "dataset_id": "ds_1",
  "rows_added": 1,
  "rows_updated": 0
}

POST/v1/datasets/{id}/refreshwriteIdempotency-Key

Trigger a refresh on a bound dataset.

Response

{
  "schema_version": 1,
  "dataset_id": "ds_1",
  "status": "queued",
  "run_id": null
}

GET/v1/maps/{id}read

Read a map's canonical style + filters.

Response

{
  "schema_version": 1,
  "map_id": "m_1",
  "name": "Store map",
  "spec": {},
  "visibility": "private"
}

POST/v1/maps/{id}/shareswriteIdempotency-Key

Create a public or unlisted share.

Request

{
  "visibility": "public"
}

Response

{
  "schema_version": 1,
  "map_id": "m_1",
  "share_slug": "abc123",
  "visibility": "public",
  "url": "https://mapize.com/map/abc123/"
}

GET/v1/maps/{id}/sync-historyread

Read the per-binding sync log.

Response

{
  "schema_version": 1,
  "map_id": "m_1",
  "runs": []
}

Errors

Every error uses one envelope so failures parse uniformly:

{
  "schema_version": 1,
  "error": {
    "code": "not_found",
    "message": "Dataset not found."
  }
}

Still need a hand? Contact support.