# Tropical Escape: Vacation & Travel Offer Template (video template)

> Promote your exclusive travel deals with our stunning vacation offer template. Perfect for hotels, resorts, and travel agencies.

## Overview

- **Page**: https://shotstack.io/studio/templates/vacation-getaway-travel-offer-template/
- **Output**: MP4, 1080x1920 (9:16), 25 fps
- **Length**: 20s
- **Timeline**: 28 clips on 23 tracks; assets: audio, luma, text, 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=eyJ0aW1lbGluZSI6eyJmb250cyI6W3sic3JjIjoiaHR0cHM6Ly90ZW1wbGF0ZXMuc2hvdHN0YWNrLmlvL3ZhY2F0aW9uLWdldGF3YXktdHJhdmVsLW9mZmVyLXRlbXBsYXRlLzZiODc5ZDljLTU0MDgtNGE1Ni05MmMyLTVkNmExMGMyYjZkZi9zb3VyY2UudHRmIn1dLCJiYWNrZ3JvdW5kIjoiI0ZGRkZGRiIsInRyYWNrcyI6W3siY2xpcHMiOlt7Imxlbmd0aCI6ImVuZCIsImFzc2V0Ijp7InR5cGUiOiJhdWRpbyIsInNyYyI6Int7IEFVRElPIH19Iiwidm9sdW1lIjoxfSwic3RhcnQiOjB9XX0seyJjbGlwcyI6W3siYXNzZXQiOnsidHlwZSI6InRleHQiLCJ0ZXh0Ijoie3tTNF9Cb2R5fX0iLCJhbGlnbm1lbnQiOnsiaG9yaXpvbnRhbCI6ImNlbnRlciIsInZlcnRpY2FsIjoiY2VudGVyIn0sImZvbnQiOnsiY29sb3IiOiJ7eyBGT05UX0NPTE9SIH19IiwiZmFtaWx5IjoiTW9udHNlcnJhdCBTZW1pQm9sZCIsInNpemUiOjQ2LCJsaW5lSGVpZ2h0IjoxfSwid2lkdGgiOjcwMCwiaGVpZ2h0Ijo3Mn0sInN0YXJ0IjoxNS40LCJsZW5ndGgiOiJlbmQiLCJvZmZzZXQiOnsieCI6MCwieSI6LTAuMDQ2fSwicG9zaXRpb24iOiJjZW50ZXIiLCJ0cmFuc2l0aW9uIjp7Im91dCI6InNsaWRlTGVmdCJ9fV19LHsiY2xpcHMiOlt7ImFzc2V0Ijp7InR5cGUiOiJ0ZXh0IiwidGV4dCI6Int7UzRfU3VidGl0bGV9fSIsImFsaWdubWVudCI6eyJob3Jpem9udGFsIjoiY2VudGVyIiwidmVydGljYWwiOiJjZW50ZXIifSwiZm9udCI6eyJjb2xvciI6Int7IEZPTlRfQ09MT1IgfX0iLCJmYW1pbHkiOiJHcmVhdCBWaWJlcyIsInNpemUiOiIxMjAiLCJsaW5lSGVpZ2h0IjoxfSwid2lkdGgiOjQwMCwiaGVpZ2h0IjoyMDB9LCJzdGFydCI6MTUsImxlbmd0aCI6ImVuZCIsIm9mZnNldCI6eyJ4IjowLCJ5IjowLjAyMX0sInBvc2l0aW9uIjoiY2VudGVyIiwidHJhbnNpdGlvbiI6eyJvdXQiOiJzbGlkZUxlZnQifX1dfSx7ImNsaXBzIjpbeyJhc3NldCI6eyJ0eXBlIjoidGV4dCIsInRleHQiOiIiLCJhbGlnbm1lbnQiOnsiaG9yaXpvbnRhbCI6ImNlbnRlciIsInZlcnRpY2FsIjoiY2VudGVyIn0sImZvbnQiOnsiY29sb3IiOiIjMDAwMDAwIiwiZmFtaWx5IjoiTW9udHNlcnJhdCBFeHRyYUJvbGQiLCJzaXplIjo0NiwibGluZUhlaWdodCI6MX0sIndpZHRoIjoyMDAsImhlaWdodCI6MjAwLCJiYWNrZ3JvdW5kIjp7ImNvbG9yIjoie3sgRk9OVF9DT0xPUiB9fSJ9fSwic3RhcnQiOjE1LCJsZW5ndGgiOiJlbmQiLCJ0cmFuc2Zvcm0iOnsicm90YXRlIjp7ImFuZ2xlIjoxODB9fSwib2Zmc2V0Ijp7InkiOi0wLjM1NSwieCI6MC4yNzh9LCJwb3NpdGlvbiI6ImNlbnRlciIsInRyYW5zaXRpb24iOnsib3V0Ijoic2xpZGVMZWZ0In19LHsiYXNzZXQiOnsidHlwZSI6Imx1bWEiLCJzcmMiOiJodHRwczovL3RlbXBsYXRlcy5zaG90c3RhY2suaW8vdmFjYXRpb24tZ2V0YXdheS10cmF2ZWwtb2ZmZXItdGVtcGxhdGUvNWFhNTVmY2MtNjU0Mi00MDhhLWFiODMtNWZjNWM1YmM1NjFhL3NvdXJjZS5tcDQifSwic3RhcnQiOjE0LjY2ODksImxlbmd0aCI6ImVuZCJ9XX0seyJjbGlwcyI6W3sibGVuZ3RoIjoiZW5kIiwiYXNzZXQiOnsidHlwZSI6InZpZGVvIiwic3JjIjoie3sgUzRfVklERU8gfX0ifSwic3RhcnQiOjE0LjYsInNjYWxlIjowLjgsInRyYW5zaXRpb24iOnsib3V0Ijoic2xpZGVMZWZ0In19XX0seyJjbGlwcyI6W3siYXNzZXQiOnsidHlwZSI6InRleHQiLCJ0ZXh0IjoiIiwiYWxpZ25tZW50Ijp7Imhvcml6b250YWwiOiJjZW50ZXIiLCJ2ZXJ0aWNhbCI6ImNlbnRlciJ9LCJmb250Ijp7ImNvbG9yIjoiIzAwMDAwMCIsImZhbWlseSI6Ik1vbnRzZXJyYXQgU2VtaUJvbGQiLCJzaXplIjoyNCwibGluZUhlaWdodCI6MX0sIndpZHRoIjo5MDIsImhlaWdodCI6MTU3NiwiYmFja2dyb3VuZCI6eyJjb2xvciI6Int7IEZPTlRfQ09MT1IgfX0iLCJvcGFjaXR5IjowLjg3fX0sInN0YXJ0IjoxNC42LCJsZW5ndGgiOiJlbmQiLCJwb3NpdGlvbiI6ImNlbnRlciIsInRyYW5zaXRpb24iOnsiaW4iOiJzbGlkZUxlZnQifX1dfSx7ImNsaXBzIjpbeyJhc3NldCI6eyJ0eXBlIjoidGV4dCIsInRleHQiOiJ7e1MzX0JvZHl9fSIsImFsaWdubWVudCI6eyJob3Jpem9udGFsIjoicmlnaHQiLCJ2ZXJ0aWNhbCI6ImNlbnRlciJ9LCJmb250Ijp7ImNvbG9yIjoie3sgRk9OVF9DT0xPUiB9fSIsImZhbWlseSI6Ik1vbnRzZXJyYXQgU2VtaUJvbGQiLCJzaXplIjo0NiwibGluZUhlaWdodCI6MX0sIndpZHRoIjo3MDAsImhlaWdodCI6NzJ9LCJzdGFydCI6MTAuNiwibGVuZ3RoIjo0LCJvZmZzZXQiOnsieCI6MC4wMzQsInkiOi0wLjM0Mn0sInBvc2l0aW9uIjoiY2VudGVyIiwidHJhbnNpdGlvbiI6eyJvdXQiOiJzbGlkZUxlZnQiLCJpbiI6InNsaWRlTGVmdCJ9fV19LHsiY2xpcHMiOlt7ImFzc2V0Ijp7InR5cGUiOiJ0ZXh0IiwidGV4dCI6Int7UzNfU3VidGl0bGV9fSIsImFsaWdubWVudCI6eyJob3Jpem9udGFsIjoiY2VudGVyIiwidmVydGljYWwiOiJjZW50ZXIifSwiZm9udCI6eyJjb2xvciI6Int7IEZPTlRfQ09MT1IgfX0iLCJmYW1pbHkiOiJHcmVhdCBWaWJlcyIsInNpemUiOiIxMjAiLCJsaW5lSGVpZ2h0IjoxfSwid2lkdGgiOjQwMCwiaGVpZ2h0IjoyMDB9LCJzdGFydCI6MTAuMiwibGVuZ3RoIjo0LjQsIm9mZnNldCI6eyJ4IjowLjIwOSwieSI6LTAuMjcxfSwicG9zaXRpb24iOiJjZW50ZXIiLCJ0cmFuc2l0aW9uIjp7ImluIjoic2xpZGVMZWZ0Iiwib3V0Ijoic2xpZGVMZWZ0In19XX0seyJjbGlwcyI6W3siYXNzZXQiOnsidHlwZSI6InRleHQiLCJ0ZXh0IjoiIiwiYWxpZ25tZW50Ijp7Imhvcml6b250YWwiOiJjZW50ZXIiLCJ2ZXJ0aWNhbCI6ImNlbnRlciJ9LCJmb250Ijp7ImNvbG9yIjoiIzAwMDAwMCIsImZhbWlseSI6Ik1vbnRzZXJyYXQgRXh0cmFCb2xkIiwic2l6ZSI6NDYsImxpbmVIZWlnaHQiOjF9LCJ3aWR0aCI6MjAwLCJoZWlnaHQiOjIwMCwiYmFja2dyb3VuZCI6eyJjb2xvciI6Int7IEZPTlRfQ09MT1IgfX0ifX0sInN0YXJ0IjoxMC4yLCJsZW5ndGgiOjQuNCwib2Zmc2V0Ijp7IngiOi0wLjI5LCJ5IjotMC4yNzF9LCJwb3NpdGlvbiI6ImNlbnRlciIsInRyYW5zaXRpb24iOnsib3V0Ijoic2xpZGVMZWZ0IiwiaW4iOiJzbGlkZUxlZnQifX0seyJhc3NldCI6eyJ0eXBlIjoibHVtYSIsInNyYyI6Imh0dHBzOi8vdGVtcGxhdGVzLnNob3RzdGFjay5pby92YWNhdGlvbi1nZXRhd2F5LXRyYXZlbC1vZmZlci10ZW1wbGF0ZS9iYTM4YTEwMC00NjE2LTQyMGMtOTE4MC04N2IzM2RlYWY2N2Mvc291cmNlLm1wNCJ9LCJzdGFydCI6OS45LCJsZW5ndGgiOjQuOH1dfSx7ImNsaXBzIjpbeyJsZW5ndGgiOjQuOCwiYXNzZXQiOnsidHlwZSI6InZpZGVvIiwic3JjIjoie3sgUzRfVklERU8gfX0iLCJ2b2x1bWUiOjB9LCJzdGFydCI6OS44LCJzY2FsZSI6MC44LCJ0cmFuc2l0aW9uIjp7ImluIjoic2xpZGVMZWZ0Iiwib3V0Ijoic2xpZGVMZWZ0In19XX0seyJjbGlwcyI6W3siYXNzZXQiOnsidHlwZSI6InRleHQiLCJ0ZXh0IjoiIiwiYWxpZ25tZW50Ijp7Imhvcml6b250YWwiOiJjZW50ZXIiLCJ2ZXJ0aWNhbCI6ImNlbnRlciJ9LCJmb250Ijp7ImNvbG9yIjoiIzAwMDAwMCIsImZhbWlseSI6Ik1vbnRzZXJyYXQgU2VtaUJvbGQiLCJzaXplIjoyNCwibGluZUhlaWdodCI6MX0sIndpZHRoIjo5MDIsImhlaWdodCI6MTY4MiwiYmFja2dyb3VuZCI6eyJjb2xvciI6Int7IEZPTlRfQ09MT1IgfX0iLCJvcGFjaXR5IjowLjg3fX0sInN0YXJ0Ijo5LjgsImxlbmd0aCI6NC44LCJwb3NpdGlvbiI6ImNlbnRlciIsInRyYW5zaXRpb24iOnsib3V0Ijoic2xpZGVMZWZ0IiwiaW4iOiJzbGlkZUxlZnQifX1dfSx7ImNsaXBzIjpbeyJhc3NldCI6eyJ0eXBlIjoidGV4dCIsInRleHQiOiJ7e1MyX0JvZHl9fSIsImFsaWdubWVudCI6eyJob3Jpem9udGFsIjoibGVmdCIsInZlcnRpY2FsIjoiY2VudGVyIn0sImZvbnQiOnsiY29sb3IiOiJ7eyBGT05UX0NPTE9SIH19IiwiZmFtaWx5IjoiTW9udHNlcnJhdCBTZW1pQm9sZCIsInNpemUiOjQ2LCJsaW5lSGVpZ2h0IjoxfSwid2lkdGgiOjcwMCwiaGVpZ2h0Ijo3Mn0sInN0YXJ0Ijo1LjgsImxlbmd0aCI6NCwib2Zmc2V0Ijp7IngiOi0wLjAyMSwieSI6LTAuMzMyfSwicG9zaXRpb24iOiJjZW50ZXIiLCJ0cmFuc2l0aW9uIjp7ImluIjoic2xpZGVMZWZ0Iiwib3V0Ijoic2xpZGVMZWZ0In19XX0seyJjbGlwcyI6W3siYXNzZXQiOnsidHlwZSI6InRleHQiLCJ0ZXh0Ijoie3tTMl9TdWJ0aXRsZX19IiwiYWxpZ25tZW50Ijp7Imhvcml6b250YWwiOiJjZW50ZXIiLCJ2ZXJ0aWNhbCI6ImNlbnRlciJ9LCJmb250Ijp7ImNvbG9yIjoie3sgRk9OVF9DT0xPUiB9fSIsImZhbWlseSI6IkdyZWF0IFZpYmVzIiwic2l6ZSI6IjEyMCIsImxpbmVIZWlnaHQiOjF9LCJ3aWR0aCI6NDAwLCJoZWlnaHQiOjIwMH0sInN0YXJ0Ijo1LjQsImxlbmd0aCI6NC40LCJvZmZzZXQiOnsieCI6LTAuMjE1LCJ5IjotMC4yNTJ9LCJwb3NpdGlvbiI6ImNlbnRlciIsInRyYW5zaXRpb24iOnsib3V0Ijoic2xpZGVMZWZ0IiwiaW4iOiJzbGlkZUxlZnQifX1dfSx7ImNsaXBzIjpbeyJhc3NldCI6eyJ0eXBlIjoidGV4dCIsInRleHQiOiIiLCJhbGlnbm1lbnQiOnsiaG9yaXpvbnRhbCI6ImNlbnRlciIsInZlcnRpY2FsIjoiY2VudGVyIn0sImZvbnQiOnsiY29sb3IiOiIjMDAwMDAwIiwiZmFtaWx5IjoiTW9udHNlcnJhdCBFeHRyYUJvbGQiLCJzaXplIjo0NiwibGluZUhlaWdodCI6MX0sIndpZHRoIjoyMDAsImhlaWdodCI6MjAwLCJiYWNrZ3JvdW5kIjp7ImNvbG9yIjoie3sgRk9OVF9DT0xPUiB9fSJ9fSwic3RhcnQiOjUuNCwibGVuZ3RoIjo0LjQsInRyYW5zZm9ybSI6eyJyb3RhdGUiOnsiYW5nbGUiOjE4MH19LCJvZmZzZXQiOnsieCI6MC4yODgsInkiOi0wLjI1OH0sInBvc2l0aW9uIjoiY2VudGVyIiwidHJhbnNpdGlvbiI6eyJpbiI6InNsaWRlTGVmdCIsIm91dCI6InNsaWRlTGVmdCJ9fSx7ImFzc2V0Ijp7InR5cGUiOiJsdW1hIiwic3JjIjoiaHR0cHM6Ly90ZW1wbGF0ZXMuc2hvdHN0YWNrLmlvL3ZhY2F0aW9uLWdldGF3YXktdHJhdmVsLW9mZmVyLXRlbXBsYXRlL2JjZDBmMDEyLWRmZWEtNDdiNS05ZTA2LTUwZjY5MzUyYzQ4My9zb3VyY2UubXA0In0sInN0YXJ0Ijo1LjA2LCJsZW5ndGgiOjQuNzR9XX0seyJjbGlwcyI6W3sibGVuZ3RoIjo0LjgsImFzc2V0Ijp7InR5cGUiOiJ2aWRlbyIsInNyYyI6Int7IFMyX1ZJREVPIH19Iiwidm9sdW1lIjowfSwic3RhcnQiOjUsInNjYWxlIjowLjgsInRyYW5zaXRpb24iOnsib3V0Ijoic2xpZGVMZWZ0IiwiaW4iOiJzbGlkZUxlZnQifX1dfSx7ImNsaXBzIjpbeyJhc3NldCI6eyJ0eXBlIjoidGV4dCIsInRleHQiOiIiLCJhbGlnbm1lbnQiOnsiaG9yaXpvbnRhbCI6ImNlbnRlciIsInZlcnRpY2FsIjoiY2VudGVyIn0sImZvbnQiOnsiY29sb3IiOiIjMDAwMDAwIiwiZmFtaWx5IjoiTW9udHNlcnJhdCBTZW1pQm9sZCIsInNpemUiOjI0LCJsaW5lSGVpZ2h0IjoxfSwid2lkdGgiOjkwMiwiaGVpZ2h0IjoxNTc2LCJiYWNrZ3JvdW5kIjp7ImNvbG9yIjoie3sgRk9OVF9DT0xPUiB9fSIsIm9wYWNpdHkiOjAuODd9fSwic3RhcnQiOjUsImxlbmd0aCI6NC44LCJwb3NpdGlvbiI6ImNlbnRlciIsInRyYW5zaXRpb24iOnsiaW4iOiJzbGlkZUxlZnQiLCJvdXQiOiJzbGlkZUxlZnQifX1dfSx7ImNsaXBzIjpbeyJhc3NldCI6eyJ0eXBlIjoidGV4dCIsInRleHQiOiJ7e1MxX1RpdGxlfX0iLCJhbGlnbm1lbnQiOnsiaG9yaXpvbnRhbCI6ImNlbnRlciIsInZlcnRpY2FsIjoiY2VudGVyIn0sImZvbnQiOnsiY29sb3IiOiJ7eyBGT05UX0NPTE9SIH19IiwiZmFtaWx5IjoiR3JlYXQgVmliZXMiLCJzaXplIjoiMTIwIiwibGluZUhlaWdodCI6MX0sIndpZHRoIjo2MDAsImhlaWdodCI6MzAwLCJiYWNrZ3JvdW5kIjp7Im9wYWNpdHkiOjAuMTJ9fSwic3RhcnQiOjEsImxlbmd0aCI6NCwidHJhbnNpdGlvbiI6eyJvdXQiOiJmYWRlIiwiaW4iOiJmYWRlIn19XX0seyJjbGlwcyI6W3siYXNzZXQiOnsidHlwZSI6InRleHQiLCJ0ZXh0IjoiIiwiYWxpZ25tZW50Ijp7Imhvcml6b250YWwiOiJjZW50ZXIiLCJ2ZXJ0aWNhbCI6ImNlbnRlciJ9LCJmb250Ijp7ImNvbG9yIjoiIzAwMDAwMCIsImZhbWlseSI6Ik1vbnRzZXJyYXQgRXh0cmFCb2xkIiwic2l6ZSI6NDYsImxpbmVIZWlnaHQiOjF9LCJ3aWR0aCI6MjUwLCJoZWlnaHQiOjI1MCwiYmFja2dyb3VuZCI6eyJjb2xvciI6Int7IEZPTlRfQ09MT1IgfX0ifX0sInN0YXJ0IjowLjcsImxlbmd0aCI6NC4zLCJvZmZzZXQiOnsieCI6LTAuMzQ3LCJ5IjowLjQzNX0sInBvc2l0aW9uIjoiY2VudGVyIn0seyJhc3NldCI6eyJ0eXBlIjoibHVtYSIsInNyYyI6Imh0dHBzOi8vdGVtcGxhdGVzLnNob3RzdGFjay5pby92YWNhdGlvbi1nZXRhd2F5LXRyYXZlbC1vZmZlci10ZW1wbGF0ZS9lY2Q3Y2Q5ZS1lYTczLTQyOTQtYjM0MC04YWMxODA2ZTc1Mjcvc291cmNlLm1wNCJ9LCJzdGFydCI6MCwibGVuZ3RoIjo1fV19LHsiY2xpcHMiOlt7Imxlbmd0aCI6NC4zMiwiYXNzZXQiOnsidHlwZSI6InZpZGVvIiwic3JjIjoie3sgUzFfVklERU9fMSB9fSIsInZvbHVtZSI6MH0sInN0YXJ0IjowLjcsInNjYWxlIjowLjMsIm9mZnNldCI6eyJ4IjowLCJ5IjotMC4zMjV9LCJwb3NpdGlvbiI6ImNlbnRlciIsInRyYW5zaXRpb24iOnsiaW4iOiJzbGlkZVJpZ2h0Iiwib3V0Ijoic2xpZGVMZWZ0In19XX0seyJjbGlwcyI6W3sibGVuZ3RoIjo0LjYsImFzc2V0Ijp7InR5cGUiOiJ2aWRlbyIsInNyYyI6Int7IFMxX1ZJREVPXzIgfX0iLCJ2b2x1bWUiOjB9LCJzdGFydCI6MC40LCJzY2FsZSI6MC4zLCJ0cmFuc2l0aW9uIjp7Im91dCI6InNsaWRlTGVmdCIsImluIjoic2xpZGVSaWdodCJ9fV19LHsiY2xpcHMiOlt7ImFzc2V0Ijp7InR5cGUiOiJ0ZXh0IiwidGV4dCI6IiIsImFsaWdubWVudCI6eyJob3Jpem9udGFsIjoiY2VudGVyIiwidmVydGljYWwiOiJjZW50ZXIifSwiZm9udCI6eyJjb2xvciI6IiMwMDAwMDAiLCJmYW1pbHkiOiJNb250c2VycmF0IEV4dHJhQm9sZCIsInNpemUiOjQ2LCJsaW5lSGVpZ2h0IjoxfSwid2lkdGgiOjI1MCwiaGVpZ2h0IjoyNTAsImJhY2tncm91bmQiOnsiY29sb3IiOiJ7eyBGT05UX0NPTE9SIH19In19LCJzdGFydCI6MCwibGVuZ3RoIjo1LCJvZmZzZXQiOnsieCI6LTAuMzQ3LCJ5IjowLjQzNX0sInBvc2l0aW9uIjoiY2VudGVyIn0seyJhc3NldCI6eyJ0eXBlIjoibHVtYSIsInNyYyI6Imh0dHBzOi8vdGVtcGxhdGVzLnNob3RzdGFjay5pby92YWNhdGlvbi1nZXRhd2F5LXRyYXZlbC1vZmZlci10ZW1wbGF0ZS9hNGE4NzFmZi0xNzYzLTQ3MWItYWI0YS03NWRmZTU3MDAyNjkvc291cmNlLm1wNCJ9LCJzdGFydCI6MCwibGVuZ3RoIjo1fV19LHsiY2xpcHMiOlt7Imxlbmd0aCI6NSwiYXNzZXQiOnsidHlwZSI6InZpZGVvIiwic3JjIjoie3sgUzFfVklERU9fMyB9fSIsInZvbHVtZSI6MH0sInN0YXJ0IjowLCJzY2FsZSI6MC4zLCJvZmZzZXQiOnsieCI6MCwieSI6MC4zMjF9LCJwb3NpdGlvbiI6ImNlbnRlciIsInRyYW5zaXRpb24iOnsiaW4iOiJzbGlkZVJpZ2h0Iiwib3V0Ijoic2xpZGVMZWZ0In19XX0seyJjbGlwcyI6W3siYXNzZXQiOnsidHlwZSI6InRleHQiLCJ0ZXh0IjoiIiwiYWxpZ25tZW50Ijp7Imhvcml6b250YWwiOiJjZW50ZXIiLCJ2ZXJ0aWNhbCI6ImNlbnRlciJ9LCJmb250Ijp7ImNvbG9yIjoiIzAwMDAwMCIsImZhbWlseSI6Ik1vbnRzZXJyYXQgU2VtaUJvbGQiLCJzaXplIjoyNCwibGluZUhlaWdodCI6MX0sIndpZHRoIjoxMDgwLCJoZWlnaHQiOjE5MjAsImJhY2tncm91bmQiOnsiY29sb3IiOiJ7eyBCQUNLR1JPVU5EX0NPTE9SIH19In19LCJzdGFydCI6MCwibGVuZ3RoIjoyMCwicG9zaXRpb24iOiJjZW50ZXIifV19XX0sIm91dHB1dCI6eyJmb3JtYXQiOiJtcDQiLCJmcHMiOjI1LCJzaXplIjp7IndpZHRoIjoxMDgwLCJoZWlnaHQiOjE5MjB9fSwibWVyZ2UiOlt7ImZpbmQiOiJTMV9UaXRsZSIsInJlcGxhY2UiOiJNeSBWYWNhdGlvbiBQbGFuIn0seyJmaW5kIjoiUzFfVklERU9fMSIsInJlcGxhY2UiOiJodHRwczovL3RlbXBsYXRlcy5zaG90c3RhY2suaW8vdmFjYXRpb24tZ2V0YXdheS10cmF2ZWwtb2ZmZXItdGVtcGxhdGUvMTU4MzQ3YmEtMTM3Ni00MjQ4LTgwOWEtOWQ3YjRhODEyNzAyL3NvdXJjZS5tcDQifSx7ImZpbmQiOiJTMV9WSURFT18yIiwicmVwbGFjZSI6Imh0dHBzOi8vdGVtcGxhdGVzLnNob3RzdGFjay5pby92YWNhdGlvbi1nZXRhd2F5LXRyYXZlbC1vZmZlci10ZW1wbGF0ZS82NmVjNTFiMi05OWI0LTQ0MTMtOWE3OC03NDUxNTRmNzEwNmEvc291cmNlLm1wNCJ9LHsiZmluZCI6IlMxX1ZJREVPXzMiLCJyZXBsYWNlIjoiaHR0cHM6Ly90ZW1wbGF0ZXMuc2hvdHN0YWNrLmlvL3ZhY2F0aW9uLWdldGF3YXktdHJhdmVsLW9mZmVyLXRlbXBsYXRlL2E0ZWUzNzdhLTYzZTAtNGE2MC1hZWIwLWU5ODM5Nzc2OTViYi9zb3VyY2UubXA0In0seyJmaW5kIjoiUzJfU3VidGl0bGUiLCJyZXBsYWNlIjoiRGF5IDEifSx7ImZpbmQiOiJTMl9Cb2R5IiwicmVwbGFjZSI6ImV4cGxvcmluZyBhcnQgJiBjYWbDqXMgaW4gUGFyaXMifSx7ImZpbmQiOiJTMl9WSURFTyIsInJlcGxhY2UiOiJodHRwczovL3RlbXBsYXRlcy5zaG90c3RhY2suaW8vdmFjYXRpb24tZ2V0YXdheS10cmF2ZWwtb2ZmZXItdGVtcGxhdGUvOTc4ODhjZTgtOTJjNi00MmE3LWE3NzUtNTQ0OTc4OThlNmJhL3NvdXJjZS5tcDQifSx7ImZpbmQiOiJTM19TdWJ0aXRsZSIsInJlcGxhY2UiOiJEYXkgMiJ9LHsiZmluZCI6IlMzX0JvZHkiLCJyZXBsYWNlIjoiQ2FtcGluZyB1bmRlciB0aGUgTm9ydGhlcm4gTGlnaHRzIGluIEZpbmxhbmQifSx7ImZpbmQiOiJTM19WSURFTyIsInJlcGxhY2UiOiJodHRwczovL3RlbXBsYXRlcy5zaG90c3RhY2suaW8vdmFjYXRpb24tZ2V0YXdheS10cmF2ZWwtb2ZmZXItdGVtcGxhdGUvZWQ3MTUwYzYtM2Q3NS00MGZhLWEwOTItOGM1OWY0ZTU0MzQ0L3NvdXJjZS5tcDQifSx7ImZpbmQiOiJTNF9TdWJ0aXRsZSIsInJlcGxhY2UiOiJEYXkgMyJ9LHsiZmluZCI6IlM0X0JvZHkiLCJyZXBsYWNlIjoiSGlraW5nIGluIHRoZSBTd2lzcyBBbHBzIn0seyJmaW5kIjoiUzRfVklERU8iLCJyZXBsYWNlIjoiaHR0cHM6Ly90ZW1wbGF0ZXMuc2hvdHN0YWNrLmlvL3ZhY2F0aW9uLWdldGF3YXktdHJhdmVsLW9mZmVyLXRlbXBsYXRlL2Y1OTRjNjczLTBmOTItNGIyZi1iNmY0LWZiZjQzNWM1OTE5Ny9zb3VyY2UubXA0In0seyJmaW5kIjoiRk9OVF9DT0xPUiIsInJlcGxhY2UiOiIjZmZmZmZmIn0seyJmaW5kIjoiQkFDS0dST1VORF9DT0xPUiIsInJlcGxhY2UiOiIjMDI1MjZjIn0seyJmaW5kIjoiQVVESU8iLCJyZXBsYWNlIjoiaHR0cHM6Ly90ZW1wbGF0ZXMuc2hvdHN0YWNrLmlvL3ZhY2F0aW9uLWdldGF3YXktdHJhdmVsLW9mZmVyLXRlbXBsYXRlLzk0YjIwZWFhLTZhZDAtNDdhOC05Y2JiLTE1N2NjNTA3YjU2NC9zb3VyY2UubXAzIn1dfQ
- **Edit and save to an account**: https://dashboard.shotstack.io/studio/editor/vacation-getaway-travel-offer-template

