Analyze Multiple Images for Stageability
curl --request POST \
--url https://api.example.com/analysis/stageability/multiple \
--header 'Content-Type: application/json' \
--data '
{
"imageUrls": [
"<string>"
]
}
'import requests
url = "https://api.example.com/analysis/stageability/multiple"
payload = { "imageUrls": ["<string>"] }
headers = {"Content-Type": "application/json"}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {'Content-Type': 'application/json'},
body: JSON.stringify({imageUrls: ['<string>']})
};
fetch('https://api.example.com/analysis/stageability/multiple', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.example.com/analysis/stageability/multiple",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'imageUrls' => [
'<string>'
]
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.example.com/analysis/stageability/multiple"
payload := strings.NewReader("{\n \"imageUrls\": [\n \"<string>\"\n ]\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.example.com/analysis/stageability/multiple")
.header("Content-Type", "application/json")
.body("{\n \"imageUrls\": [\n \"<string>\"\n ]\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.example.com/analysis/stageability/multiple")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Content-Type"] = 'application/json'
request.body = "{\n \"imageUrls\": [\n \"<string>\"\n ]\n}"
response = http.request(request)
puts response.read_body{
"statusCode": 400,
"message": "No images provided or more than 10 images",
"error": "Bad Request"
}
{
"statusCode": 401,
"message": "Unauthorized - Invalid or missing authentication token",
"error": "Unauthorized"
}
Analysis
Analyze Multiple Images for Stageability
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>"
]
}
'import requests
url = "https://api.example.com/analysis/stageability/multiple"
payload = { "imageUrls": ["<string>"] }
headers = {"Content-Type": "application/json"}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {'Content-Type': 'application/json'},
body: JSON.stringify({imageUrls: ['<string>']})
};
fetch('https://api.example.com/analysis/stageability/multiple', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.example.com/analysis/stageability/multiple",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'imageUrls' => [
'<string>'
]
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.example.com/analysis/stageability/multiple"
payload := strings.NewReader("{\n \"imageUrls\": [\n \"<string>\"\n ]\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.example.com/analysis/stageability/multiple")
.header("Content-Type", "application/json")
.body("{\n \"imageUrls\": [\n \"<string>\"\n ]\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.example.com/analysis/stageability/multiple")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Content-Type"] = 'application/json'
request.body = "{\n \"imageUrls\": [\n \"<string>\"\n ]\n}"
response = http.request(request)
puts response.read_body{
"statusCode": 400,
"message": "No images provided or more than 10 images",
"error": "Bad Request"
}
{
"statusCode": 401,
"message": "Unauthorized - Invalid or missing authentication token",
"error": "Unauthorized"
}
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
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
array
Array of individual image analysis results.
Show Image Object Properties
Show Image Object Properties
Summary Object
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"
}
{
"statusCode": 401,
"message": "Unauthorized - Invalid or missing authentication token",
"error": "Unauthorized"
}
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