Developer API

Plug Suknana into any platform.

A REST API and embeddable viewer for real-estate portals, MLS feeds, and listing platforms. Auto-sync tours, embed walkthroughs, and meter usage per partner.

Get API accessRead the docs
GET /v1/tours
$ curl https://api.suknana.com/v1/tours \
    -H "Authorization: Bearer sk_live_…"

{
  "data": [
    {
      "id": "tr_8f4a",
      "title": "Marina Residences 12B",
      "embed_url": "https://suknana.com/e/tr_8f4a",
      "created_at": "2026-04-30T08:14:22Z"
    }
  ],
  "has_more": false
}
<5min
from key to first embed
99.9%
viewer uptime
REST
JSON over HTTPS

Built for platforms.

01

REST Endpoints

Fetch tours, list properties, and pull metadata over a clean JSON API. Authenticate with a per-agency API key and you're live.

List tours
GET /v1/tours
Authorization: Bearer sk_live_…

{
  "data": [
    {
      "id": "tr_8f4a",
      "title": "Marina Residences 12B",
      "embed_url": "https://suknana.com/e/tr_8f4a"
    }
  ]
}
02

Embed Viewer

Drop-in iframe and JS snippet. Tours render full-screen on listing pages with no upload step and no SDK to install.

Embed viewer
<iframe
  src="https://suknana.com/e/tr_8f4a"
  allow="fullscreen; xr-spatial-tracking"
  style="width:100%;aspect-ratio:16/9;border:0"
></iframe>
03

Webhooks

Subscribe to tour.created and tour.updated events. New scans appear in your portal seconds after they're published.

Webhook payload
POST https://your-portal.com/hooks
Content-Type: application/json

{
  "event": "tour.created",
  "tour": {
    "id": "tr_8f4a",
    "agency_id": "ag_77",
    "embed_url": "https://suknana.com/e/tr_8f4a"
  }
}
04

Usage & Billing

Per-key rate limits, embed counts, and usage dashboards. Bill partners by API call or fixed monthly tier — your choice.

Per-key usage
GET /v1/usage?key=ak_77
{
  "embeds_30d": 18420,
  "api_calls_30d": 96123,
  "limit_per_min": 600
}

Ready to integrate?

Talk to us about API access for real-estate portals, MLS providers, and listing platforms. We'll get you a sandbox key the same day.

Request API access