{
  "openapi": "3.0.1",
  "info": {
    "title": "AI Home Tour Creator",
    "description": "Transform property photos into professional real estate video tours. AI analyzes, scores, selects, and enhances images before generating cinematic video clips and merging them into a complete property tour. Ideal for real estate agents, agencies, and property marketers.",
    "version": "0.0",
    "x-build-id": "olUDhDPK9lH4faTIF"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/peaceful_pushpins~ai-home-tour-creator/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-peaceful_pushpins-ai-home-tour-creator",
        "x-openai-isConsequential": false,
        "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.",
        "tags": [
          "Run Actor"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/inputSchema"
              }
            }
          }
        },
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Enter your Apify token here"
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/acts/peaceful_pushpins~ai-home-tour-creator/runs": {
      "post": {
        "operationId": "runs-sync-peaceful_pushpins-ai-home-tour-creator",
        "x-openai-isConsequential": false,
        "summary": "Executes an Actor and returns information about the initiated run in response.",
        "tags": [
          "Run Actor"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/inputSchema"
              }
            }
          }
        },
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Enter your Apify token here"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/runsResponseSchema"
                }
              }
            }
          }
        }
      }
    },
    "/acts/peaceful_pushpins~ai-home-tour-creator/run-sync": {
      "post": {
        "operationId": "run-sync-peaceful_pushpins-ai-home-tour-creator",
        "x-openai-isConsequential": false,
        "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.",
        "tags": [
          "Run Actor"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/inputSchema"
              }
            }
          }
        },
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Enter your Apify token here"
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    }
  },
  "components": {
    "schemas": {
      "inputSchema": {
        "type": "object",
        "properties": {
          "imageZipFile": {
            "title": "Upload Images ZIP Archive",
            "type": "string",
            "description": "Upload a ZIP file containing 6–18 property images (JPEG/PNG). The AI will analyze, enhance, and generate a virtual tour video.",
            "default": "https://api.apify.com/v2/key-value-stores/eMCiOHDBvbCdVhBy4/records/HouseImages-01.zip"
          },
          "noOfImages": {
            "title": "Select number of images you want to edit",
            "minimum": 3,
            "maximum": 18,
            "type": "integer",
            "description": "Choose a number between 3 and 18. The AI will select the best images based on quality and relevance to the property type. If you select a specific number, the AI will prioritize selecting that many images for editing and inclusion in the virtual tour video.",
            "default": 3
          },
          "propertyType": {
            "title": "Property Type",
            "enum": [
              "Apartment",
              "House",
              "Villa",
              "Office",
              "Commercial Property"
            ],
            "type": "string",
            "description": "Select the type of property you want to create a virtual tour for.",
            "default": "House"
          },
          "transformationLevel": {
            "title": "Transformation Level",
            "enum": [
              "Light Touch",
              "Moderate",
              "Complete Makeover"
            ],
            "type": "string",
            "description": "Select the level of transformation you want the AI to apply to the images.",
            "default": "Moderate"
          },
          "allowedEdits": {
            "title": "AI Editing Options",
            "type": "array",
            "description": "Select one or more editing options. If empty, AI will choose the best edits based on the uploaded images and property type. If empty, AI will automatically apply the most suitable enhancements based on the property type and image quality.",
            "items": {
              "type": "string",
              "enum": [
                "Enhance Image Quality",
                "Remove Clutter",
                "Remove Unwanted Objects",
                "Replace Furniture",
                "Change Wall Colors",
                "Improve Lighting",
                "Virtual Staging",
                "Improve Landscaping"
              ]
            },
            "default": [
              "Remove Clutter"
            ]
          },
          "highlightAreas": {
            "title": "Highlight Priority Areas",
            "type": "array",
            "description": "Select the areas of the property you want the AI to prioritize when creating the virtual tour. If empty, AI will determine the best areas to highlight based on the uploaded images and property type.",
            "items": {
              "type": "string",
              "enum": [
                "Living Room",
                "Kitchen",
                "Bedrooms",
                "Bathrooms",
                "Exterior",
                "Garden",
                "Balcony"
              ]
            },
            "default": [
              "Living Room",
              "Kitchen",
              "Exterior"
            ]
          },
          "targetAudience": {
            "title": "Target Buyer",
            "enum": [
              "Families",
              "Young Professionals",
              "Luxury Buyers",
              "Investors",
              "Vacation Rental Guests"
            ],
            "type": "string",
            "description": "Select the target buyer for your property. This will help the AI tailor the virtual tour to appeal to the selected audience.",
            "default": "Investors"
          },
          "propertyGoal": {
            "title": "Property Goal",
            "enum": [
              "Sell Fast",
              "Luxury Marketing",
              "Rental Listing",
              "Airbnb Listing"
            ],
            "type": "string",
            "description": "Select the primary goal for your property. This will help the AI focus on the most important aspects of the virtual tour to achieve your desired outcome.",
            "default": "Sell Fast"
          },
          "customInstructions": {
            "title": "Additional Instructions",
            "maxLength": 500,
            "type": "string",
            "description": "Provide any specific instructions or preferences for the AI to consider when creating the virtual tour. This can include details about the property's unique features, desired style, or any specific elements you want to highlight or avoid.",
            "default": "Please focus on highlighting the spacious living room and modern kitchen. Avoid making significant changes to the exterior of the property."
          },
          "generateAIVideo": {
            "title": "Generate AI Video Tour",
            "type": "boolean",
            "description": "Generate AI video clips according to video style for the selected property images. Additional charges apply per generated image.",
            "default": true
          },
          "videoGenerationModel": {
            "title": "AI Video Quality",
            "enum": [
              "Standard",
              "Luxury"
            ],
            "type": "string",
            "description": "Choose the AI model for generating cinematic real-estate video clips.",
            "default": "Standard"
          },
          "videoStyle": {
            "title": "Video Style",
            "enum": [
              "Luxury Real Estate",
              "Cinematic",
              "Modern Showcase",
              "Drone Style",
              "Social Media Reel"
            ],
            "type": "string",
            "description": "Select the style of the virtual tour video. This will influence the overall look and feel of the video, including transitions, music, and pacing.",
            "default": "Luxury Real Estate"
          },
          "aspectRatio": {
            "title": "Aspect Ratio",
            "enum": [
              "9:16",
              "16:9"
            ],
            "type": "string",
            "description": "Select the aspect ratio for video generation",
            "default": "9:16"
          },
          "aiSummary": {
            "title": "AI Summary Report",
            "type": "boolean",
            "description": "If selected, it generates a lightweight summary of image selection, edits applied, and video structure. May increase processing time. Additional charges apply",
            "default": true
          }
        }
      },
      "runsResponseSchema": {
        "type": "object",
        "properties": {
          "data": {
            "type": "object",
            "properties": {
              "id": {
                "type": "string"
              },
              "actId": {
                "type": "string"
              },
              "userId": {
                "type": "string"
              },
              "startedAt": {
                "type": "string",
                "format": "date-time",
                "example": "2025-01-08T00:00:00.000Z"
              },
              "finishedAt": {
                "type": "string",
                "format": "date-time",
                "example": "2025-01-08T00:00:00.000Z"
              },
              "status": {
                "type": "string",
                "example": "READY"
              },
              "meta": {
                "type": "object",
                "properties": {
                  "origin": {
                    "type": "string",
                    "example": "API"
                  },
                  "userAgent": {
                    "type": "string"
                  }
                }
              },
              "stats": {
                "type": "object",
                "properties": {
                  "inputBodyLen": {
                    "type": "integer",
                    "example": 2000
                  },
                  "rebootCount": {
                    "type": "integer",
                    "example": 0
                  },
                  "restartCount": {
                    "type": "integer",
                    "example": 0
                  },
                  "resurrectCount": {
                    "type": "integer",
                    "example": 0
                  },
                  "computeUnits": {
                    "type": "integer",
                    "example": 0
                  }
                }
              },
              "options": {
                "type": "object",
                "properties": {
                  "build": {
                    "type": "string",
                    "example": "latest"
                  },
                  "timeoutSecs": {
                    "type": "integer",
                    "example": 300
                  },
                  "memoryMbytes": {
                    "type": "integer",
                    "example": 1024
                  },
                  "diskMbytes": {
                    "type": "integer",
                    "example": 2048
                  }
                }
              },
              "buildId": {
                "type": "string"
              },
              "defaultKeyValueStoreId": {
                "type": "string"
              },
              "defaultDatasetId": {
                "type": "string"
              },
              "defaultRequestQueueId": {
                "type": "string"
              },
              "buildNumber": {
                "type": "string",
                "example": "1.0.0"
              },
              "containerUrl": {
                "type": "string"
              },
              "usage": {
                "type": "object",
                "properties": {
                  "ACTOR_COMPUTE_UNITS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_WRITES": {
                    "type": "integer",
                    "example": 1
                  },
                  "KEY_VALUE_STORE_LISTS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_INTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_EXTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_SERPS": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_UNBLOCKER_UNITS": {
                    "type": "integer",
                    "example": 0
                  }
                }
              },
              "usageTotalUsd": {
                "type": "number",
                "example": 0.00005
              },
              "usageUsd": {
                "type": "object",
                "properties": {
                  "ACTOR_COMPUTE_UNITS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_WRITES": {
                    "type": "number",
                    "example": 0.00005
                  },
                  "KEY_VALUE_STORE_LISTS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_INTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_EXTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_SERPS": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_UNBLOCKER_UNITS": {
                    "type": "integer",
                    "example": 0
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}