Skip to content
API & Developer Integrations

Build AI Staging Into Your Product

Add virtual staging to your CRM, MLS platform, or PropTech product with RELTO's REST API. Submit a photo and poll for the staged result, or receive it by webhook. Batch processing included; custom branding options available.

Simple Integration

// image: a base64 data URL, or a public https:// URL that RELTO fetches.
// const image = "data:image/jpeg;base64," + fs.readFileSync("room.jpg").toString("base64")

const response = await fetch('https://relto.app/api/v1/staging', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer rlt_live_YOUR_KEY',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    image: 'data:image/jpeg;base64,<BASE64_DATA>',
    style: 'Modern Minimalist',
    roomType: 'living-room',
    skipWatermark: false,
    callbackUrl: 'https://your-app.com/webhooks/staging',
  }),
});

if (!response.ok) {
  const { error } = await response.json();
  throw new Error(error.code + ': ' + error.message);
}

// 202: job queued — extract jobId
const { data } = await response.json();
// { ok: true, data: { jobId: "...", status: "queued", estimatedProcessingTime: "105s" },
//   (estimatedProcessingTime is derived from queue depth; treat it as a hint, not a promise)
//   meta: { requestId: "stg-a1b2c3d4", timestamp: "..." } }

// Poll GET /api/v1/staging?jobId=... until status is "done" or "failed"
const poll = await fetch(
  'https://relto.app/api/v1/staging?jobId=' + data.jobId,
  { headers: { 'Authorization': 'Bearer rlt_live_YOUR_KEY' } }
);
const { data: job } = await poll.json();
// job.status: "queued" | "processing" | "done" | "failed"
// job.resultUrl: present when status === "done"

OpenAPI 3.1 specification available at /api/v1/openapi for client generation.

API Capabilities

RESTful JSON API

Standard REST endpoints with JSON request/response. OpenAPI 3.0 spec included for auto-generated clients.

Webhook Callbacks

Get notified when staging completes. No polling needed. Your system receives the staged image URL automatically.

API Key Authentication

Secure API key auth with scoped permissions. Rotate keys without downtime. Rate limiting per key.

Webhook Delivery

Submit a photo and receive the staged result by webhook when it finishes. The API is in early access; response times are agreed per contract.

Batch Processing

Submit up to 50 images per batch request. Process entire listings in a single API call.

Custom SLA

Uptime and support commitments defined in your enterprise agreement.

Integration Scenarios

The API fits anywhere photos become listings.

CRM Integration

Auto-stage photos when a new listing is created in Follow Up Boss, kvCORE, Chime, or your custom CRM.

Examples: Follow Up Boss, kvCORE, Chime, LionDesk

MLS Systems

Stage listing photos before MLS upload. Ensure compliance with automatic watermarking.

Examples: Bright MLS, CRMLS, Stellar MLS, custom IDX

Property Management Software

Auto-stage units when they become vacant. Reduce time-to-listing for turnovers.

Examples: AppFolio, Buildium, Yardi, RentManager

Website & App Builders

Add 'Stage This Room' functionality to your real estate platform or marketplace.

Examples: Custom React/Next.js apps, WordPress plugins, mobile apps

API FAQ

What kind of API does RELTO offer?

RELTO provides a RESTful JSON API with webhook callbacks. Submit a photo and style, then poll for the result or receive a webhook when the staged image is ready. Authentication is via API key. Full OpenAPI spec provided.

Can I integrate RELTO staging into my CRM or MLS system?

Yes. The API is designed for PropTech integrations: CRMs, MLS systems, property management platforms, and real estate websites. Webhooks notify your system when staging is complete.

Can staged images carry my brand?

Custom branding options are available on enterprise plans. Tell us what your integration needs and we will confirm what applies to it.

What are the API rate limits?

Enterprise API plans include per-key rate limits sized to your expected volume. Contact us for high-volume integrations.

Do you provide SDKs or client libraries?

We provide documented REST endpoints with JavaScript and cURL examples, plus an OpenAPI spec for generating clients. The API uses standard REST conventions, so integration is straightforward in any language.

How is API pricing structured?

API pricing is per-image with volume discounts. Enterprise API plans start with committed monthly volumes for the best per-image rates. Contact us for pricing based on your expected volume.

Get API Access

Tell us about your integration and expected volume. We'll provide API credentials, documentation, and dedicated integration support.

Request API Access