Skip to content
Pictastic.ai
Start for freeLog in

API v1 · MLS

Virtual staging API for MLS listings

Get listing photos MLS-ready in one pipeline: stage the empty room, then upscale the result to 2× or 4× so it clears your MLS's resolution requirements before it is uploaded.

Get your API keyRead the full docs

Stage at 1 credit · upscale at 3 credits

bash
# Your key, from the API dashboard. Never commit it.
export PICTASTIC_API_KEY="sk_live_..."

# 1. Stage the empty room (1 credit)
curl -X POST "https://app.pictastic.ai/api/v1/virtual-staging" \
  -H "Authorization: Bearer $PICTASTIC_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "imageUrl": "<publicUrl>", "roomType": "Living Room", "designStyle": "Modern" }'

# 2. Upload the staged result, then upscale it to MLS resolution (3 credits)
curl -X POST "https://app.pictastic.ai/api/v1/upscale" \
  -H "Authorization: Bearer $PICTASTIC_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "imageUrl": "<stagedPublicUrl>", "scaleFactor": 4 }'
# → a furnished, MLS-resolution photo ready to upload

Overview

How does a virtual staging API help with MLS listings?

A virtual staging API helps MLS listings by furnishing empty rooms and enlarging the result to the resolution most MLSs require, all through HTTP calls. Pictastic stages an empty room and upscales the finished photo 2× or 4× in the same pipeline, so a listing photo is furnished and correctly sized before it is uploaded.

How it works

Upload, call, collect

Image inputs live on Pictastic storage, so every job starts with a free presigned upload.

  1. 1

    Get a presigned upload URL

    Ask for as many slots as you need, then PUT your image bytes straight to storage. This call is free — no credits.

  2. 2

    Call the endpoint you want

    Pass the returned publicUrl as imageUrl. Staging, removal and upscaling all take the same input shape.

  3. 3

    Read the output URL

    The response carries outputImageUrl and a downloadUrl, plus a jobId you can re-fetch later from the jobs history.

Open the API dashboard

Why developers pick it

Built for listing-ready output

What a listing team evaluates before staging for the MLS, stated as capabilities.

Stage and size in one pipeline

Furnish the empty room, then upscale the result 2× or 4× — both endpoints in the same API, so the photo is listing-ready without a separate tool.

Meet resolution rules

Many MLSs set a minimum image resolution; the upscale endpoint raises a finished photo to clear it before upload.

Disclosure stays in your hands

The API returns the staged image; you add the virtual-staging disclosure your MLS requires. It never alters your listing on your behalf.

1 + 3 credits, refunded on failure

Staging and upscaling each bill per success from a shared balance, and any failed job is refunded automatically.

Part of one API

MLS listing prep runs on the virtual staging API

Staging, furniture removal and upscaling are all the same REST API — one key, one input shape, one credit balance. See the full API overview, or jump to a specific operation.

Explore the virtual staging API
Furniture removal APIClear an occupied room back to empty walls, ready to restage.Photo upscaling APIEnlarge a finished photo 2× or 4× to meet MLS resolution.Bulk virtual staging APIStage a whole gallery in a loop your software controls.

Virtual staging API for MLS FAQ

How does a virtual staging API help with MLS listings?

A virtual staging API helps MLS listings by furnishing empty rooms and enlarging the result to the resolution most MLSs require, all through HTTP calls. Pictastic stages an empty room and upscales the finished photo 2× or 4× in the same pipeline, so a listing photo is furnished and correctly sized before it is uploaded.

Does the API make my listing MLS-compliant automatically?

No — and no tool honestly can. Most MLSs require virtually staged photos to be disclosed and set their own resolution rules. The API furnishes and upscales the image; adding the required disclosure and following your MLS's rules is the listing team's responsibility.

How do I meet my MLS's minimum resolution?

Stage the photo, then pass the result to the upscale endpoint with scaleFactor 2 or 4 to enlarge it. Check your MLS's required dimensions and choose the factor that clears them.

What does staging plus upscaling cost per photo?

Staging is 1 credit and upscaling is 3 credits per successful image, from one shared balance, with free uploads and automatic refunds on failure.

Get MLS-ready photos by API today

Create a key in the dashboard and stage-then-upscale your first listing photo in minutes.

Get your API key

Presigned uploads are free — you only spend credits on finished images.