PropertyPixel Docs

List edit options

GET
/edit-options

List every edit PropertyPixel can make, with the exact keys to pass to other tools: enhancement types for enhance_photos (combinable, e.g. blue_skies + improve_lighting), design styles and variation limits for stage_photos, room types, Photo to Video settings for create_video (1–9 photos; one makes a clip, several make a Listing Tour), the Ultra HD add-on, and credit prices. Call this when the user asks what you can do, or before choosing keys you are unsure of.

Works with view-only access.

Authorization

headerAuthorizationBearer <token>

An API key from Settings → Developers (pp_live_…), or an OAuth access token.

Response Body

List edit options

application/json
  1. response
object*string
enhancement_types*array<>

Edits for enhance_photos. Combine several in one request; the price is per photo, not per type.

design_styles*array<>

Furniture styles for stage_photos.

room_types*array<>

Room labels; staging furnishes the room as this type.

staging*
video*
ultra_hd*
credit_costs*

Credits per unit. 100 credits = one standard photo enhancement.

curl -X GET "https://example.com/edit-options"
{  "object": "edit_options",  "enhancement_types": [    {      "key": "string",      "label": "string",      "description": "string",      "preview_url": "http://example.com"    }  ],  "design_styles": [    {      "key": "string",      "label": "string",      "description": "string",      "preview_url": "http://example.com"    }  ],  "room_types": [    {      "key": "string",      "label": "string"    }  ],  "staging": {    "min_variations": 0,    "max_variations": 0,    "default_variations": 0  },  "video": {    "min_photos": 0,    "max_photos": 0,    "clip_seconds": [      0    ],    "default_clip_seconds": 0,    "aspect_ratios": [      "string"    ],    "default_aspect_ratio": "string",    "crossfade_seconds": 0  },  "ultra_hd": {    "description": "string",    "credits_per_photo": 0  },  "credit_costs": {    "enhancement_per_photo": 0,    "ultra_hd_per_photo": 0,    "staging_per_variation": 0,    "video_per_photo": 0,    "recommendation_apply_per_photo": 0,    "recommendations": 0  }}