## 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 |
| --- | --- |
| `{{ S1_Title }}` | My Vacation Plan |
| `{{ S1_VIDEO_1 }}` | https://templates.shotstack.io/vacation-getaway-travel-offer-template/158347ba-1376-4248-809a-9d7b4a812702/source.mp4 |
| `{{ S1_VIDEO_2 }}` | https://templates.shotstack.io/vacation-getaway-travel-offer-template/66ec51b2-99b4-4413-9a78-745154f7106a/source.mp4 |
| `{{ S1_VIDEO_3 }}` | https://templates.shotstack.io/vacation-getaway-travel-offer-template/a4ee377a-63e0-4a60-aeb0-e983977695bb/source.mp4 |
| `{{ S2_Subtitle }}` | Day 1 |
| `{{ S2_Body }}` | exploring art & cafés in Paris |
| `{{ S2_VIDEO }}` | https://templates.shotstack.io/vacation-getaway-travel-offer-template/97888ce8-92c6-42a7-a775-54497898e6ba/source.mp4 |
| `{{ S3_Subtitle }}` | Day 2 |
| `{{ S3_Body }}` | Camping under the Northern Lights in Finland |
| `{{ S3_VIDEO }}` | https://templates.shotstack.io/vacation-getaway-travel-offer-template/ed7150c6-3d75-40fa-a092-8c59f4e54344/source.mp4 |
| `{{ S4_Subtitle }}` | Day 3 |
| `{{ S4_Body }}` | Hiking in the Swiss Alps |
| `{{ S4_VIDEO }}` | https://templates.shotstack.io/vacation-getaway-travel-offer-template/f594c673-0f92-4b2f-b6f4-fbf435c59197/source.mp4 |
| `{{ FONT_COLOR }}` | #ffffff |
| `{{ BACKGROUND_COLOR }}` | #02526c |
| `{{ AUDIO }}` | https://templates.shotstack.io/vacation-getaway-travel-offer-template/94b20eaa-6ad0-47a8-9cbb-157cc507b564/source.mp3 |

