{"openapi":"3.1.0","info":{"title":"Festoonify","version":"0.1.0","description":"Turn a photo of any space into Christmas decorating ideas with shoppable product links. By Hatzhold LLC. Some links are affiliate links."},"servers":[{"url":"https://festoonify.com"}],"paths":{"/api/ideas":{"post":{"operationId":"getChristmasDecorIdeas","summary":"Get 3 Christmas decorating looks for a space, with product links","description":"Send the user's photo (openaiFileIdRefs, image_url or image_base64) and/or a description of the space. Returns looks with palettes, steps, products, a private preview_url and a share_url. Always show product links, and always give the user the preview_url: it opens their own photo decorated with each look (previews only exist on the site). share_url is for sharing with others. This API has no sign-in and uses shared daily limits; the MCP connector (https://mcp.festoonify.com) signs people in so their free photos and Season Pass apply.","x-openai-isConsequential":false,"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"openaiFileIdRefs":{"type":"array","description":"Photo the user uploaded in ChatGPT.","items":{"type":"string"}},"image_url":{"type":"string","description":"Public https URL of a photo of the space."},"image_base64":{"type":"string","description":"Base64 image or data: URL."},"room_description":{"type":"string"},"style":{"type":"string","description":"One of: Classic, Cozy Cabin, Modern Minimal, Nordic, Farmhouse, Whimsical, Glam, Vintage"},"budget_usd":{"type":"number","description":"Total budget in US dollars, e.g. 100"},"budget":{"type":"string","description":"Budget in words, e.g. Under $50, $50 to $150, $150 to $400, Go big"},"notes":{"type":"string"},"holiday":{"type":"string","enum":["halloween","thanksgiving","hanukkah","christmas","after-christmas","new-years-eve","valentines-day","st-patricks-day","easter","fourth-of-july","dia-de-los-muertos","diwali","kwanzaa","lunar-new-year","eid-al-fitr","eid-al-adha","passover","spring","summer","fall","winter","ramadan","mardi-gras","graduation","birthday","baby-shower","bridal-shower","any"],"description":"Holiday to decorate for; defaults to the next one coming up. \"any\" for parties."},"mode":{"type":"string","enum":["indoor","outdoor"],"description":"outdoor for porches, rooflines and yards."},"already_own":{"type":"string","description":"Decorations the user already owns, comma separated."}}}}}},"responses":{"200":{"description":"Decorating ideas","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"share_url":{"type":"string"},"preview_url":{"type":"string","description":"Private link that opens the space as its owner, with previews of each look."},"photo_url":{"type":["string","null"]},"room":{"type":"object"},"ideas":{"type":"array","items":{"type":"object","properties":{"title":{"type":"string"},"vibe":{"type":"string"},"description":{"type":"string"},"palette":{"type":"array","items":{"type":"string"}},"difficulty":{"type":"string"},"estimated_budget":{"type":"string"},"steps":{"type":"array","items":{"type":"string"}},"products":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"},"why":{"type":"string"},"search_query":{"type":"string"},"est_price":{"type":["number","null"],"description":"Estimated price in USD"},"priority":{"type":"string","enum":["essential","nice"]},"links":{"type":"array","items":{"type":"object","properties":{"retailer":{"type":"string"},"label":{"type":"string"},"url":{"type":"string"},"kind":{"type":"string","enum":["product","search"]},"affiliate":{"type":"boolean"}}}}}}}}}},"disclosure":{"type":"string"}}}}}}}}},"/api/products":{"get":{"operationId":"findChristmasDecorProducts","summary":"Shopping links (and Etsy listings when available) for one decor item","parameters":[{"name":"q","in":"query","required":true,"schema":{"type":"string"},"description":"What to shop for"}],"responses":{"200":{"description":"Links","content":{"application/json":{"schema":{"type":"object","properties":{"query":{"type":"string"},"links":{"type":"array","items":{"type":"object","properties":{"retailer":{"type":"string"},"label":{"type":"string"},"url":{"type":"string"},"kind":{"type":"string","enum":["product","search"]},"affiliate":{"type":"boolean"}}}},"etsy_listings":{"type":"array","items":{"type":"object"}},"disclosure":{"type":"string"}}}}}}}}}}}