Skip to main content
POST
/
analysis
/
stageability
/
multiple
Analyze Multiple Images for Stageability
curl --request POST \
  --url https://api.example.com/analysis/stageability/multiple \
  --header 'Content-Type: application/json' \
  --data '
{
  "imageUrls": [
    "<string>"
  ]
}
'
{
  "statusCode": 400,
  "message": "No images provided or more than 10 images",
  "error": "Bad Request"
}

​
Overview

Analyzes multiple images (up to 10) to determine if they are suitable for virtual staging. This endpoint provides detailed analysis for each image including room type detection, confidence scores, and a comprehensive summary of all analyzed images.

​
Authentication

This endpoint requires Bearer token authentication. Include your API key in the Authorization header.

​
Request Body

​
imageUrls
string[]
required
Array of image URLs to analyze. Maximum of 10 images per request.

​
Response

The response includes detailed analysis for each image and an overall summary.

​
Image Analysis Object

​
images
array
Array of individual image analysis results.

​
Summary Object

​
summary
object
Overall summary of the batch analysis.

​
Example Request

curl -X 'POST' \
  'http://localhost:3001/analysis/stageability/multiple' \
  -H 'accept: application/json' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
  "imageUrls": [
    "https://example.com/image1.jpg"
  ]
}'

​
Example Response

{
  "images": [
    {
      "isStageable": true,
      "roomType": "living_room",
      "confidence": 0.95,
      "details": "Clear room with good lighting",
      "imageUrl": "https://example.com/image1.jpg"
    }
  ],
  "summary": {
    "totalImages": 5,
    "stageableImages": 3,
    "nonStageableImages": 2,
    "confidence": 0.87,
    "roomTypes": [
      "living_room",
      "bedroom",
      "kitchen"
    ]
  }
}

​
Error Responses

{
  "statusCode": 400,
  "message": "No images provided or more than 10 images",
  "error": "Bad Request"
}

​
Use Cases

  • Batch Image Validation: Quickly validate multiple property images before processing
  • Quality Control: Ensure images meet staging requirements
  • Room Classification: Automatically categorize images by room type
  • Workflow Optimization: Filter out unsuitable images early in the pipeline