## Template JSON

```json
{
  "timeline": {
    "fonts": [
      {
        "src": "https://templates.shotstack.io/vacation-getaway-travel-offer-template/6b879d9c-5408-4a56-92c2-5d6a10c2b6df/source.ttf"
      }
    ],
    "background": "#FFFFFF",
    "tracks": [
      {
        "clips": [
          {
            "length": "end",
            "asset": {
              "type": "audio",
              "src": "{{ AUDIO }}",
              "volume": 1
            },
            "start": 0
          }
        ]
      },
      {
        "clips": [
          {
            "asset": {
              "type": "text",
              "text": "{{S4_Body}}",
              "alignment": {
                "horizontal": "center",
                "vertical": "center"
              },
              "font": {
                "color": "{{ FONT_COLOR }}",
                "family": "Montserrat SemiBold",
                "size": 46,
                "lineHeight": 1
              },
              "width": 700,
              "height": 72
            },
            "start": 15.4,
            "length": "end",
            "offset": {
              "x": 0,
              "y": -0.046
            },
            "position": "center",
            "transition": {
              "out": "slideLeft"
            }
          }
        ]
      },
      {
        "clips": [
          {
            "asset": {
              "type": "text",
              "text": "{{S4_Subtitle}}",
              "alignment": {
                "horizontal": "center",
                "vertical": "center"
              },
              "font": {
                "color": "{{ FONT_COLOR }}",
                "family": "Great Vibes",
                "size": "120",
                "lineHeight": 1
              },
              "width": 400,
              "height": 200
            },
            "start": 15,
            "length": "end",
            "offset": {
              "x": 0,
              "y": 0.021
            },
            "position": "center",
            "transition": {
              "out": "slideLeft"
            }
          }
        ]
      },
      {
        "clips": [
          {
            "asset": {
              "type": "text",
              "text": "",
              "alignment": {
                "horizontal": "center",
                "vertical": "center"
              },
              "font": {
                "color": "#000000",
                "family": "Montserrat ExtraBold",
                "size": 46,
                "lineHeight": 1
              },
              "width": 200,
              "height": 200,
              "background": {
                "color": "{{ FONT_COLOR }}"
              }
            },
            "start": 15,
            "length": "end",
            "transform": {
              "rotate": {
                "angle": 180
              }
            },
            "offset": {
              "y": -0.355,
              "x": 0.278
            },
            "position": "center",
            "transition": {
              "out": "slideLeft"
            }
          },
          {
            "asset": {
              "type": "luma",
              "src": "https://templates.shotstack.io/vacation-getaway-travel-offer-template/5aa55fcc-6542-408a-ab83-5fc5c5bc561a/source.mp4"
            },
            "start": 14.6689,
            "length": "end"
          }
        ]
      },
      {
        "clips": [
          {
            "length": "end",
            "asset": {
              "type": "video",
              "src": "{{ S4_VIDEO }}"
            },
            "start": 14.6,
            "scale": 0.8,
            "transition": {
              "out": "slideLeft"
            }
          }
        ]
      },
      {
        "clips": [
          {
            "asset": {
              "type": "text",
              "text": "",
              "alignment": {
                "horizontal": "center",
                "vertical": "center"
              },
              "font": {
                "color": "#000000",
                "family": "Montserrat SemiBold",
                "size": 24,
                "lineHeight": 1
              },
              "width": 902,
              "height": 1576,
              "background": {
                "color": "{{ FONT_COLOR }}",
                "opacity": 0.87
              }
            },
            "start": 14.6,
            "length": "end",
            "position": "center",
            "transition": {
              "in": "slideLeft"
            }
          }
        ]
      },
      {
        "clips": [
          {
            "asset": {
              "type": "text",
              "text": "{{S3_Body}}",
              "alignment": {
                "horizontal": "right",
                "vertical": "center"
              },
              "font": {
                "color": "{{ FONT_COLOR }}",
                "family": "Montserrat SemiBold",
                "size": 46,
                "lineHeight": 1
              },
              "width": 700,
              "height": 72
            },
            "start": 10.6,
            "length": 4,
            "offset": {
              "x": 0.034,
              "y": -0.342
            },
            "position": "center",
            "transition": {
              "out": "slideLeft",
              "in": "slideLeft"
            }
          }
        ]
      },
      {
        "clips": [
          {
            "asset": {
              "type": "text",
              "text": "{{S3_Subtitle}}",
              "alignment": {
                "horizontal": "center",
                "vertical": "center"
              },
              "font": {
                "color": "{{ FONT_COLOR }}",
                "family": "Great Vibes",
                "size": "120",
                "lineHeight": 1
              },
              "width": 400,
              "height": 200
            },
            "start": 10.2,
            "length": 4.4,
            "offset": {
              "x": 0.209,
              "y": -0.271
            },
            "position": "center",
            "transition": {
              "in": "slideLeft",
              "out": "slideLeft"
            }
          }
        ]
      },
      {
        "clips": [
          {
            "asset": {
              "type": "text",
              "text": "",
              "alignment": {
                "horizontal": "center",
                "vertical": "center"
              },
              "font": {
                "color": "#000000",
                "family": "Montserrat ExtraBold",
                "size": 46,
                "lineHeight": 1
              },
              "width": 200,
              "height": 200,
              "background": {
                "color": "{{ FONT_COLOR }}"
              }
            },
            "start": 10.2,
            "length": 4.4,
            "offset": {
              "x": -0.29,
              "y": -0.271
            },
            "position": "center",
            "transition": {
              "out": "slideLeft",
              "in": "slideLeft"
            }
          },
          {
            "asset": {
              "type": "luma",
              "src": "https://templates.shotstack.io/vacation-getaway-travel-offer-template/ba38a100-4616-420c-9180-87b33deaf67c/source.mp4"
            },
            "start": 9.9,
            "length": 4.8
          }
        ]
      },
      {
        "clips": [
          {
            "length": 4.8,
            "asset": {
              "type": "video",
              "src": "{{ S4_VIDEO }}",
              "volume": 0
            },
            "start": 9.8,
            "scale": 0.8,
            "transition": {
              "in": "slideLeft",
              "out": "slideLeft"
            }
          }
        ]
      },
      {
        "clips": [
          {
            "asset": {
              "type": "text",
              "text": "",
              "alignment": {
                "horizontal": "center",
                "vertical": "center"
              },
              "font": {
                "color": "#000000",
                "family": "Montserrat SemiBold",
                "size": 24,
                "lineHeight": 1
              },
              "width": 902,
              "height": 1682,
              "background": {
                "color": "{{ FONT_COLOR }}",
                "opacity": 0.87
              }
            },
            "start": 9.8,
            "length": 4.8,
            "position": "center",
            "transition": {
              "out": "slideLeft",
              "in": "slideLeft"
            }
          }
        ]
      },
      {
        "clips": [
          {
            "asset": {
              "type": "text",
              "text": "{{S2_Body}}",
              "alignment": {
                "horizontal": "left",
                "vertical": "center"
              },
              "font": {
                "color": "{{ FONT_COLOR }}",
                "family": "Montserrat SemiBold",
                "size": 46,
                "lineHeight": 1
              },
              "width": 700,
              "height": 72
            },
            "start": 5.8,
            "length": 4,
            "offset": {
              "x": -0.021,
              "y": -0.332
            },
            "position": "center",
            "transition": {
              "in": "slideLeft",
              "out": "slideLeft"
            }
          }
        ]
      },
      {
        "clips": [
          {
            "asset": {
              "type": "text",
              "text": "{{S2_Subtitle}}",
              "alignment": {
                "horizontal": "center",
                "vertical": "center"
              },
              "font": {
                "color": "{{ FONT_COLOR }}",
                "family": "Great Vibes",
                "size": "120",
                "lineHeight": 1
              },
              "width": 400,
              "height": 200
            },
            "start": 5.4,
            "length": 4.4,
            "offset": {
              "x": -0.215,
              "y": -0.252
            },
            "position": "center",
            "transition": {
              "out": "slideLeft",
              "in": "slideLeft"
            }
          }
        ]
      },
      {
        "clips": [
          {
            "asset": {
              "type": "text",
              "text": "",
              "alignment": {
                "horizontal": "center",
                "vertical": "center"
              },
              "font": {
                "color": "#000000",
                "family": "Montserrat ExtraBold",
                "size": 46,
                "lineHeight": 1
              },
              "width": 200,
              "height": 200,
              "background": {
                "color": "{{ FONT_COLOR }}"
              }
            },
            "start": 5.4,
            "length": 4.4,
            "transform": {
              "rotate": {
                "angle": 180
              }
            },
            "offset": {
              "x": 0.288,
              "y": -0.258
            },
            "position": "center",
            "transition": {
              "in": "slideLeft",
              "out": "slideLeft"
            }
          },
          {
            "asset": {
              "type": "luma",
              "src": "https://templates.shotstack.io/vacation-getaway-travel-offer-template/bcd0f012-dfea-47b5-9e06-50f69352c483/source.mp4"
            },
            "start": 5.06,
            "length": 4.74
          }
        ]
      },
      {
        "clips": [
          {
            "length": 4.8,
            "asset": {
              "type": "video",
              "src": "{{ S2_VIDEO }}",
              "volume": 0
            },
            "start": 5,
            "scale": 0.8,
            "transition": {
              "out": "slideLeft",
              "in": "slideLeft"
            }
          }
        ]
      },
      {
        "clips": [
          {
            "asset": {
              "type": "text",
              "text": "",
              "alignment": {
                "horizontal": "center",
                "vertical": "center"
              },
              "font": {
                "color": "#000000",
                "family": "Montserrat SemiBold",
                "size": 24,
                "lineHeight": 1
              },
              "width": 902,
              "height": 1576,
              "background": {
                "color": "{{ FONT_COLOR }}",
                "opacity": 0.87
              }
            },
            "start": 5,
            "length": 4.8,
            "position": "center",
            "transition": {
              "in": "slideLeft",
              "out": "slideLeft"
            }
          }
        ]
      },
      {
        "clips": [
          {
            "asset": {
              "type": "text",
              "text": "{{S1_Title}}",
              "alignment": {
                "horizontal": "center",
                "vertical": "center"
              },
              "font": {
                "color": "{{ FONT_COLOR }}",
                "family": "Great Vibes",
                "size": "120",
                "lineHeight": 1
              },
              "width": 600,
              "height": 300,
              "background": {
                "opacity": 0.12
              }
            },
            "start": 1,
            "length": 4,
            "transition": {
              "out": "fade",
              "in": "fade"
            }
          }
        ]
      },
      {
        "clips": [
          {
            "asset": {
              "type": "text",
              "text": "",
              "alignment": {
                "horizontal": "center",
                "vertical": "center"
              },
              "font": {
                "color": "#000000",
                "family": "Montserrat ExtraBold",
                "size": 46,
                "lineHeight": 1
              },
              "width": 250,
              "height": 250,
              "background": {
                "color": "{{ FONT_COLOR }}"
              }
            },
            "start": 0.7,
            "length": 4.3,
            "offset": {
              "x": -0.347,
              "y": 0.435
            },
            "position": "center"
          },
          {
            "asset": {
              "type": "luma",
              "src": "https://templates.shotstack.io/vacation-getaway-travel-offer-template/ecd7cd9e-ea73-4294-b340-8ac1806e7527/source.mp4"
            },
            "start": 0,
            "length": 5
          }
        ]
      },
      {
        "clips": [
          {
            "length": 4.32,
            "asset": {
              "type": "video",
              "src": "{{ S1_VIDEO_1 }}",
              "volume": 0
            },
            "start": 0.7,
            "scale": 0.3,
            "offset": {
              "x": 0,
              "y": -0.325
            },
            "position": "center",
            "transition": {
              "in": "slideRight",
              "out": "slideLeft"
            }
          }
        ]
      },
      {
        "clips": [
          {
            "length": 4.6,
            "asset": {
              "type": "video",
              "src": "{{ S1_VIDEO_2 }}",
              "volume": 0
            },
            "start": 0.4,
            "scale": 0.3,
            "transition": {
              "out": "slideLeft",
              "in": "slideRight"
            }
          }
        ]
      },
      {
        "clips": [
          {
            "asset": {
              "type": "text",
              "text": "",
              "alignment": {
                "horizontal": "center",
                "vertical": "center"
              },
              "font": {
                "color": "#000000",
                "family": "Montserrat ExtraBold",
                "size": 46,
                "lineHeight": 1
              },
              "width": 250,
              "height": 250,
              "background": {
                "color": "{{ FONT_COLOR }}"
              }
            },
            "start": 0,
            "length": 5,
            "offset": {
              "x": -0.347,
              "y": 0.435
            },
            "position": "center"
          },
          {
            "asset": {
              "type": "luma",
              "src": "https://templates.shotstack.io/vacation-getaway-travel-offer-template/a4a871ff-1763-471b-ab4a-75dfe5700269/source.mp4"
            },
            "start": 0,
            "length": 5
          }
        ]
      },
      {
        "clips": [
          {
            "length": 5,
            "asset": {
              "type": "video",
              "src": "{{ S1_VIDEO_3 }}",
              "volume": 0
            },
            "start": 0,
            "scale": 0.3,
            "offset": {
              "x": 0,
              "y": 0.321
            },
            "position": "center",
            "transition": {
              "in": "slideRight",
              "out": "slideLeft"
            }
          }
        ]
      },
      {
        "clips": [
          {
            "asset": {
              "type": "text",
              "text": "",
              "alignment": {
                "horizontal": "center",
                "vertical": "center"
              },
              "font": {
                "color": "#000000",
                "family": "Montserrat SemiBold",
                "size": 24,
                "lineHeight": 1
              },
              "width": 1080,
              "height": 1920,
              "background": {
                "color": "{{ BACKGROUND_COLOR }}"
              }
            },
            "start": 0,
            "length": 20,
            "position": "center"
          }
        ]
      }
    ]
  },
  "output": {
    "format": "mp4",
    "fps": 25,
    "size": {
      "width": 1080,
      "height": 1920
    }
  },
  "merge": [
    {
      "find": "S1_Title",
      "replace": "My Vacation Plan"
    },
    {
      "find": "S1_VIDEO_1",
      "replace": "https://templates.shotstack.io/vacation-getaway-travel-offer-template/158347ba-1376-4248-809a-9d7b4a812702/source.mp4"
    },
    {
      "find": "S1_VIDEO_2",
      "replace": "https://templates.shotstack.io/vacation-getaway-travel-offer-template/66ec51b2-99b4-4413-9a78-745154f7106a/source.mp4"
    },
    {
      "find": "S1_VIDEO_3",
      "replace": "https://templates.shotstack.io/vacation-getaway-travel-offer-template/a4ee377a-63e0-4a60-aeb0-e983977695bb/source.mp4"
    },
    {
      "find": "S2_Subtitle",
      "replace": "Day 1"
    },
    {
      "find": "S2_Body",
      "replace": "exploring art & cafés in Paris"
    },
    {
      "find": "S2_VIDEO",
      "replace": "https://templates.shotstack.io/vacation-getaway-travel-offer-template/97888ce8-92c6-42a7-a775-54497898e6ba/source.mp4"
    },
    {
      "find": "S3_Subtitle",
      "replace": "Day 2"
    },
    {
      "find": "S3_Body",
      "replace": "Camping under the Northern Lights in Finland"
    },
    {
      "find": "S3_VIDEO",
      "replace": "https://templates.shotstack.io/vacation-getaway-travel-offer-template/ed7150c6-3d75-40fa-a092-8c59f4e54344/source.mp4"
    },
    {
      "find": "S4_Subtitle",
      "replace": "Day 3"
    },
    {
      "find": "S4_Body",
      "replace": "Hiking in the Swiss Alps"
    },
    {
      "find": "S4_VIDEO",
      "replace": "https://templates.shotstack.io/vacation-getaway-travel-offer-template/f594c673-0f92-4b2f-b6f4-fbf435c59197/source.mp4"
    },
    {
      "find": "FONT_COLOR",
      "replace": "#ffffff"
    },
    {
      "find": "BACKGROUND_COLOR",
      "replace": "#02526c"
    },
    {
      "find": "AUDIO",
      "replace": "https://templates.shotstack.io/vacation-getaway-travel-offer-template/94b20eaa-6ad0-47a8-9cbb-157cc507b564/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