Business & workflow

Dropbox automation or an editing API? How media companies automate real estate photo editing

There are three ways to get a shoot to an editor: by hand, through a watched Dropbox folder, or from your own software through an API. Here's how to choose, and why many media companies end up using two.

Published 6 min read

Aerial view of a large house with a deck, surrounded by autumn trees in red, orange and green
On this page

Once a real estate media company decides to automate photo editing, the next question is how shoots should reach the editor. The answer depends less on the editing and more on your team: where photographers already put their files, whether you have a developer, and where finished photos need to end up.

This guide compares the two automated routes Stager AI offers, a watched Dropbox folder and the editing API, with the web app as the baseline.

Three ways a shoot reaches the editor

Web appDropbox auto-importEditing API
Who sets it upNobodyAn operations lead, onceA developer
What starts the editSomeone uploads and clicksA finished upload to the watched folderYour software, per batch
Where settings liveChosen in the sidebar, remembered per personSaved on the Dropbox connectionSent with each request
Where results goThe Stager AI projectThe Stager AI projectYour system, with a signed webhook per photo
Best forOccasional or one-off shootsTeams that already use DropboxPlatforms with their own ordering and delivery
How the three routes compare.

Dropbox auto-import: automation without a developer

With Dropbox auto-import, you connect a Dropbox account once, choose the folder to watch and save your HDR settings. From then on, a photographer uploading a shoot is all it takes: 10 minutes after the last file lands, the shoot becomes a project and is edited.

  • Fits how photographers already work. They keep uploading to Dropbox, and nobody moves files.
  • Team folders are supported, with either one subfolder per shoot or your own structure with a tag on the folders to edit.
  • Controls for volume: a daily file limit with approval, pause and cancel.
  • Read-only access. Edited photos appear in your Stager AI project, ready to review and deliver. Nothing is written back to Dropbox.

The limitation is the end of the workflow: someone still reviews and delivers from the Stager AI project. For many teams that's exactly where they want a person anyway. The full team setup is in our Dropbox workflow for real estate photography teams.

The editing API: editing inside your own platform

If your company runs its own booking, ordering or delivery system, the real estate photo editing API lets that system send shoots and receive the results without anyone opening Stager AI. A whole shoot takes four calls:

  1. 1Create a batch for the shoot, with your own job ID attached.
  2. 2Upload every photo using signed upload URLs.
  3. 3Start processing. Brackets are grouped into scenes automatically.
  4. 4Receive a webhook for every finished or failed photo, signed with HMAC-SHA256 so you can check it really came from us. You can also check the batch status at any time.
A shoot through the API
  1. 1. Create a project for the listing
    POST /api/projects{ "title": "12 Harbour View" }
  2. 2. Create the batch, with your job ID
    POST /api/hdr-batch{ "projectId": "project_uuid", "perspectiveCorrection": true, "clientReferenceId": "JOB-2041" }
  3. 3. Get a signed upload URL per photo
    POST /api/hdr-batch/:batchId/url
  4. 4. Start processing
    POST /api/hdr-batch/:batchId/enhance
  5. 5. Webhook: a photo is finished
    POST https://your-app.com/webhooks/stagerX-Stager-Signature: sha256=… { "eventType": "hdr.image.completed", … }
Press Run to send the calls in order. The last one is the signed webhook your system receives for every finished photo.

The API uses the same settings as the app: editing style, lens and perspective correction, photographer removal, fire, TV blackout, privacy and blurLicensePlates, set per batch. Your internal job ID comes back in every status check, so matching jobs to orders is simple. Every plan includes API access: generate a key and add your webhook URL in the API Access section of your account page, then read the API documentation.

How to choose

Four questions usually settle it:

  • Where do shoots go today? If the answer is Dropbox, start with auto-import. It's free to connect and takes minutes.
  • Do you have a developer, in-house or contracted? The API needs someone to build and maintain the integration.
  • Where should finished photos end up? If they need to appear in your own client gallery or system automatically, that's the API's job.
  • Who signs off a gallery? If a person reviews every delivery anyway, Dropbox plus a review step in Stager AI is often enough.

Which route fits your team?

0/4

Answer four quick questions and get a recommendation.

  1. 1.Where do your shoots go today?

  2. 2.Do you have a developer, in-house or contracted?

  3. 3.Should finished photos arrive in your own system automatically?

  4. 4.Who signs off a gallery?

Why many teams use both

The routes aren't exclusive. A common setup is Dropbox for photographers in the field and the API for orders that come through the company's platform, for example re-edits or shoots delivered by partners. As long as both use the same editing style, the result looks the same: save it on the Dropbox connection and send editingStyle with every API request. We explain why that matters in how to keep one editing style across every photographer.

Whichever route you choose, keep a quality check before delivery. Our real estate photo QA checklist lists what to look at, and AI QA scores every finished photo so you know where to look first.

Access and security

Automation means another system touching your files and your clients' photos, so it's worth knowing what each route can see and do.

  • Dropbox: Stager AI asks for read-only access and only processes files uploaded to the watched folder after you choose it. It never writes, moves or deletes anything in your Dropbox.
  • API: every request uses your stager-api-key header. Keep the key on your server, never in an app or a web page.
  • Webhooks: each event is signed with HMAC-SHA256. Verify the signature before you act on an event, so nobody else can mark a job as finished in your system.

Rolling it out

Whichever route you pick, start small and widen it once the first shoots look right.

Dropbox auto-import

  1. 1Connect a company Dropbox account and choose the folder.
  2. 2Save the editing style and HDR settings, and set a daily file limit.
  3. 3Run one test shoot end to end, from upload to delivery.
  4. 4Add one or two photographers for a week, then the rest of the team.

Editing API

  1. 1Generate an API key and set your webhook URL on your account page.
  2. 2Build the four calls and the webhook endpoint, with your own job IDs attached.
  3. 3Send a few real shoots and compare them with the same shoots edited in the web app.
  4. 4Switch your platform over for one client or one region first, then everywhere.

What it costs

Connecting Dropbox is free. Each edited photo uses 1 photo credit, whichever route it comes through, and a bracket set of 3, 5 or 7 exposures counts as one photo. Plans start at 10 photos a month and unused photos roll over. Every plan includes API access. For volume discounts, talk to us about your shoots.

Frequently asked questions

For most teams, a watched Dropbox folder. You connect Dropbox once, choose a folder and save your settings, and each uploaded shoot is edited automatically 10 minutes after its last file arrives. No developer is needed.

When shoots come through your own booking or delivery software, or when finished photos need to arrive in your system automatically. The API sends a signed webhook for every finished or failed photo.

Yes. Many teams use Dropbox for photographers and the API for orders from their platform. Save the editing style on the Dropbox connection and send the same editingStyle with each API request, and the results look the same.

Every plan includes API access. Generate a key in the API Access section of your account page, and add a webhook URL if you want an event for every finished photo. For volume discounts, message us in the chat.

No. Access is read-only, so edited photos appear in your Stager AI project, where you can review, download or deliver them.

Try Stager AI

Edit your next listing with Stager AI

HDR edits for photographers and media companies in about 1 to 5 minutes. Staging and retouching for agents in seconds. Your first renders are on us.

Try it freeSee pricingNo credit card required