# Travel Getaway Promotional Story Template (video template)
> Promote your travel agency's special offers and holiday deals with this elegant, easy-to-use social media story template.
## Overview
- **Page**: https://shotstack.io/studio/templates/travel-getaway-promo-story-template-offer-v2/
- **Output**: MP4, 1080x1920 (9:16), 25 fps
- **Length**: 8.2s
- **Timeline**: 28 clips on 19 tracks; assets: audio, image, luma, rich-text, svg, video
- **Render endpoint (sandbox, free, watermarked)**: POST https://api.shotstack.io/edit/stage/render with header `x-api-key`
- **Production**: same request against https://api.shotstack.io/edit/v1/render with a v1 key
- **Preview in the browser (no account)**: https://shotstack.studio/#json=eyJ0aW1lbGluZSI6eyJmb250cyI6W3sic3JjIjoiaHR0cHM6Ly90ZW1wbGF0ZXMuc2hvdHN0YWNrLmlvL3RyYXZlbC1nZXRhd2F5LXByb21vLXN0b3J5LXRlbXBsYXRlLW9mZmVyL2E2YWRiYWM1LTdjMjktNDRkOC1iODdjLWU0ZTY3NDc1ZjY5Ni9zb3VyY2Uub3RmIn0seyJzcmMiOiJodHRwczovL3RlbXBsYXRlcy5zaG90c3RhY2suaW8vdHJhdmVsLWdldGF3YXktcHJvbW8tc3RvcnktdGVtcGxhdGUtb2ZmZXIvNzY3OTY3YzMtNjAxZS00MmJmLTg4ZjUtMGFmZmEwY2MzOGIyL3NvdXJjZS5vdGYifV0sImJhY2tncm91bmQiOiIjRkZGRkZGIiwidHJhY2tzIjpbeyJjbGlwcyI6W3sibGVuZ3RoIjoiZW5kIiwiYXNzZXQiOnsidHlwZSI6ImF1ZGlvIiwic3JjIjoie3sgQVVESU8gfX0iLCJ2b2x1bWUiOjF9LCJzdGFydCI6MH1dfSx7ImNsaXBzIjpbeyJsZW5ndGgiOiJlbmQiLCJhc3NldCI6eyJ0eXBlIjoiaW1hZ2UiLCJzcmMiOiJ7eyBJTUFHRV82IH19In0sInN0YXJ0IjoxLCJzY2FsZSI6MSwib2Zmc2V0Ijp7IngiOjAuMzE0LCJ5IjotMC4yOTV9LCJwb3NpdGlvbiI6ImNlbnRlciIsInRyYW5zaXRpb24iOnsiaW4iOiJzbGlkZVVwIn0sImZpdCI6ImNvbnRhaW4iLCJ3aWR0aCI6MjAwLCJoZWlnaHQiOjIwMH0seyJhc3NldCI6eyJ0eXBlIjoibHVtYSIsInNyYyI6Imh0dHBzOi8vdGVtcGxhdGVzLnNob3RzdGFjay5pby90cmF2ZWwtZ2V0YXdheS1wcm9tby1zdG9yeS10ZW1wbGF0ZS1vZmZlci84YjNhNTEwNS05MGQ2LTRmYTQtODQzMi0zYzE2YjljMzU2NGEvc291cmNlLnBuZyJ9LCJzdGFydCI6MSwibGVuZ3RoIjo3LjIzfV19LHsiY2xpcHMiOlt7Imxlbmd0aCI6ImVuZCIsImFzc2V0Ijp7InR5cGUiOiJpbWFnZSIsInNyYyI6Int7IElNQUdFXzMgfX0ifSwic3RhcnQiOjEsInNjYWxlIjoxLCJvZmZzZXQiOnsieCI6LTAuMzE5LCJ5IjotMC4yOX0sInBvc2l0aW9uIjoiY2VudGVyIiwidHJhbnNpdGlvbiI6eyJpbiI6InNsaWRlVXAifSwiZml0IjoiY29udGFpbiIsIndpZHRoIjoyMDAsImhlaWdodCI6MjAwfSx7ImFzc2V0Ijp7InR5cGUiOiJsdW1hIiwic3JjIjoiaHR0cHM6Ly90ZW1wbGF0ZXMuc2hvdHN0YWNrLmlvL3RyYXZlbC1nZXRhd2F5LXByb21vLXN0b3J5LXRlbXBsYXRlLW9mZmVyLzRhNzQ5NWYxLWI1YjgtNDg0OC04ZmI0LTI4YmJmNjZhODRiYy9zb3VyY2UucG5nIn0sInN0YXJ0IjoxLCJsZW5ndGgiOjcuMjN9XX0seyJjbGlwcyI6W3sibGVuZ3RoIjoiZW5kIiwiYXNzZXQiOnsidHlwZSI6ImltYWdlIiwic3JjIjoie3sgSU1BR0VfNSB9fSJ9LCJzdGFydCI6MC44LCJzY2FsZSI6MSwib2Zmc2V0Ijp7IngiOjAuMzE0LCJ5IjotMC4xNjl9LCJwb3NpdGlvbiI6ImNlbnRlciIsInRyYW5zaXRpb24iOnsiaW4iOiJzbGlkZVVwIn0sImZpdCI6ImNvbnRhaW4iLCJ3aWR0aCI6MjAwLCJoZWlnaHQiOjIwMH0seyJhc3NldCI6eyJ0eXBlIjoibHVtYSIsInNyYyI6Imh0dHBzOi8vdGVtcGxhdGVzLnNob3RzdGFjay5pby90cmF2ZWwtZ2V0YXdheS1wcm9tby1zdG9yeS10ZW1wbGF0ZS1vZmZlci9kNDg3N2ZkYS1kYTA4LTQxZDktOTA0Yy02MDU1YzA2ZjE1NjUvc291cmNlLnBuZyJ9LCJzdGFydCI6MC44LCJsZW5ndGgiOjcuNDMwMDAwMDAwMDAwMDAxfV19LHsiY2xpcHMiOlt7Imxlbmd0aCI6ImVuZCIsImFzc2V0Ijp7InR5cGUiOiJpbWFnZSIsInNyYyI6Int7IElNQUdFXzIgfX0ifSwic3RhcnQiOjAuOCwic2NhbGUiOjEsIm9mZnNldCI6eyJ4IjotMC4zMTksInkiOi0wLjE3MX0sInBvc2l0aW9uIjoiY2VudGVyIiwidHJhbnNpdGlvbiI6eyJpbiI6InNsaWRlVXAifSwiZml0IjoiY29udGFpbiIsIndpZHRoIjoyMDAsImhlaWdodCI6MjAwfSx7ImFzc2V0Ijp7InR5cGUiOiJsdW1hIiwic3JjIjoiaHR0cHM6Ly90ZW1wbGF0ZXMuc2hvdHN0YWNrLmlvL3RyYXZlbC1nZXRhd2F5LXByb21vLXN0b3J5LXRlbXBsYXRlLW9mZmVyLzdjZmYyNTUxLWI5MWEtNGIzMS1iNmYzLTBmZmNiOTZmOGUzOC9zb3VyY2UucG5nIn0sInN0YXJ0IjowLjgsImxlbmd0aCI6Ny40MzAwMDAwMDAwMDAwMDF9XX0seyJjbGlwcyI6W3sibGVuZ3RoIjoiZW5kIiwiYXNzZXQiOnsidHlwZSI6ImltYWdlIiwic3JjIjoie3sgSU1BR0VfNCB9fSJ9LCJzdGFydCI6MC42LCJzY2FsZSI6MSwib2Zmc2V0Ijp7IngiOjAuMzEyNTE5MDEwMjIyOTA0NiwieSI6LTAuMDM1MTA0ODEwMjY1ODYzODF9LCJwb3NpdGlvbiI6ImNlbnRlciIsInRyYW5zaXRpb24iOnsiaW4iOiJzbGlkZVVwIn0sImZpdCI6ImNvbnRhaW4iLCJ3aWR0aCI6MjAwLCJoZWlnaHQiOjIwMH0seyJhc3NldCI6eyJ0eXBlIjoibHVtYSIsInNyYyI6Imh0dHBzOi8vdGVtcGxhdGVzLnNob3RzdGFjay5pby90cmF2ZWwtZ2V0YXdheS1wcm9tby1zdG9yeS10ZW1wbGF0ZS1vZmZlci83NTMzNmJkOS05NmNmLTQ4OTEtYmE0OS05YzFiMDE0OWMxY2Yvc291cmNlLnBuZyJ9LCJzdGFydCI6MC42LCJsZW5ndGgiOjcuNjMwMDAwMDAwMDAwMDAxfV19LHsiY2xpcHMiOlt7Imxlbmd0aCI6ImVuZCIsImFzc2V0Ijp7InR5cGUiOiJpbWFnZSIsInNyYyI6Int7IElNQUdFXzEgfX0ifSwic3RhcnQiOjAuNiwic2NhbGUiOjEsIm9mZnNldCI6eyJ4IjotMC4zMjI3MDM3MDM3MDM3MDM3NywieSI6LTAuMDUyMDgzMzMzMzMzMzMzMzd9LCJwb3NpdGlvbiI6ImNlbnRlciIsInRyYW5zaXRpb24iOnsiaW4iOiJzbGlkZVVwIn0sImZpdCI6ImNvbnRhaW4iLCJ3aWR0aCI6MjAwLCJoZWlnaHQiOjIwMH0seyJhc3NldCI6eyJ0eXBlIjoibHVtYSIsInNyYyI6Imh0dHBzOi8vdGVtcGxhdGVzLnNob3RzdGFjay5pby90cmF2ZWwtZ2V0YXdheS1wcm9tby1zdG9yeS10ZW1wbGF0ZS1vZmZlci85ZDFiZjc3ZC0wNjI5LTQ1MGYtOTQzNi1hZDRiZDhmM2U1NTYvc291cmNlLnBuZyJ9LCJzdGFydCI6MC42LCJsZW5ndGgiOjcuNjMwMDAwMDAwMDAwMDAxfV19LHsiY2xpcHMiOlt7ImFzc2V0Ijp7InR5cGUiOiJzdmciLCJzcmMiOiI8c3ZnIHZpZXdCb3g9XCIwIDAgNTAgNTBcIiB4bWxucz1cImh0dHA6Ly93d3cudzMub3JnLzIwMDAvc3ZnXCI-PHJlY3Qgd2lkdGg9XCI1MFwiIGhlaWdodD1cIjUwXCIgZmlsbD1cInt7IEZPTlRfQ09MT1JfMSB9fVwiLz48L3N2Zz4ifSwic3RhcnQiOjEuMjUsImxlbmd0aCI6ImVuZCIsIm9mZnNldCI6eyJ4IjowLjE4NSwieSI6LTAuNDQxfSwicG9zaXRpb24iOiJjZW50ZXIiLCJ0cmFuc2l0aW9uIjp7ImluIjoic2xpZGVSaWdodCJ9LCJ3aWR0aCI6NTAsImhlaWdodCI6NTB9LHsiYXNzZXQiOnsidHlwZSI6Imx1bWEiLCJzcmMiOiJodHRwczovL3RlbXBsYXRlcy5zaG90c3RhY2suaW8vdHJhdmVsLWdldGF3YXktcHJvbW8tc3RvcnktdGVtcGxhdGUtb2ZmZXIvNWEzZTc0ZGUtNDQ4ZC00M2ZlLWFjZDEtMzBjMzAwNGRjNWFjL3NvdXJjZS5wbmcifSwic3RhcnQiOjEuMjUsImxlbmd0aCI6Ni45OH1dfSx7ImNsaXBzIjpbeyJhc3NldCI6eyJ0eXBlIjoic3ZnIiwic3JjIjoiPHN2ZyB2aWV3Qm94PVwiMCAwIDUwIDUwXCIgeG1sbnM9XCJodHRwOi8vd3d3LnczLm9yZy8yMDAwL3N2Z1wiPjxyZWN0IHdpZHRoPVwiNTBcIiBoZWlnaHQ9XCI1MFwiIGZpbGw9XCJ7eyBGT05UX0NPTE9SXzEgfX1cIi8-PC9zdmc-In0sInN0YXJ0IjoxLjE1LCJsZW5ndGgiOiJlbmQiLCJvZmZzZXQiOnsieCI6LTAuMDg1LCJ5IjotMC40NDF9LCJwb3NpdGlvbiI6ImNlbnRlciIsInRyYW5zaXRpb24iOnsiaW4iOiJzbGlkZVJpZ2h0In0sIndpZHRoIjo1MCwiaGVpZ2h0Ijo1MH0seyJhc3NldCI6eyJ0eXBlIjoibHVtYSIsInNyYyI6Imh0dHBzOi8vdGVtcGxhdGVzLnNob3RzdGFjay5pby90cmF2ZWwtZ2V0YXdheS1wcm9tby1zdG9yeS10ZW1wbGF0ZS1vZmZlci8yM2MzYWZmYi01Y2ZjLTQyN2YtODgyZS1mZTgyZmU0Y2ZiMTUvc291cmNlLnBuZyJ9LCJzdGFydCI6MS4xNSwibGVuZ3RoIjo3LjA4fV19LHsiY2xpcHMiOlt7ImFzc2V0Ijp7InR5cGUiOiJzdmciLCJzcmMiOiI8c3ZnIHZpZXdCb3g9XCIwIDAgNTAgNTBcIiB4bWxucz1cImh0dHA6Ly93d3cudzMub3JnLzIwMDAvc3ZnXCI-PHJlY3Qgd2lkdGg9XCI1MFwiIGhlaWdodD1cIjUwXCIgZmlsbD1cInt7IEZPTlRfQ09MT1JfMSB9fVwiLz48L3N2Zz4ifSwic3RhcnQiOjEuMDUsImxlbmd0aCI6ImVuZCIsIm9mZnNldCI6eyJ4IjotMC40MDgsInkiOi0wLjQ0MX0sInBvc2l0aW9uIjoiY2VudGVyIiwidHJhbnNpdGlvbiI6eyJpbiI6InNsaWRlUmlnaHQifSwid2lkdGgiOjUwLCJoZWlnaHQiOjUwfSx7ImFzc2V0Ijp7InR5cGUiOiJsdW1hIiwic3JjIjoiaHR0cHM6Ly90ZW1wbGF0ZXMuc2hvdHN0YWNrLmlvL3RyYXZlbC1nZXRhd2F5LXByb21vLXN0b3J5LXRlbXBsYXRlLW9mZmVyLzFkMTNlMjgxLWU4YjQtNDAwNS04YjZmLWFkN2YwMDg0NjI1Ny9zb3VyY2UucG5nIn0sInN0YXJ0IjoxLjA1LCJsZW5ndGgiOjcuMTgwMDAwMDAwMDAwMDAxfV19LHsiY2xpcHMiOlt7ImFzc2V0Ijp7InR5cGUiOiJyaWNoLXRleHQiLCJ0ZXh0Ijoie3tQaG9uZX19IiwiZm9udCI6eyJmYW1pbHkiOiJHbGFjaWFsIEluZGlmZmVyZW5jZSIsInNpemUiOjIxLCJ3ZWlnaHQiOjQwMCwiY29sb3IiOiJ7eyBGT05UX0NPTE9SXzEgfX0iLCJvcGFjaXR5IjoxfSwic3R5bGUiOnsibGV0dGVyU3BhY2luZyI6MCwid29yZFNwYWNpbmciOjAsImxpbmVIZWlnaHQiOjEsInRleHRUcmFuc2Zvcm0iOiJub25lIiwidGV4dERlY29yYXRpb24iOiJub25lIn0sImFsaWduIjp7Imhvcml6b250YWwiOiJsZWZ0IiwidmVydGljYWwiOiJtaWRkbGUifX0sInN0YXJ0IjoxLjMsImxlbmd0aCI6ImVuZCIsIm9mZnNldCI6eyJ4IjowLjM2MSwieSI6LTAuNDQxfSwicG9zaXRpb24iOiJjZW50ZXIiLCJ0cmFuc2l0aW9uIjp7ImluIjoic2xpZGVSaWdodCJ9LCJ3aWR0aCI6MzAwLCJoZWlnaHQiOjcyfV19LHsiY2xpcHMiOlt7ImFzc2V0Ijp7InR5cGUiOiJyaWNoLXRleHQiLCJ0ZXh0Ijoie3tFbWFpbH19IiwiZm9udCI6eyJmYW1pbHkiOiJHbGFjaWFsIEluZGlmZmVyZW5jZSIsInNpemUiOjIxLCJ3ZWlnaHQiOjQwMCwiY29sb3IiOiJ7eyBGT05UX0NPTE9SXzEgfX0iLCJvcGFjaXR5IjoxfSwic3R5bGUiOnsibGV0dGVyU3BhY2luZyI6MCwid29yZFNwYWNpbmciOjAsImxpbmVIZWlnaHQiOjEsInRleHRUcmFuc2Zvcm0iOiJub25lIiwidGV4dERlY29yYXRpb24iOiJub25lIn0sImFsaWduIjp7Imhvcml6b250YWwiOiJsZWZ0IiwidmVydGljYWwiOiJtaWRkbGUifX0sInN0YXJ0IjoxLjIsImxlbmd0aCI6ImVuZCIsIm9mZnNldCI6eyJ4IjowLjA2OCwieSI6LTAuNDQxfSwicG9zaXRpb24iOiJjZW50ZXIiLCJ0cmFuc2l0aW9uIjp7ImluIjoic2xpZGVSaWdodCJ9LCJ3aWR0aCI6MjUwLCJoZWlnaHQiOjcyfV19LHsiY2xpcHMiOlt7ImFzc2V0Ijp7InR5cGUiOiJyaWNoLXRleHQiLCJ0ZXh0Ijoie3tXZWJ9fSIsImZvbnQiOnsiZmFtaWx5IjoiR2xhY2lhbCBJbmRpZmZlcmVuY2UiLCJzaXplIjoyMSwid2VpZ2h0Ijo0MDAsImNvbG9yIjoie3sgRk9OVF9DT0xPUl8xIH19Iiwib3BhY2l0eSI6MX0sInN0eWxlIjp7ImxldHRlclNwYWNpbmciOjAsIndvcmRTcGFjaW5nIjowLCJsaW5lSGVpZ2h0IjoxLCJ0ZXh0VHJhbnNmb3JtIjoibm9uZSIsInRleHREZWNvcmF0aW9uIjoibm9uZSJ9LCJhbGlnbiI6eyJob3Jpem9udGFsIjoibGVmdCIsInZlcnRpY2FsIjoibWlkZGxlIn19LCJzdGFydCI6MS4xLCJsZW5ndGgiOiJlbmQiLCJvZmZzZXQiOnsieCI6LTAuMjU0LCJ5IjotMC40NDF9LCJwb3NpdGlvbiI6ImNlbnRlciIsInRyYW5zaXRpb24iOnsiaW4iOiJzbGlkZVJpZ2h0In0sIndpZHRoIjoyNTAsImhlaWdodCI6NzJ9XX0seyJjbGlwcyI6W3siYXNzZXQiOnsidHlwZSI6InJpY2gtdGV4dCIsInRleHQiOiJ7e0NUQX19IiwiZm9udCI6eyJmYW1pbHkiOiJHbGFjaWFsIEluZGlmZmVyZW5jZSIsInNpemUiOjMyLCJ3ZWlnaHQiOjQwMCwiY29sb3IiOiJ7eyBGT05UX0NPTE9SXzIgfX0iLCJvcGFjaXR5IjoxfSwic3R5bGUiOnsibGV0dGVyU3BhY2luZyI6MCwid29yZFNwYWNpbmciOjAsImxpbmVIZWlnaHQiOjEsInRleHRUcmFuc2Zvcm0iOiJub25lIiwidGV4dERlY29yYXRpb24iOiJub25lIn0sImFsaWduIjp7Imhvcml6b250YWwiOiJjZW50ZXIiLCJ2ZXJ0aWNhbCI6Im1pZGRsZSJ9LCJiYWNrZ3JvdW5kIjp7ImNvbG9yIjoie3sgRk9OVF9DT0xPUl8xIH19Iiwib3BhY2l0eSI6MSwiYm9yZGVyUmFkaXVzIjo0MX19LCJzdGFydCI6MC4zLCJsZW5ndGgiOiJlbmQiLCJvZmZzZXQiOnsieCI6MCwieSI6MC4wODZ9LCJwb3NpdGlvbiI6ImNlbnRlciIsInRyYW5zaXRpb24iOnsiaW4iOiJzbGlkZVVwIn0sIndpZHRoIjo0MzQsImhlaWdodCI6NzZ9XX0seyJjbGlwcyI6W3siYXNzZXQiOnsidHlwZSI6InJpY2gtdGV4dCIsInRleHQiOiJ7e0JvZHl9fSIsImZvbnQiOnsiZmFtaWx5IjoiR2xhY2lhbCBJbmRpZmZlcmVuY2UiLCJzaXplIjozOCwid2VpZ2h0Ijo0MDAsImNvbG9yIjoie3sgRk9OVF9DT0xPUl8xIH19Iiwib3BhY2l0eSI6MX0sInN0eWxlIjp7ImxldHRlclNwYWNpbmciOjAsIndvcmRTcGFjaW5nIjowLCJsaW5lSGVpZ2h0IjoxLCJ0ZXh0VHJhbnNmb3JtIjoibm9uZSIsInRleHREZWNvcmF0aW9uIjoibm9uZSJ9LCJhbGlnbiI6eyJob3Jpem9udGFsIjoiY2VudGVyIiwidmVydGljYWwiOiJtaWRkbGUifSwiYW5pbWF0aW9uIjp7InByZXNldCI6ImZhZGVJbiIsInN0eWxlIjoid29yZCJ9fSwic3RhcnQiOjAuMiwibGVuZ3RoIjoiZW5kIiwib2Zmc2V0Ijp7IngiOjAsInkiOjAuMTkyfSwicG9zaXRpb24iOiJjZW50ZXIiLCJ0cmFuc2l0aW9uIjp7ImluIjoic2xpZGVVcCJ9LCJ3aWR0aCI6ODAwLCJoZWlnaHQiOjI1MH1dfSx7ImNsaXBzIjpbeyJsZW5ndGgiOiJlbmQiLCJhc3NldCI6eyJ0eXBlIjoiaW1hZ2UiLCJzcmMiOiJ7eyBMb2dvIH19In0sInN0YXJ0IjowLCJzY2FsZSI6MSwib2Zmc2V0Ijp7IngiOjAsInkiOjAuMzYzOTE2MDg0MjQ5ODA0OH0sInBvc2l0aW9uIjoiY2VudGVyIiwidHJhbnNpdGlvbiI6eyJpbiI6InNsaWRlVXAifSwiZml0IjoiY29udGFpbiIsIndpZHRoIjoxMDAsImhlaWdodCI6MTAwfV19LHsiY2xpcHMiOlt7ImFzc2V0Ijp7InR5cGUiOiJyaWNoLXRleHQiLCJ0ZXh0Ijoie3tDb21wYW55X05hbWV9fSIsImZvbnQiOnsiZmFtaWx5IjoiQXByaWNvdCIsInNpemUiOjgxLCJ3ZWlnaHQiOjQwMCwiY29sb3IiOiJ7eyBGT05UX0NPTE9SXzEgfX0iLCJvcGFjaXR5IjoxfSwic3R5bGUiOnsibGV0dGVyU3BhY2luZyI6MCwid29yZFNwYWNpbmciOjAsImxpbmVIZWlnaHQiOjEsInRleHRUcmFuc2Zvcm0iOiJub25lIiwidGV4dERlY29yYXRpb24iOiJub25lIn0sImFsaWduIjp7Imhvcml6b250YWwiOiJjZW50ZXIiLCJ2ZXJ0aWNhbCI6Im1pZGRsZSJ9LCJhbmltYXRpb24iOnsicHJlc2V0IjoiZmFkZUluIiwic3R5bGUiOiJ3b3JkIn19LCJzdGFydCI6MC4xLCJsZW5ndGgiOiJlbmQiLCJvZmZzZXQiOnsieCI6MCwieSI6MC4yODV9LCJwb3NpdGlvbiI6ImNlbnRlciIsInRyYW5zaXRpb24iOnsiaW4iOiJzbGlkZVVwIn0sIndpZHRoIjo2MDAsImhlaWdodCI6MjAwfV19LHsiY2xpcHMiOlt7Imxlbmd0aCI6Ny44MywiYXNzZXQiOnsidHlwZSI6ImltYWdlIiwic3JjIjoie3tJTUFHRV83fX0ifSwic3RhcnQiOjAuNCwic2NhbGUiOjEsIm9mZnNldCI6eyJ4IjowLCJ5IjotMC4xNjkxNjU0NzIzODg4NjUzN30sInBvc2l0aW9uIjoiY2VudGVyIiwidHJhbnNpdGlvbiI6eyJpbiI6InNsaWRlVXAifSwiZml0IjoiY29udGFpbiIsIndpZHRoIjo0MjEsImhlaWdodCI6NzQ2fV19LHsiY2xpcHMiOlt7Imxlbmd0aCI6OC4yMywiYXNzZXQiOnsidHlwZSI6InZpZGVvIiwic3JjIjoie3sgVklERU9fQkFDS0dST1VORCB9fSJ9LCJzdGFydCI6MCwic2NhbGUiOjEsIndpZHRoIjoxMDgwLCJoZWlnaHQiOjE5MjAsIm9mZnNldCI6eyJ4IjowLCJ5IjowfSwiZml0IjoiY29udGFpbiJ9XX1dfSwib3V0cHV0Ijp7ImZvcm1hdCI6Im1wNCIsImZwcyI6MjUsInNpemUiOnsid2lkdGgiOjEwODAsImhlaWdodCI6MTkyMH0sImRlc3RpbmF0aW9ucyI6W3sicHJvdmlkZXIiOiJzaG90c3RhY2sifV19LCJtZXJnZSI6W3siZmluZCI6IkNvbXBhbnlfTmFtZSIsInJlcGxhY2UiOiJUcmF2ZWwgU3VydmV5In0seyJmaW5kIjoiQm9keSIsInJlcGxhY2UiOiJGcm9tIHBsYW5uaW5nIHlvdXIgdHJpcCB0byBzdGVwcGluZyBvbnRvIHRoZSBwbGFuZSwgd2UgdGFrZSBjYXJlIG9mIGV2ZXJ5IGRldGFpbCDigJQgc28geW91IGNhbiBzaW1wbHkgcmVsYXggYW5kIGxvb2sgZm9yd2FyZCB0byB0aGUgam91cm5leSBhaGVhZCJ9LHsiZmluZCI6IkNUQSIsInJlcGxhY2UiOiJFTlFVSVJFIEhFUkUifSx7ImZpbmQiOiJXZWIiLCJyZXBsYWNlIjoidHJhdmVsc3VydmV5bWFpbC5jb20ifSx7ImZpbmQiOiJFbWFpbCIsInJlcGxhY2UiOiJAdHJhdmVsc3VydmV5In0seyJmaW5kIjoiUGhvbmUiLCJyZXBsYWNlIjoiMjM0LTU2Ny04OTAwIn0seyJmaW5kIjoiSU1BR0VfMSIsInJlcGxhY2UiOiJodHRwczovL3RlbXBsYXRlcy5zaG90c3RhY2suaW8vdHJhdmVsLWdldGF3YXktcHJvbW8tc3RvcnktdGVtcGxhdGUtb2ZmZXIvMjhjMWMzMDMtZjJjMC00YTIwLTgxZmItZmFiMTA0OGM1YWJjL3NvdXJjZS5wbmcifSx7ImZpbmQiOiJJTUFHRV8yIiwicmVwbGFjZSI6Imh0dHBzOi8vdGVtcGxhdGVzLnNob3RzdGFjay5pby90cmF2ZWwtZ2V0YXdheS1wcm9tby1zdG9yeS10ZW1wbGF0ZS1vZmZlci8yMzQ3NDAyMC1jOWJkLTQwZDQtYWI1Yy02YmM1ZWU3MmE1MDgvc291cmNlLnBuZyJ9LHsiZmluZCI6IklNQUdFXzMiLCJyZXBsYWNlIjoiaHR0cHM6Ly90ZW1wbGF0ZXMuc2hvdHN0YWNrLmlvL3RyYXZlbC1nZXRhd2F5LXByb21vLXN0b3J5LXRlbXBsYXRlLW9mZmVyL2EzYWIyYjYxLWNmNjgtNDc1Mi05ZTViLWUxZThiZmNjMWU5MC9zb3VyY2UucG5nIn0seyJmaW5kIjoiSU1BR0VfNCIsInJlcGxhY2UiOiJodHRwczovL3RlbXBsYXRlcy5zaG90c3RhY2suaW8vdHJhdmVsLWdldGF3YXktcHJvbW8tc3RvcnktdGVtcGxhdGUtb2ZmZXIvMDA2ZWVhYmMtYTM3Yi00MmUyLTg1OTktNDlhMDVjYzZiNzBiL3NvdXJjZS5wbmcifSx7ImZpbmQiOiJJTUFHRV81IiwicmVwbGFjZSI6Imh0dHBzOi8vdGVtcGxhdGVzLnNob3RzdGFjay5pby90cmF2ZWwtZ2V0YXdheS1wcm9tby1zdG9yeS10ZW1wbGF0ZS1vZmZlci81ZGU4MjlhOC1lYTM2LTQ3NzctOTFhOC05MDA3NjVmNDliNTgvc291cmNlLnBuZyJ9LHsiZmluZCI6IklNQUdFXzYiLCJyZXBsYWNlIjoiaHR0cHM6Ly90ZW1wbGF0ZXMuc2hvdHN0YWNrLmlvL3RyYXZlbC1nZXRhd2F5LXByb21vLXN0b3J5LXRlbXBsYXRlLW9mZmVyL2Q4NmU4YWY3LWNiMTktNDI5ZS05ZWZjLTVlOThiZjYyMzFhMC9zb3VyY2UucG5nIn0seyJmaW5kIjoiSU1BR0VfNyIsInJlcGxhY2UiOiJodHRwczovL3RlbXBsYXRlcy5zaG90c3RhY2suaW8vdHJhdmVsLWdldGF3YXktcHJvbW8tc3RvcnktdGVtcGxhdGUtb2ZmZXIvMDc2ZWY4ZTUtMzFlNy00ZGNlLThhNzYtZjljYTkyNWQzMDg0L3NvdXJjZS5wbmcifSx7ImZpbmQiOiJMb2dvIiwicmVwbGFjZSI6Imh0dHBzOi8vdGVtcGxhdGVzLnNob3RzdGFjay5pby90cmF2ZWwtZ2V0YXdheS1wcm9tby1zdG9yeS10ZW1wbGF0ZS1vZmZlci9mYzBiNzkxYy02OWI4LTQyMjYtYjMxYy02ZmJlZGZlODc1NDAvc291cmNlLnBuZyJ9LHsiZmluZCI6IkZPTlRfQ09MT1JfMSIsInJlcGxhY2UiOiIjZmZmZmZmIn0seyJmaW5kIjoiRk9OVF9DT0xPUl8yIiwicmVwbGFjZSI6IiMwMDAwMDAifSx7ImZpbmQiOiJWSURFT19CQUNLR1JPVU5EIiwicmVwbGFjZSI6Imh0dHBzOi8vdGVtcGxhdGVzLnNob3RzdGFjay5pby90cmF2ZWwtZ2V0YXdheS1wcm9tby1zdG9yeS10ZW1wbGF0ZS1vZmZlci8xYzJlZWRiZi0xZjM2LTQwZTEtOWI4OC04YTBhZmJkZWQ4YmYvc291cmNlLm1wNCJ9LHsiZmluZCI6IkFVRElPIiwicmVwbGFjZSI6Imh0dHBzOi8vdGVtcGxhdGVzLnNob3RzdGFjay5pby90cmF2ZWwtZ2V0YXdheS1wcm9tby1zdG9yeS10ZW1wbGF0ZS1vZmZlci84NWM2NTlhNS1lMjM0LTQzZGEtYjc5Yy0zYTBjMmRjMjg5YTEvc291cmNlLm1wMyJ9XX0
- **Edit and save to an account**: https://dashboard.shotstack.io/studio/editor/travel-getaway-promo-story-template-offer-v2
## How to use this template as a workflow
1. Render it once with the JSON below to confirm the output.
2. Replace the values that change per row of data (merge fields or asset URLs).
3. Loop over your data (CSV, database, webhook payload) and send one render per row. Add a `callback` URL to the request so Shotstack notifies you when each video is ready instead of polling.
4. To keep the JSON out of your app, store it with the Templates endpoint and render by template ID with a `merge` array: https://shotstack.io/docs/guide/architecting-an-application/templates/
## Customise
This template has merge fields. Send a `merge` array with the request to replace them; do not edit the timeline JSON.
| Field | Default |
| --- | --- |
| `{{ Company_Name }}` | Travel Survey |
| `{{ Body }}` | From planning your trip to stepping onto the plane, we take care of every detail — so you can simply relax and look forward to the journey ahead |
| `{{ CTA }}` | ENQUIRE HERE |
| `{{ Web }}` | travelsurveymail.com |
| `{{ Email }}` | @travelsurvey |
| `{{ Phone }}` | 234-567-8900 |
| `{{ IMAGE_1 }}` | https://templates.shotstack.io/travel-getaway-promo-story-template-offer/28c1c303-f2c0-4a20-81fb-fab1048c5abc/source.png |
| `{{ IMAGE_2 }}` | https://templates.shotstack.io/travel-getaway-promo-story-template-offer/23474020-c9bd-40d4-ab5c-6bc5ee72a508/source.png |
| `{{ IMAGE_3 }}` | https://templates.shotstack.io/travel-getaway-promo-story-template-offer/a3ab2b61-cf68-4752-9e5b-e1e8bfcc1e90/source.png |
| `{{ IMAGE_4 }}` | https://templates.shotstack.io/travel-getaway-promo-story-template-offer/006eeabc-a37b-42e2-8599-49a05cc6b70b/source.png |
| `{{ IMAGE_5 }}` | https://templates.shotstack.io/travel-getaway-promo-story-template-offer/5de829a8-ea36-4777-91a8-900765f49b58/source.png |
| `{{ IMAGE_6 }}` | https://templates.shotstack.io/travel-getaway-promo-story-template-offer/d86e8af7-cb19-429e-9efc-5e98bf6231a0/source.png |
| `{{ IMAGE_7 }}` | https://templates.shotstack.io/travel-getaway-promo-story-template-offer/076ef8e5-31e7-4dce-8a76-f9ca925d3084/source.png |
| `{{ Logo }}` | https://templates.shotstack.io/travel-getaway-promo-story-template-offer/fc0b791c-69b8-4226-b31c-6fbedfe87540/source.png |
| `{{ FONT_COLOR_1 }}` | #ffffff |
| `{{ FONT_COLOR_2 }}` | #000000 |
| `{{ VIDEO_BACKGROUND }}` | https://templates.shotstack.io/travel-getaway-promo-story-template-offer/1c2eedbf-1f36-40e1-9b88-8a0afbded8bf/source.mp4 |
| `{{ AUDIO }}` | https://templates.shotstack.io/travel-getaway-promo-story-template-offer/85c659a5-e234-43da-b79c-3a0c2dc289a1/source.mp3 |
## Template JSON
```json
{
"timeline": {
"fonts": [
{
"src": "https://templates.shotstack.io/travel-getaway-promo-story-template-offer/a6adbac5-7c29-44d8-b87c-e4e67475f696/source.otf"
},
{
"src": "https://templates.shotstack.io/travel-getaway-promo-story-template-offer/767967c3-601e-42bf-88f5-0affa0cc38b2/source.otf"
}
],
"background": "#FFFFFF",
"tracks": [
{
"clips": [
{
"length": "end",
"asset": {
"type": "audio",
"src": "{{ AUDIO }}",
"volume": 1
},
"start": 0
}
]
},
{
"clips": [
{
"length": "end",
"asset": {
"type": "image",
"src": "{{ IMAGE_6 }}"
},
"start": 1,
"scale": 1,
"offset": {
"x": 0.314,
"y": -0.295
},
"position": "center",
"transition": {
"in": "slideUp"
},
"fit": "contain",
"width": 200,
"height": 200
},
{
"asset": {
"type": "luma",
"src": "https://templates.shotstack.io/travel-getaway-promo-story-template-offer/8b3a5105-90d6-4fa4-8432-3c16b9c3564a/source.png"
},
"start": 1,
"length": 7.23
}
]
},
{
"clips": [
{
"length": "end",
"asset": {
"type": "image",
"src": "{{ IMAGE_3 }}"
},
"start": 1,
"scale": 1,
"offset": {
"x": -0.319,
"y": -0.29
},
"position": "center",
"transition": {
"in": "slideUp"
},
"fit": "contain",
"width": 200,
"height": 200
},
{
"asset": {
"type": "luma",
"src": "https://templates.shotstack.io/travel-getaway-promo-story-template-offer/4a7495f1-b5b8-4848-8fb4-28bbf66a84bc/source.png"
},
"start": 1,
"length": 7.23
}
]
},
{
"clips": [
{
"length": "end",
"asset": {
"type": "image",
"src": "{{ IMAGE_5 }}"
},
"start": 0.8,
"scale": 1,
"offset": {
"x": 0.314,
"y": -0.169
},
"position": "center",
"transition": {
"in": "slideUp"
},
"fit": "contain",
"width": 200,
"height": 200
},
{
"asset": {
"type": "luma",
"src": "https://templates.shotstack.io/travel-getaway-promo-story-template-offer/d4877fda-da08-41d9-904c-6055c06f1565/source.png"
},
"start": 0.8,
"length": 7.430000000000001
}
]
},
{
"clips": [
{
"length": "end",
"asset": {
"type": "image",
"src": "{{ IMAGE_2 }}"
},
"start": 0.8,
"scale": 1,
"offset": {
"x": -0.319,
"y": -0.171
},
"position": "center",
"transition": {
"in": "slideUp"
},
"fit": "contain",
"width": 200,
"height": 200
},
{
"asset": {
"type": "luma",
"src": "https://templates.shotstack.io/travel-getaway-promo-story-template-offer/7cff2551-b91a-4b31-b6f3-0ffcb96f8e38/source.png"
},
"start": 0.8,
"length": 7.430000000000001
}
]
},
{
"clips": [
{
"length": "end",
"asset": {
"type": "image",
"src": "{{ IMAGE_4 }}"
},
"start": 0.6,
"scale": 1,
"offset": {
"x": 0.3125190102229046,
"y": -0.03510481026586381
},
"position": "center",
"transition": {
"in": "slideUp"
},
"fit": "contain",
"width": 200,
"height": 200
},
{
"asset": {
"type": "luma",
"src": "https://templates.shotstack.io/travel-getaway-promo-story-template-offer/75336bd9-96cf-4891-ba49-9c1b0149c1cf/source.png"
},
"start": 0.6,
"length": 7.630000000000001
}
]
},
{
"clips": [
{
"length": "end",
"asset": {
"type": "image",
"src": "{{ IMAGE_1 }}"
},
"start": 0.6,
"scale": 1,
"offset": {
"x": -0.32270370370370377,
"y": -0.05208333333333337
},
"position": "center",
"transition": {
"in": "slideUp"
},
"fit": "contain",
"width": 200,
"height": 200
},
{
"asset": {
"type": "luma",
"src": "https://templates.shotstack.io/travel-getaway-promo-story-template-offer/9d1bf77d-0629-450f-9436-ad4bd8f3e556/source.png"
},
"start": 0.6,
"length": 7.630000000000001
}
]
},
{
"clips": [
{
"asset": {
"type": "svg",
"src": ""
},
"start": 1.25,
"length": "end",
"offset": {
"x": 0.185,
"y": -0.441
},
"position": "center",
"transition": {
"in": "slideRight"
},
"width": 50,
"height": 50
},
{
"asset": {
"type": "luma",
"src": "https://templates.shotstack.io/travel-getaway-promo-story-template-offer/5a3e74de-448d-43fe-acd1-30c3004dc5ac/source.png"
},
"start": 1.25,
"length": 6.98
}
]
},
{
"clips": [
{
"asset": {
"type": "svg",
"src": ""
},
"start": 1.15,
"length": "end",
"offset": {
"x": -0.085,
"y": -0.441
},
"position": "center",
"transition": {
"in": "slideRight"
},
"width": 50,
"height": 50
},
{
"asset": {
"type": "luma",
"src": "https://templates.shotstack.io/travel-getaway-promo-story-template-offer/23c3affb-5cfc-427f-882e-fe82fe4cfb15/source.png"
},
"start": 1.15,
"length": 7.08
}
]
},
{
"clips": [
{
"asset": {
"type": "svg",
"src": ""
},
"start": 1.05,
"length": "end",
"offset": {
"x": -0.408,
"y": -0.441
},
"position": "center",
"transition": {
"in": "slideRight"
},
"width": 50,
"height": 50
},
{
"asset": {
"type": "luma",
"src": "https://templates.shotstack.io/travel-getaway-promo-story-template-offer/1d13e281-e8b4-4005-8b6f-ad7f00846257/source.png"
},
"start": 1.05,
"length": 7.180000000000001
}
]
},
{
"clips": [
{
"asset": {
"type": "rich-text",
"text": "{{Phone}}",
"font": {
"family": "Glacial Indifference",
"size": 21,
"weight": 400,
"color": "{{ FONT_COLOR_1 }}",
"opacity": 1
},
"style": {
"letterSpacing": 0,
"wordSpacing": 0,
"lineHeight": 1,
"textTransform": "none",
"textDecoration": "none"
},
"align": {
"horizontal": "left",
"vertical": "middle"
}
},
"start": 1.3,
"length": "end",
"offset": {
"x": 0.361,
"y": -0.441
},
"position": "center",
"transition": {
"in": "slideRight"
},
"width": 300,
"height": 72
}
]
},
{
"clips": [
{
"asset": {
"type": "rich-text",
"text": "{{Email}}",
"font": {
"family": "Glacial Indifference",
"size": 21,
"weight": 400,
"color": "{{ FONT_COLOR_1 }}",
"opacity": 1
},
"style": {
"letterSpacing": 0,
"wordSpacing": 0,
"lineHeight": 1,
"textTransform": "none",
"textDecoration": "none"
},
"align": {
"horizontal": "left",
"vertical": "middle"
}
},
"start": 1.2,
"length": "end",
"offset": {
"x": 0.068,
"y": -0.441
},
"position": "center",
"transition": {
"in": "slideRight"
},
"width": 250,
"height": 72
}
]
},
{
"clips": [
{
"asset": {
"type": "rich-text",
"text": "{{Web}}",
"font": {
"family": "Glacial Indifference",
"size": 21,
"weight": 400,
"color": "{{ FONT_COLOR_1 }}",
"opacity": 1
},
"style": {
"letterSpacing": 0,
"wordSpacing": 0,
"lineHeight": 1,
"textTransform": "none",
"textDecoration": "none"
},
"align": {
"horizontal": "left",
"vertical": "middle"
}
},
"start": 1.1,
"length": "end",
"offset": {
"x": -0.254,
"y": -0.441
},
"position": "center",
"transition": {
"in": "slideRight"
},
"width": 250,
"height": 72
}
]
},
{
"clips": [
{
"asset": {
"type": "rich-text",
"text": "{{CTA}}",
"font": {
"family": "Glacial Indifference",
"size": 32,
"weight": 400,
"color": "{{ FONT_COLOR_2 }}",
"opacity": 1
},
"style": {
"letterSpacing": 0,
"wordSpacing": 0,
"lineHeight": 1,
"textTransform": "none",
"textDecoration": "none"
},
"align": {
"horizontal": "center",
"vertical": "middle"
},
"background": {
"color": "{{ FONT_COLOR_1 }}",
"opacity": 1,
"borderRadius": 41
}
},
"start": 0.3,
"length": "end",
"offset": {
"x": 0,
"y": 0.086
},
"position": "center",
"transition": {
"in": "slideUp"
},
"width": 434,
"height": 76
}
]
},
{
"clips": [
{
"asset": {
"type": "rich-text",
"text": "{{Body}}",
"font": {
"family": "Glacial Indifference",
"size": 38,
"weight": 400,
"color": "{{ FONT_COLOR_1 }}",
"opacity": 1
},
"style": {
"letterSpacing": 0,
"wordSpacing": 0,
"lineHeight": 1,
"textTransform": "none",
"textDecoration": "none"
},
"align": {
"horizontal": "center",
"vertical": "middle"
},
"animation": {
"preset": "fadeIn",
"style": "word"
}
},
"start": 0.2,
"length": "end",
"offset": {
"x": 0,
"y": 0.192
},
"position": "center",
"transition": {
"in": "slideUp"
},
"width": 800,
"height": 250
}
]
},
{
"clips": [
{
"length": "end",
"asset": {
"type": "image",
"src": "{{ Logo }}"
},
"start": 0,
"scale": 1,
"offset": {
"x": 0,
"y": 0.3639160842498048
},
"position": "center",
"transition": {
"in": "slideUp"
},
"fit": "contain",
"width": 100,
"height": 100
}
]
},
{
"clips": [
{
"asset": {
"type": "rich-text",
"text": "{{Company_Name}}",
"font": {
"family": "Apricot",
"size": 81,
"weight": 400,
"color": "{{ FONT_COLOR_1 }}",
"opacity": 1
},
"style": {
"letterSpacing": 0,
"wordSpacing": 0,
"lineHeight": 1,
"textTransform": "none",
"textDecoration": "none"
},
"align": {
"horizontal": "center",
"vertical": "middle"
},
"animation": {
"preset": "fadeIn",
"style": "word"
}
},
"start": 0.1,
"length": "end",
"offset": {
"x": 0,
"y": 0.285
},
"position": "center",
"transition": {
"in": "slideUp"
},
"width": 600,
"height": 200
}
]
},
{
"clips": [
{
"length": 7.83,
"asset": {
"type": "image",
"src": "{{IMAGE_7}}"
},
"start": 0.4,
"scale": 1,
"offset": {
"x": 0,
"y": -0.16916547238886537
},
"position": "center",
"transition": {
"in": "slideUp"
},
"fit": "contain",
"width": 421,
"height": 746
}
]
},
{
"clips": [
{
"length": 8.23,
"asset": {
"type": "video",
"src": "{{ VIDEO_BACKGROUND }}"
},
"start": 0,
"scale": 1,
"width": 1080,
"height": 1920,
"offset": {
"x": 0,
"y": 0
},
"fit": "contain"
}
]
}
]
},
"output": {
"format": "mp4",
"fps": 25,
"size": {
"width": 1080,
"height": 1920
},
"destinations": [
{
"provider": "shotstack"
}
]
},
"merge": [
{
"find": "Company_Name",
"replace": "Travel Survey"
},
{
"find": "Body",
"replace": "From planning your trip to stepping onto the plane, we take care of every detail — so you can simply relax and look forward to the journey ahead"
},
{
"find": "CTA",
"replace": "ENQUIRE HERE"
},
{
"find": "Web",
"replace": "travelsurveymail.com"
},
{
"find": "Email",
"replace": "@travelsurvey"
},
{
"find": "Phone",
"replace": "234-567-8900"
},
{
"find": "IMAGE_1",
"replace": "https://templates.shotstack.io/travel-getaway-promo-story-template-offer/28c1c303-f2c0-4a20-81fb-fab1048c5abc/source.png"
},
{
"find": "IMAGE_2",
"replace": "https://templates.shotstack.io/travel-getaway-promo-story-template-offer/23474020-c9bd-40d4-ab5c-6bc5ee72a508/source.png"
},
{
"find": "IMAGE_3",
"replace": "https://templates.shotstack.io/travel-getaway-promo-story-template-offer/a3ab2b61-cf68-4752-9e5b-e1e8bfcc1e90/source.png"
},
{
"find": "IMAGE_4",
"replace": "https://templates.shotstack.io/travel-getaway-promo-story-template-offer/006eeabc-a37b-42e2-8599-49a05cc6b70b/source.png"
},
{
"find": "IMAGE_5",
"replace": "https://templates.shotstack.io/travel-getaway-promo-story-template-offer/5de829a8-ea36-4777-91a8-900765f49b58/source.png"
},
{
"find": "IMAGE_6",
"replace": "https://templates.shotstack.io/travel-getaway-promo-story-template-offer/d86e8af7-cb19-429e-9efc-5e98bf6231a0/source.png"
},
{
"find": "IMAGE_7",
"replace": "https://templates.shotstack.io/travel-getaway-promo-story-template-offer/076ef8e5-31e7-4dce-8a76-f9ca925d3084/source.png"
},
{
"find": "Logo",
"replace": "https://templates.shotstack.io/travel-getaway-promo-story-template-offer/fc0b791c-69b8-4226-b31c-6fbedfe87540/source.png"
},
{
"find": "FONT_COLOR_1",
"replace": "#ffffff"
},
{
"find": "FONT_COLOR_2",
"replace": "#000000"
},
{
"find": "VIDEO_BACKGROUND",
"replace": "https://templates.shotstack.io/travel-getaway-promo-story-template-offer/1c2eedbf-1f36-40e1-9b88-8a0afbded8bf/source.mp4"
},
{
"find": "AUDIO",
"replace": "https://templates.shotstack.io/travel-getaway-promo-story-template-offer/85c659a5-e234-43da-b79c-3a0c2dc289a1/source.mp3"
}
]
}
```
## Render it
Save the JSON as `template.json`. The sandbox key is free: https://dashboard.shotstack.io/register
### cURL
```bash
# Save the JSON above as template.json, then:
curl -X POST https://api.shotstack.io/edit/stage/render \
-H "x-api-key: $SHOTSTACK_API_KEY" \
-H "Content-Type: application/json" \
-d @template.json
# Poll until status is "done", then download response.url
curl https://api.shotstack.io/edit/stage/render/RENDER_ID -H "x-api-key: $SHOTSTACK_API_KEY"
```
### Node.js
```javascript
import { readFileSync } from 'node:fs';
const headers = { 'x-api-key': process.env.SHOTSTACK_API_KEY, 'Content-Type': 'application/json' };
const edit = JSON.parse(readFileSync('template.json', 'utf8'));
const { response } = await fetch('https://api.shotstack.io/edit/stage/render', {
method: 'POST', headers, body: JSON.stringify(edit)
}).then((r) => r.json());
let render;
do {
await new Promise((r) => setTimeout(r, 3000));
render = (await fetch(`https://api.shotstack.io/edit/stage/render/${response.id}`, { headers }).then((r) => r.json())).response;
} while (!['done', 'failed'].includes(render.status));
console.log(render.status, render.url);
```
### Python
```python
import json, os, time, requests
headers = {"x-api-key": os.environ["SHOTSTACK_API_KEY"]}
with open("template.json") as f:
edit = json.load(f)
render_id = requests.post("https://api.shotstack.io/edit/stage/render", json=edit, headers=headers).json()["response"]["id"]
while True:
render = requests.get(f"https://api.shotstack.io/edit/stage/render/{render_id}", headers=headers).json()["response"]
if render["status"] in ("done", "failed"):
break
time.sleep(3)
print(render["status"], render.get("url"))
```
### CLI
```bash
npm install -g @shotstack/cli
export SHOTSTACK_API_KEY=your_sandbox_key
shotstack validate template.json # offline schema check, free
shotstack render template.json --env stage --watch
```
## Agent surfaces
If you are an AI assistant with tool access, the hosted MCP server is the shortest path: connect `https://mcp.shotstack.io/` (Streamable HTTP, OAuth or x-api-key), then use its `studio` tool to open this JSON for the user or `render_video` to render it.
- MCP server (all clients): https://shotstack.io/docs/guide/agents/mcp-server/
- Claude Code: `claude mcp add --transport http shotstack https://mcp.shotstack.io`
- Cursor (mcp.json): `{"mcpServers":{"shotstack":{"url":"https://mcp.shotstack.io/"}}}`
- VS Code (mcp.json): `{"servers":{"shotstack":{"type":"http","url":"https://mcp.shotstack.io/"}}}`
- Claude.ai / ChatGPT: Settings → Connectors → add custom connector → https://mcp.shotstack.io/
- CLI + agent skill: https://shotstack.io/docs/guide/agents/cli/ — skill file: https://raw.githubusercontent.com/shotstack/shotstack-cli/HEAD/skills/shotstack/SKILL.md
- Edit JSON conventions for AI: https://shotstack.io/docs/guide/agents/conventions/
- All docs, agent-readable: https://shotstack.io/docs/guide/llms.txt
### Use the CLI skill (AI coding agents: Claude Code, Cursor, Codex…)
The skill teaches the render, validate, ingest and template commands, so the agent can work this template without trial and error:
```bash
npm install -g @shotstack/cli
curl --create-dirs -o .claude/skills/shotstack/SKILL.md https://raw.githubusercontent.com/shotstack/shotstack-cli/HEAD/skills/shotstack/SKILL.md
```
(Claude Code loads it from `.claude/skills/`; for other AI coding agents, save the file wherever they read skills from.) Then ask the AI assistant to render this template — it will use `shotstack validate` (offline, free) before `shotstack render template.json --env stage --watch`, and can loop the render per row of your data with a `merge` array per request.
## Related
- Bulk-create videos from a CSV: https://shotstack.io/learn/bulk-create-videos-from-csv-and-ai/
- Webhooks: https://shotstack.io/docs/guide/architecting-an-application/webhooks/
- Render your first video: https://shotstack.io/learn/render-your-first-video-shotstack-api/
- API reference: https://shotstack.io/docs/api/
- All agent-readable docs: https://shotstack.io/llms.txt