# Travel Diary Adventure Promotion Template (video template)

> Promote your next travel sale or tour package with our engaging 'Travel Diary' promotion template. Perfect for travel agencies and tour operators.

## Overview

- **Page**: https://shotstack.io/studio/templates/travel-diary-adventure-promo-template/
- **Output**: MP4, 1080x1920 (9:16), 25 fps
- **Length**: 5s
- **Timeline**: 26 clips on 21 tracks; assets: audio, image, 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=eyJ0aW1lbGluZSI6eyJmb250cyI6W3sic3JjIjoiaHR0cHM6Ly90ZW1wbGF0ZXMuc2hvdHN0YWNrLmlvL3RyYXZlbC1kaWFyeS1hZHZlbnR1cmUtcHJvbW8tdGVtcGxhdGUvOWVmYTRlYjItOGEyMC00ZjkwLWE3M2UtZGQ4MWFjMmMxODBlL3NvdXJjZS50dGYifV0sImJhY2tncm91bmQiOiIjRkZGRkZGIiwidHJhY2tzIjpbeyJjbGlwcyI6W3sibGVuZ3RoIjoiZW5kIiwiYXNzZXQiOnsidHlwZSI6ImF1ZGlvIiwic3JjIjoie3sgQVVESU8gfX0iLCJ2b2x1bWUiOjF9LCJzdGFydCI6MH1dfSx7ImNsaXBzIjpbeyJhc3NldCI6eyJ0eXBlIjoidGV4dCIsInRleHQiOiJ7e1N1YnRpdGxlfX0iLCJhbGlnbm1lbnQiOnsiaG9yaXpvbnRhbCI6ImNlbnRlciIsInZlcnRpY2FsIjoiY2VudGVyIn0sImZvbnQiOnsiY29sb3IiOiJ7eyBCQUNLR1JPVU5EX0NPTE9SIH19IiwiZmFtaWx5IjoiTW9udHNlcnJhdCBTZW1pQm9sZCIsInNpemUiOiIzMCIsImxpbmVIZWlnaHQiOjF9LCJ3aWR0aCI6NTAwLCJoZWlnaHQiOjEwMH0sInN0YXJ0IjowLjIsImxlbmd0aCI6ImVuZCIsIm9mZnNldCI6eyJ4IjowLCJ5IjowLjI3NH0sInBvc2l0aW9uIjoiY2VudGVyIiwidHJhbnNpdGlvbiI6eyJpbiI6InNsaWRlVXAifX1dfSx7ImNsaXBzIjpbeyJhc3NldCI6eyJ0eXBlIjoidGV4dCIsInRleHQiOiIge3tQbGFjZV80fX0iLCJhbGlnbm1lbnQiOnsiaG9yaXpvbnRhbCI6ImNlbnRlciIsInZlcnRpY2FsIjoiY2VudGVyIn0sImZvbnQiOnsiY29sb3IiOiJ7eyBGT05UX0NPTE9SXzIgfX0iLCJmYW1pbHkiOiJNb250c2VycmF0IFNlbWlCb2xkIiwic2l6ZSI6MjQsImxpbmVIZWlnaHQiOjF9LCJ3aWR0aCI6NDAwLCJoZWlnaHQiOjcyfSwic3RhcnQiOjAuNjUsImxlbmd0aCI6ImVuZCIsIm9mZnNldCI6eyJ4IjowLjEyNSwieSI6LTAuMjMyfSwicG9zaXRpb24iOiJjZW50ZXIiLCJ0cmFuc2Zvcm0iOnsicm90YXRlIjp7ImFuZ2xlIjoxMH19LCJ0cmFuc2l0aW9uIjp7ImluIjoiZmFkZSJ9fV19LHsiY2xpcHMiOlt7ImFzc2V0Ijp7InR5cGUiOiJ0ZXh0IiwidGV4dCI6Int7UGxhY2VfM319IiwiYWxpZ25tZW50Ijp7Imhvcml6b250YWwiOiJjZW50ZXIiLCJ2ZXJ0aWNhbCI6ImNlbnRlciJ9LCJmb250Ijp7ImNvbG9yIjoie3sgRk9OVF9DT0xPUl8yIH19IiwiZmFtaWx5IjoiTW9udHNlcnJhdCBTZW1pQm9sZCIsInNpemUiOjI0LCJsaW5lSGVpZ2h0IjoxfSwid2lkdGgiOjQwMCwiaGVpZ2h0Ijo3Mn0sInN0YXJ0IjowLjU1LCJsZW5ndGgiOiJlbmQiLCJvZmZzZXQiOnsieCI6LTAuMjMxLCJ5IjotMC4xNjV9LCJwb3NpdGlvbiI6ImNlbnRlciIsInRyYW5zZm9ybSI6eyJyb3RhdGUiOnsiYW5nbGUiOi0xMn19LCJ0cmFuc2l0aW9uIjp7ImluIjoiZmFkZSJ9fV19LHsiY2xpcHMiOlt7ImFzc2V0Ijp7InR5cGUiOiJ0ZXh0IiwidGV4dCI6Int7UGxhY2VfM319IiwiYWxpZ25tZW50Ijp7Imhvcml6b250YWwiOiJjZW50ZXIiLCJ2ZXJ0aWNhbCI6ImNlbnRlciJ9LCJmb250Ijp7ImNvbG9yIjoie3sgRk9OVF9DT0xPUl8yIH19IiwiZmFtaWx5IjoiTW9udHNlcnJhdCBTZW1pQm9sZCIsInNpemUiOjI0LCJsaW5lSGVpZ2h0IjoxfSwid2lkdGgiOjQwMCwiaGVpZ2h0Ijo3Mn0sInN0YXJ0IjowLjQ1LCJsZW5ndGgiOiJlbmQiLCJvZmZzZXQiOnsieCI6MC4yMDQsInkiOjAuMDMzfSwicG9zaXRpb24iOiJjZW50ZXIiLCJ0cmFuc2Zvcm0iOnsicm90YXRlIjp7ImFuZ2xlIjo4fX19XX0seyJjbGlwcyI6W3siYXNzZXQiOnsidHlwZSI6InRleHQiLCJ0ZXh0IjoiIHt7UGxhY2VfMX19IiwiYWxpZ25tZW50Ijp7Imhvcml6b250YWwiOiJjZW50ZXIiLCJ2ZXJ0aWNhbCI6ImNlbnRlciJ9LCJmb250Ijp7ImNvbG9yIjoie3sgRk9OVF9DT0xPUl8yIH19IiwiZmFtaWx5IjoiTW9udHNlcnJhdCBTZW1pQm9sZCIsInNpemUiOjI0LCJsaW5lSGVpZ2h0IjoxfSwid2lkdGgiOjQwMCwiaGVpZ2h0Ijo3Mn0sInN0YXJ0IjowLjM1LCJsZW5ndGgiOiJlbmQiLCJvZmZzZXQiOnsieCI6LTAuMjEzLCJ5IjowLjAzOH0sInBvc2l0aW9uIjoiY2VudGVyIiwidHJhbnNmb3JtIjp7InJvdGF0ZSI6eyJhbmdsZSI6LTR9fX1dfSx7ImNsaXBzIjpbeyJhc3NldCI6eyJ0eXBlIjoibHVtYSIsInNyYyI6Imh0dHBzOi8vdGVtcGxhdGVzLnNob3RzdGFjay5pby90cmF2ZWwtZGlhcnktYWR2ZW50dXJlLXByb21vLXRlbXBsYXRlL2U1ZTJiMWNmLTMxZmUtNDkzOS1iMTVkLWNkMmEzYTE0ZDQxZi9zb3VyY2UucG5nIn0sInN0YXJ0IjowLCJsZW5ndGgiOiJlbmQifSx7Imxlbmd0aCI6ImVuZCIsImFzc2V0Ijp7InR5cGUiOiJpbWFnZSIsInNyYyI6Int7IEZsYWcgfX0ifSwic3RhcnQiOjAuNywic2NhbGUiOjAuMiwib2Zmc2V0Ijp7IngiOi0wLjI4NSwieSI6LTAuMjY1fSwicG9zaXRpb24iOiJjZW50ZXIiLCJ0cmFuc2l0aW9uIjp7ImluIjoiZmFkZSJ9fV19LHsiY2xpcHMiOlt7Imxlbmd0aCI6ImVuZCIsImFzc2V0Ijp7InR5cGUiOiJ2aWRlbyIsInNyYyI6Int7IFZJREVPXzQgfX0iLCJ2b2x1bWUiOjF9LCJzdGFydCI6MC42LCJzY2FsZSI6MC4xNiwidHJhbnNmb3JtIjp7InJvdGF0ZSI6eyJhbmdsZSI6MTB9fSwib2Zmc2V0Ijp7IngiOjAuMTUxLCJ5IjotMC4xNDJ9LCJwb3NpdGlvbiI6ImNlbnRlciIsInRyYW5zaXRpb24iOnsiaW4iOiJjYXJvdXNlbExlZnQifX1dfSx7ImNsaXBzIjpbeyJhc3NldCI6eyJ0eXBlIjoidGV4dCIsInRleHQiOiIiLCJhbGlnbm1lbnQiOnsiaG9yaXpvbnRhbCI6ImNlbnRlciIsInZlcnRpY2FsIjoiY2VudGVyIn0sImZvbnQiOnsiY29sb3IiOiIjMDAwMDAwIiwiZmFtaWx5IjoiTW9udHNlcnJhdCBTZW1pQm9sZCIsInNpemUiOjI0LCJsaW5lSGVpZ2h0IjoxfSwid2lkdGgiOjQ0MiwiaGVpZ2h0IjozNzAsImJhY2tncm91bmQiOnsiY29sb3IiOiJ7eyBGT05UX0NPTE9SXzEgfX0ifX0sInN0YXJ0IjowLjYsImxlbmd0aCI6ImVuZCIsIm9mZnNldCI6eyJ4IjowLjE1MSwieSI6LTAuMTV9LCJwb3NpdGlvbiI6ImNlbnRlciIsInRyYW5zZm9ybSI6eyJyb3RhdGUiOnsiYW5nbGUiOjEwfX0sInRyYW5zaXRpb24iOnsiaW4iOiJjYXJvdXNlbExlZnQifX1dfSx7ImNsaXBzIjpbeyJsZW5ndGgiOiJlbmQiLCJhc3NldCI6eyJ0eXBlIjoidmlkZW8iLCJzcmMiOiJ7eyBWSURFT18zIH19Iiwidm9sdW1lIjoxfSwic3RhcnQiOjAuNSwic2NhbGUiOjAuMTYsInRyYW5zZm9ybSI6eyJyb3RhdGUiOnsiYW5nbGUiOi0xMn19LCJvZmZzZXQiOnsieCI6LTAuMjY1LCJ5IjotMC4wNzR9LCJwb3NpdGlvbiI6ImNlbnRlciIsInRyYW5zaXRpb24iOnsiaW4iOiJjYXJvdXNlbFJpZ2h0In19XX0seyJjbGlwcyI6W3siYXNzZXQiOnsidHlwZSI6InRleHQiLCJ0ZXh0IjoiIiwiYWxpZ25tZW50Ijp7Imhvcml6b250YWwiOiJjZW50ZXIiLCJ2ZXJ0aWNhbCI6ImNlbnRlciJ9LCJmb250Ijp7ImNvbG9yIjoiIzAwMDAwMCIsImZhbWlseSI6Ik1vbnRzZXJyYXQgU2VtaUJvbGQiLCJzaXplIjoyNCwibGluZUhlaWdodCI6MX0sIndpZHRoIjo0NDIsImhlaWdodCI6MzcwLCJiYWNrZ3JvdW5kIjp7ImNvbG9yIjoie3sgRk9OVF9DT0xPUl8xIH19In19LCJzdGFydCI6MC41LCJsZW5ndGgiOiJlbmQiLCJvZmZzZXQiOnsieCI6LTAuMjU4LCJ5IjotMC4wODJ9LCJwb3NpdGlvbiI6ImNlbnRlciIsInRyYW5zZm9ybSI6eyJyb3RhdGUiOnsiYW5nbGUiOi0xMn19LCJ0cmFuc2l0aW9uIjp7ImluIjoiY2Fyb3VzZWxSaWdodCJ9fV19LHsiY2xpcHMiOlt7Imxlbmd0aCI6ImVuZCIsImFzc2V0Ijp7InR5cGUiOiJ2aWRlbyIsInNyYyI6Int7IFZJREVPXzIgfX0iLCJ2b2x1bWUiOjF9LCJzdGFydCI6MC40LCJzY2FsZSI6MC4xNiwib2Zmc2V0Ijp7IngiOjAuMjQsInkiOjAuMTI1fSwicG9zaXRpb24iOiJjZW50ZXIiLCJ0cmFuc2Zvcm0iOnsicm90YXRlIjp7ImFuZ2xlIjo4fX19XX0seyJjbGlwcyI6W3siYXNzZXQiOnsidHlwZSI6InRleHQiLCJ0ZXh0IjoiIiwiYWxpZ25tZW50Ijp7Imhvcml6b250YWwiOiJjZW50ZXIiLCJ2ZXJ0aWNhbCI6ImNlbnRlciJ9LCJmb250Ijp7ImNvbG9yIjoiIzAwMDAwMCIsImZhbWlseSI6Ik1vbnRzZXJyYXQgU2VtaUJvbGQiLCJzaXplIjoyNCwibGluZUhlaWdodCI6MX0sIndpZHRoIjo0NDIsImhlaWdodCI6MzcwLCJiYWNrZ3JvdW5kIjp7ImNvbG9yIjoie3sgRk9OVF9DT0xPUl8xIH19In19LCJzdGFydCI6MC40LCJsZW5ndGgiOiJlbmQiLCJvZmZzZXQiOnsieCI6MC4yNCwieSI6MC4xMTZ9LCJwb3NpdGlvbiI6ImNlbnRlciIsInRyYW5zZm9ybSI6eyJyb3RhdGUiOnsiYW5nbGUiOjh9fX1dfSx7ImNsaXBzIjpbeyJsZW5ndGgiOiJlbmQiLCJhc3NldCI6eyJ0eXBlIjoidmlkZW8iLCJzcmMiOiJ7eyBWSURFT18xIH19Iiwidm9sdW1lIjoxfSwic3RhcnQiOjAuMywic2NhbGUiOjAuMTYsIm9mZnNldCI6eyJ4IjotMC4yMTUsInkiOjAuMTMyfSwicG9zaXRpb24iOiJjZW50ZXIiLCJ0cmFuc2Zvcm0iOnsicm90YXRlIjp7ImFuZ2xlIjotNH19LCJ0cmFuc2l0aW9uIjp7ImluIjoiY2Fyb3VzZWxSaWdodCJ9fV19LHsiY2xpcHMiOlt7ImFzc2V0Ijp7InR5cGUiOiJ0ZXh0IiwidGV4dCI6IiIsImFsaWdubWVudCI6eyJob3Jpem9udGFsIjoiY2VudGVyIiwidmVydGljYWwiOiJjZW50ZXIifSwiZm9udCI6eyJjb2xvciI6IiMwMDAwMDAiLCJmYW1pbHkiOiJNb250c2VycmF0IFNlbWlCb2xkIiwic2l6ZSI6MjQsImxpbmVIZWlnaHQiOjF9LCJ3aWR0aCI6NDQyLCJoZWlnaHQiOjM3MCwiYmFja2dyb3VuZCI6eyJjb2xvciI6Int7IEZPTlRfQ09MT1JfMSB9fSJ9fSwic3RhcnQiOjAuMywibGVuZ3RoIjoiZW5kIiwib2Zmc2V0Ijp7IngiOi0wLjIxNSwieSI6MC4xMjV9LCJwb3NpdGlvbiI6ImNlbnRlciIsInRyYW5zZm9ybSI6eyJyb3RhdGUiOnsiYW5nbGUiOi00fX0sInRyYW5zaXRpb24iOnsiaW4iOiJjYXJvdXNlbFJpZ2h0In19XX0seyJjbGlwcyI6W3siYXNzZXQiOnsidHlwZSI6InRleHQiLCJ0ZXh0Ijoie3tUaXRsZX19IiwiYWxpZ25tZW50Ijp7Imhvcml6b250YWwiOiJjZW50ZXIiLCJ2ZXJ0aWNhbCI6ImNlbnRlciJ9LCJmb250Ijp7ImNvbG9yIjoie3sgRk9OVF9DT0xPUl8xIH19IiwiZmFtaWx5IjoiQmxvdyIsInNpemUiOiIxNTAiLCJsaW5lSGVpZ2h0IjoxfSwid2lkdGgiOjEwMDAsImhlaWdodCI6MjUwfSwic3RhcnQiOjAsImxlbmd0aCI6ImVuZCIsIm9mZnNldCI6eyJ4IjowLCJ5IjowLjM5N30sInBvc2l0aW9uIjoiY2VudGVyIiwidHJhbnNpdGlvbiI6eyJpbiI6InNsaWRlRG93biJ9fV19LHsiY2xpcHMiOlt7ImFzc2V0Ijp7InR5cGUiOiJsdW1hIiwic3JjIjoiaHR0cHM6Ly90ZW1wbGF0ZXMuc2hvdHN0YWNrLmlvL3RyYXZlbC1kaWFyeS1hZHZlbnR1cmUtcHJvbW8tdGVtcGxhdGUvNDZjY2NhMTgtMzkzZi00ODc0LTg3ZDgtOGZmMTAwNDE0MWU3L3NvdXJjZS5wbmcifSwic3RhcnQiOjAsImxlbmd0aCI6NX0seyJhc3NldCI6eyJ0eXBlIjoidGV4dCIsInRleHQiOiIiLCJhbGlnbm1lbnQiOnsiaG9yaXpvbnRhbCI6ImNlbnRlciIsInZlcnRpY2FsIjoiY2VudGVyIn0sImZvbnQiOnsiY29sb3IiOiIjMDAwMDAwIiwiZmFtaWx5IjoiTW9udHNlcnJhdCBTZW1pQm9sZCIsInNpemUiOjI0LCJsaW5lSGVpZ2h0IjoxfSwid2lkdGgiOjQ0MSwiaGVpZ2h0Ijo1MDAsImJhY2tncm91bmQiOnsiY29sb3IiOiIjZmZmZmZmIn19LCJzdGFydCI6MC44LCJsZW5ndGgiOiJlbmQiLCJvZmZzZXQiOnsieCI6MCwieSI6LTAuMzcyfSwicG9zaXRpb24iOiJjZW50ZXIiLCJ0cmFuc2l0aW9uIjp7ImluIjoiY2Fyb3VzZWxVcCJ9fV19LHsiY2xpcHMiOlt7ImFzc2V0Ijp7InR5cGUiOiJ0ZXh0IiwidGV4dCI6IiB7e0NUQX19IiwiYWxpZ25tZW50Ijp7Imhvcml6b250YWwiOiJjZW50ZXIiLCJ2ZXJ0aWNhbCI6ImNlbnRlciJ9LCJmb250Ijp7ImNvbG9yIjoie3sgRk9OVF9DT0xPUl8yIH19IiwiZmFtaWx5IjoiTW9udHNlcnJhdCBFeHRyYUJvbGQiLCJzaXplIjoiNDQiLCJsaW5lSGVpZ2h0IjoxfSwid2lkdGgiOjQyNiwiaGVpZ2h0Ijo5MywiYmFja2dyb3VuZCI6eyJjb2xvciI6Int7IFNIQVBFX0NPTE9SXzIgfX0iLCJib3JkZXJSYWRpdXMiOjExLCJwYWRkaW5nIjoxNX19LCJzdGFydCI6MC44LCJsZW5ndGgiOiJlbmQiLCJvZmZzZXQiOnsieCI6MCwieSI6LTAuMzcyfSwicG9zaXRpb24iOiJjZW50ZXIiLCJ0cmFuc2l0aW9uIjp7ImluIjoiY2Fyb3VzZWxVcCJ9fV19LHsiY2xpcHMiOlt7ImFzc2V0Ijp7InR5cGUiOiJsdW1hIiwic3JjIjoiaHR0cHM6Ly90ZW1wbGF0ZXMuc2hvdHN0YWNrLmlvL3RyYXZlbC1kaWFyeS1hZHZlbnR1cmUtcHJvbW8tdGVtcGxhdGUvYjAxMzcyNzctZjUzNS00Y2ViLTk1ODUtZGYwMWJlZmJiMGViL3NvdXJjZS5wbmcifSwic3RhcnQiOjAsImxlbmd0aCI6ImVuZCJ9LHsiYXNzZXQiOnsidHlwZSI6InRleHQiLCJ0ZXh0IjoiIiwiYWxpZ25tZW50Ijp7Imhvcml6b250YWwiOiJjZW50ZXIiLCJ2ZXJ0aWNhbCI6ImNlbnRlciJ9LCJmb250Ijp7ImNvbG9yIjoiIzAwMDAwMCIsImZhbWlseSI6Ik1vbnRzZXJyYXQgU2VtaUJvbGQiLCJzaXplIjoyNCwibGluZUhlaWdodCI6MX0sIndpZHRoIjo5MDMsImhlaWdodCI6ODIyLCJiYWNrZ3JvdW5kIjp7ImNvbG9yIjoie3sgU0hBUEVfQ09MT1JfMSB9fSJ9fSwic3RhcnQiOjAuMSwibGVuZ3RoIjoiZW5kIiwib2Zmc2V0Ijp7IngiOjAsInkiOi0wLjE0Mn0sInBvc2l0aW9uIjoiY2VudGVyIiwidHJhbnNpdGlvbiI6eyJpbiI6InNsaWRlVXAifX1dfSx7ImNsaXBzIjpbeyJhc3NldCI6eyJ0eXBlIjoibHVtYSIsInNyYyI6Imh0dHBzOi8vdGVtcGxhdGVzLnNob3RzdGFjay5pby90cmF2ZWwtZGlhcnktYWR2ZW50dXJlLXByb21vLXRlbXBsYXRlLzk2OTA5ZjEzLWQzMjEtNGEzZi1hNmUzLTk3YjU3MjcwNzY4OC9zb3VyY2UucG5nIn0sInN0YXJ0IjowLCJsZW5ndGgiOjV9LHsiYXNzZXQiOnsidHlwZSI6InRleHQiLCJ0ZXh0IjoiIiwiYWxpZ25tZW50Ijp7Imhvcml6b250YWwiOiJjZW50ZXIiLCJ2ZXJ0aWNhbCI6ImNlbnRlciJ9LCJmb250Ijp7ImNvbG9yIjoiIzAwMDAwMCIsImZhbWlseSI6Ik1vbnRzZXJyYXQgU2VtaUJvbGQiLCJzaXplIjoyNCwibGluZUhlaWdodCI6MX0sIndpZHRoIjo5MDMsImhlaWdodCI6ODIyLCJiYWNrZ3JvdW5kIjp7ImNvbG9yIjoie3sgU0hBUEVfQ09MT1JfMSB9fSJ9fSwic3RhcnQiOjAuMSwibGVuZ3RoIjoiZW5kIiwib2Zmc2V0Ijp7IngiOjAsInkiOjAuMTQ4fSwicG9zaXRpb24iOiJjZW50ZXIiLCJ0cmFuc2l0aW9uIjp7ImluIjoic2xpZGVVcCJ9fV19LHsiY2xpcHMiOlt7ImFzc2V0Ijp7InR5cGUiOiJ0ZXh0IiwidGV4dCI6IiIsImFsaWdubWVudCI6eyJob3Jpem9udGFsIjoiY2VudGVyIiwidmVydGljYWwiOiJjZW50ZXIifSwiZm9udCI6eyJjb2xvciI6IiMwMDAwMDAiLCJmYW1pbHkiOiJNb250c2VycmF0IFNlbWlCb2xkIiwic2l6ZSI6MjQsImxpbmVIZWlnaHQiOjF9LCJ3aWR0aCI6MTA4MCwiaGVpZ2h0IjoxOTIwLCJiYWNrZ3JvdW5kIjp7ImNvbG9yIjoie3sgQkFDS0dST1VORF9DT0xPUiB9fSJ9fSwic3RhcnQiOjAsImxlbmd0aCI6NSwicG9zaXRpb24iOiJjZW50ZXIifSx7ImFzc2V0Ijp7InR5cGUiOiJsdW1hIiwic3JjIjoiaHR0cHM6Ly90ZW1wbGF0ZXMuc2hvdHN0YWNrLmlvL3RyYXZlbC1kaWFyeS1hZHZlbnR1cmUtcHJvbW8tdGVtcGxhdGUvYTIxN2Y2NmItZjkxMS00YzA0LTkwMjktNDI5Y2FiZjUyZTVjL3NvdXJjZS5tcDQifSwic3RhcnQiOjAsImxlbmd0aCI6NX1dfV19LCJvdXRwdXQiOnsiZm9ybWF0IjoibXA0IiwiZnBzIjoyNSwic2l6ZSI6eyJ3aWR0aCI6MTA4MCwiaGVpZ2h0IjoxOTIwfX0sIm1lcmdlIjpbeyJmaW5kIjoiVGl0bGUiLCJyZXBsYWNlIjoiVFJBVkVMIERJQVJZIn0seyJmaW5kIjoiU3VidGl0bGUiLCJyZXBsYWNlIjoiU0hPVyBPTkU6IEEgVE9VUiBJTiBORVcgWkVFTEFORCJ9LHsiZmluZCI6IlBsYWNlXzEiLCJyZXBsYWNlIjoiQXVja2xhbmQifSx7ImZpbmQiOiJQbGFjZV8yIiwicmVwbGFjZSI6IlF1ZWVuc3Rvd24ifSx7ImZpbmQiOiJQbGFjZV8zIiwicmVwbGFjZSI6IlJvdG9ydWEifSx7ImZpbmQiOiJQbGFjZV80IiwicmVwbGFjZSI6IkNocmlzdGNodXJjaCJ9LHsiZmluZCI6IkNUQSIsInJlcGxhY2UiOiJWSUVXIFRPQURZIn0seyJmaW5kIjoiRk9OVF9DT0xPUl8xIiwicmVwbGFjZSI6IiNmZmZmZmYifSx7ImZpbmQiOiJCQUNLR1JPVU5EX0NPTE9SIiwicmVwbGFjZSI6IiMwMDZmZTYifSx7ImZpbmQiOiJTSEFQRV9DT0xPUl8xIiwicmVwbGFjZSI6IiNkZWRlZGUifSx7ImZpbmQiOiJGT05UX0NPTE9SXzIiLCJyZXBsYWNlIjoiIzAwMDAwMCJ9LHsiZmluZCI6IlNIQVBFX0NPTE9SXzIiLCJyZXBsYWNlIjoiI2ZmZWEwMCJ9LHsiZmluZCI6IlZJREVPXzEiLCJyZXBsYWNlIjoiaHR0cHM6Ly90ZW1wbGF0ZXMuc2hvdHN0YWNrLmlvL3RyYXZlbC1kaWFyeS1hZHZlbnR1cmUtcHJvbW8tdGVtcGxhdGUvZGFmYzE4OGEtZmRjYy00MTRlLThhMWYtYWI4OTQ4OTA4NmQ2L3NvdXJjZS5tcDQifSx7ImZpbmQiOiJWSURFT18yIiwicmVwbGFjZSI6Imh0dHBzOi8vdGVtcGxhdGVzLnNob3RzdGFjay5pby90cmF2ZWwtZGlhcnktYWR2ZW50dXJlLXByb21vLXRlbXBsYXRlLzI5NzliODY5LTg5OGUtNGExYy1hMWY3LTJmN2U4OWU3NjczOC9zb3VyY2UubXA0In0seyJmaW5kIjoiVklERU9fMyIsInJlcGxhY2UiOiJodHRwczovL3RlbXBsYXRlcy5zaG90c3RhY2suaW8vdHJhdmVsLWRpYXJ5LWFkdmVudHVyZS1wcm9tby10ZW1wbGF0ZS82MmY5YWNmOS1iMDU2LTQ1ZTctYjc4Yi02NDRjNmE0Yzk5YTEvc291cmNlLm1wNCJ9LHsiZmluZCI6IlZJREVPXzQiLCJyZXBsYWNlIjoiaHR0cHM6Ly90ZW1wbGF0ZXMuc2hvdHN0YWNrLmlvL3RyYXZlbC1kaWFyeS1hZHZlbnR1cmUtcHJvbW8tdGVtcGxhdGUvMzQ3MzUwMTktMDY1MC00MTI0LThhMmQtNmM2MDI4Yzk5NGRmL3NvdXJjZS5tcDQifSx7ImZpbmQiOiJGbGFnIiwicmVwbGFjZSI6Imh0dHBzOi8vdGVtcGxhdGVzLnNob3RzdGFjay5pby90cmF2ZWwtZGlhcnktYWR2ZW50dXJlLXByb21vLXRlbXBsYXRlLzA3N2VhZTY3LTE0MzMtNGY4Zi05NmZmLTVkN2FiMzUzNTNmYy9zb3VyY2UucG5nIn0seyJmaW5kIjoiQVVESU8iLCJyZXBsYWNlIjoiaHR0cHM6Ly90ZW1wbGF0ZXMuc2hvdHN0YWNrLmlvL3RyYXZlbC1kaWFyeS1hZHZlbnR1cmUtcHJvbW8tdGVtcGxhdGUvNmJkOGE4MDgtMTUxYy00ZTQzLTgyNjItNjQyMTVjYjkzOTFjL3NvdXJjZS5tcDMifV19
- **Edit and save to an account**: https://dashboard.shotstack.io/studio/editor/travel-diary-adventure-promo-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 |
| --- | --- |
| `{{ Title }}` | TRAVEL DIARY |
| `{{ Subtitle }}` | SHOW ONE: A TOUR IN NEW ZEELAND |
| `{{ Place_1 }}` | Auckland |
| `{{ Place_2 }}` | Queenstown |
| `{{ Place_3 }}` | Rotorua |
| `{{ Place_4 }}` | Christchurch |
| `{{ CTA }}` | VIEW TOADY |
| `{{ FONT_COLOR_1 }}` | #ffffff |
| `{{ BACKGROUND_COLOR }}` | #006fe6 |
| `{{ SHAPE_COLOR_1 }}` | #dedede |
| `{{ FONT_COLOR_2 }}` | #000000 |
| `{{ SHAPE_COLOR_2 }}` | #ffea00 |
| `{{ VIDEO_1 }}` | https://templates.shotstack.io/travel-diary-adventure-promo-template/dafc188a-fdcc-414e-8a1f-ab89489086d6/source.mp4 |
| `{{ VIDEO_2 }}` | https://templates.shotstack.io/travel-diary-adventure-promo-template/2979b869-898e-4a1c-a1f7-2f7e89e76738/source.mp4 |
| `{{ VIDEO_3 }}` | https://templates.shotstack.io/travel-diary-adventure-promo-template/62f9acf9-b056-45e7-b78b-644c6a4c99a1/source.mp4 |
| `{{ VIDEO_4 }}` | https://templates.shotstack.io/travel-diary-adventure-promo-template/34735019-0650-4124-8a2d-6c6028c994df/source.mp4 |
| `{{ Flag }}` | https://templates.shotstack.io/travel-diary-adventure-promo-template/077eae67-1433-4f8f-96ff-5d7ab35353fc/source.png |
| `{{ AUDIO }}` | https://templates.shotstack.io/travel-diary-adventure-promo-template/6bd8a808-151c-4e43-8262-64215cb9391c/source.mp3 |

## Template JSON

```json
{
  "timeline": {
    "fonts": [
      {
        "src": "https://templates.shotstack.io/travel-diary-adventure-promo-template/9efa4eb2-8a20-4f90-a73e-dd81ac2c180e/source.ttf"
      }
    ],
    "background": "#FFFFFF",
    "tracks": [
      {
        "clips": [
          {
            "length": "end",
            "asset": {
              "type": "audio",
              "src": "{{ AUDIO }}",
              "volume": 1
            },
            "start": 0
          }
        ]
      },
      {
        "clips": [
          {
            "asset": {
              "type": "text",
              "text": "{{Subtitle}}",
              "alignment": {
                "horizontal": "center",
                "vertical": "center"
              },
              "font": {
                "color": "{{ BACKGROUND_COLOR }}",
                "family": "Montserrat SemiBold",
                "size": "30",
                "lineHeight": 1
              },
              "width": 500,
              "height": 100
            },
            "start": 0.2,
            "length": "end",
            "offset": {
              "x": 0,
              "y": 0.274
            },
            "position": "center",
            "transition": {
              "in": "slideUp"
            }
          }
        ]
      },
      {
        "clips": [
          {
            "asset": {
              "type": "text",
              "text": " {{Place_4}}",
              "alignment": {
                "horizontal": "center",
                "vertical": "center"
              },
              "font": {
                "color": "{{ FONT_COLOR_2 }}",
                "family": "Montserrat SemiBold",
                "size": 24,
                "lineHeight": 1
              },
              "width": 400,
              "height": 72
            },
            "start": 0.65,
            "length": "end",
            "offset": {
              "x": 0.125,
              "y": -0.232
            },
            "position": "center",
            "transform": {
              "rotate": {
                "angle": 10
              }
            },
            "transition": {
              "in": "fade"
            }
          }
        ]
      },
      {
        "clips": [
          {
            "asset": {
              "type": "text",
              "text": "{{Place_3}}",
              "alignment": {
                "horizontal": "center",
                "vertical": "center"
              },
              "font": {
                "color": "{{ FONT_COLOR_2 }}",
                "family": "Montserrat SemiBold",
                "size": 24,
                "lineHeight": 1
              },
              "width": 400,
              "height": 72
            },
            "start": 0.55,
            "length": "end",
            "offset": {
              "x": -0.231,
              "y": -0.165
            },
            "position": "center",
            "transform": {
              "rotate": {
                "angle": -12
              }
            },
            "transition": {
              "in": "fade"
            }
          }
        ]
      },
      {
        "clips": [
          {
            "asset": {
              "type": "text",
              "text": "{{Place_3}}",
              "alignment": {
                "horizontal": "center",
                "vertical": "center"
              },
              "font": {
                "color": "{{ FONT_COLOR_2 }}",
                "family": "Montserrat SemiBold",
                "size": 24,
                "lineHeight": 1
              },
              "width": 400,
              "height": 72
            },
            "start": 0.45,
            "length": "end",
            "offset": {
              "x": 0.204,
              "y": 0.033
            },
            "position": "center",
            "transform": {
              "rotate": {
                "angle": 8
              }
            }
          }
        ]
      },
      {
        "clips": [
          {
            "asset": {
              "type": "text",
              "text": " {{Place_1}}",
              "alignment": {
                "horizontal": "center",
                "vertical": "center"
              },
              "font": {
                "color": "{{ FONT_COLOR_2 }}",
                "family": "Montserrat SemiBold",
                "size": 24,
                "lineHeight": 1
              },
              "width": 400,
              "height": 72
            },
            "start": 0.35,
            "length": "end",
            "offset": {
              "x": -0.213,
              "y": 0.038
            },
            "position": "center",
            "transform": {
              "rotate": {
                "angle": -4
              }
            }
          }
        ]
      },
      {
        "clips": [
          {
            "asset": {
              "type": "luma",
              "src": "https://templates.shotstack.io/travel-diary-adventure-promo-template/e5e2b1cf-31fe-4939-b15d-cd2a3a14d41f/source.png"
            },
            "start": 0,
            "length": "end"
          },
          {
            "length": "end",
            "asset": {
              "type": "image",
              "src": "{{ Flag }}"
            },
            "start": 0.7,
            "scale": 0.2,
            "offset": {
              "x": -0.285,
              "y": -0.265
            },
            "position": "center",
            "transition": {
              "in": "fade"
            }
          }
        ]
      },
      {
        "clips": [
          {
            "length": "end",
            "asset": {
              "type": "video",
              "src": "{{ VIDEO_4 }}",
              "volume": 1
            },
            "start": 0.6,
            "scale": 0.16,
            "transform": {
              "rotate": {
                "angle": 10
              }
            },
            "offset": {
              "x": 0.151,
              "y": -0.142
            },
            "position": "center",
            "transition": {
              "in": "carouselLeft"
            }
          }
        ]
      },
      {
        "clips": [
          {
            "asset": {
              "type": "text",
              "text": "",
              "alignment": {
                "horizontal": "center",
                "vertical": "center"
              },
              "font": {
                "color": "#000000",
                "family": "Montserrat SemiBold",
                "size": 24,
                "lineHeight": 1
              },
              "width": 442,
              "height": 370,
              "background": {
                "color": "{{ FONT_COLOR_1 }}"
              }
            },
            "start": 0.6,
            "length": "end",
            "offset": {
              "x": 0.151,
              "y": -0.15
            },
            "position": "center",
            "transform": {
              "rotate": {
                "angle": 10
              }
            },
            "transition": {
              "in": "carouselLeft"
            }
          }
        ]
      },
      {
        "clips": [
          {
            "length": "end",
            "asset": {
              "type": "video",
              "src": "{{ VIDEO_3 }}",
              "volume": 1
            },
            "start": 0.5,
            "scale": 0.16,
            "transform": {
              "rotate": {
                "angle": -12
              }
            },
            "offset": {
              "x": -0.265,
              "y": -0.074
            },
            "position": "center",
            "transition": {
              "in": "carouselRight"
            }
          }
        ]
      },
      {
        "clips": [
          {
            "asset": {
              "type": "text",
              "text": "",
              "alignment": {
                "horizontal": "center",
                "vertical": "center"
              },
              "font": {
                "color": "#000000",
                "family": "Montserrat SemiBold",
                "size": 24,
                "lineHeight": 1
              },
              "width": 442,
              "height": 370,
              "background": {
                "color": "{{ FONT_COLOR_1 }}"
              }
            },
            "start": 0.5,
            "length": "end",
            "offset": {
              "x": -0.258,
              "y": -0.082
            },
            "position": "center",
            "transform": {
              "rotate": {
                "angle": -12
              }
            },
            "transition": {
              "in": "carouselRight"
            }
          }
        ]
      },
      {
        "clips": [
          {
            "length": "end",
            "asset": {
              "type": "video",
              "src": "{{ VIDEO_2 }}",
              "volume": 1
            },
            "start": 0.4,
            "scale": 0.16,
            "offset": {
              "x": 0.24,
              "y": 0.125
            },
            "position": "center",
            "transform": {
              "rotate": {
                "angle": 8
              }
            }
          }
        ]
      },
      {
        "clips": [
          {
            "asset": {
              "type": "text",
              "text": "",
              "alignment": {
                "horizontal": "center",
                "vertical": "center"
              },
              "font": {
                "color": "#000000",
                "family": "Montserrat SemiBold",
                "size": 24,
                "lineHeight": 1
              },
              "width": 442,
              "height": 370,
              "background": {
                "color": "{{ FONT_COLOR_1 }}"
              }
            },
            "start": 0.4,
            "length": "end",
            "offset": {
              "x": 0.24,
              "y": 0.116
            },
            "position": "center",
            "transform": {
              "rotate": {
                "angle": 8
              }
            }
          }
        ]
      },
      {
        "clips": [
          {
            "length": "end",
            "asset": {
              "type": "video",
              "src": "{{ VIDEO_1 }}",
              "volume": 1
            },
            "start": 0.3,
            "scale": 0.16,
            "offset": {
              "x": -0.215,
              "y": 0.132
            },
            "position": "center",
            "transform": {
              "rotate": {
                "angle": -4
              }
            },
            "transition": {
              "in": "carouselRight"
            }
          }
        ]
      },
      {
        "clips": [
          {
            "asset": {
              "type": "text",
              "text": "",
              "alignment": {
                "horizontal": "center",
                "vertical": "center"
              },
              "font": {
                "color": "#000000",
                "family": "Montserrat SemiBold",
                "size": 24,
                "lineHeight": 1
              },
              "width": 442,
              "height": 370,
              "background": {
                "color": "{{ FONT_COLOR_1 }}"
              }
            },
            "start": 0.3,
            "length": "end",
            "offset": {
              "x": -0.215,
              "y": 0.125
            },
            "position": "center",
            "transform": {
              "rotate": {
                "angle": -4
              }
            },
            "transition": {
              "in": "carouselRight"
            }
          }
        ]
      },
      {
        "clips": [
          {
            "asset": {
              "type": "text",
              "text": "{{Title}}",
              "alignment": {
                "horizontal": "center",
                "vertical": "center"
              },
              "font": {
                "color": "{{ FONT_COLOR_1 }}",
                "family": "Blow",
                "size": "150",
                "lineHeight": 1
              },
              "width": 1000,
              "height": 250
            },
            "start": 0,
            "length": "end",
            "offset": {
              "x": 0,
              "y": 0.397
            },
            "position": "center",
            "transition": {
              "in": "slideDown"
            }
          }
        ]
      },
      {
        "clips": [
          {
            "asset": {
              "type": "luma",
              "src": "https://templates.shotstack.io/travel-diary-adventure-promo-template/46ccca18-393f-4874-87d8-8ff1004141e7/source.png"
            },
            "start": 0,
            "length": 5
          },
          {
            "asset": {
              "type": "text",
              "text": "",
              "alignment": {
                "horizontal": "center",
                "vertical": "center"
              },
              "font": {
                "color": "#000000",
                "family": "Montserrat SemiBold",
                "size": 24,
                "lineHeight": 1
              },
              "width": 441,
              "height": 500,
              "background": {
                "color": "#ffffff"
              }
            },
            "start": 0.8,
            "length": "end",
            "offset": {
              "x": 0,
              "y": -0.372
            },
            "position": "center",
            "transition": {
              "in": "carouselUp"
            }
          }
        ]
      },
      {
        "clips": [
          {
            "asset": {
              "type": "text",
              "text": " {{CTA}}",
              "alignment": {
                "horizontal": "center",
                "vertical": "center"
              },
              "font": {
                "color": "{{ FONT_COLOR_2 }}",
                "family": "Montserrat ExtraBold",
                "size": "44",
                "lineHeight": 1
              },
              "width": 426,
              "height": 93,
              "background": {
                "color": "{{ SHAPE_COLOR_2 }}",
                "borderRadius": 11,
                "padding": 15
              }
            },
            "start": 0.8,
            "length": "end",
            "offset": {
              "x": 0,
              "y": -0.372
            },
            "position": "center",
            "transition": {
              "in": "carouselUp"
            }
          }
        ]
      },
      {
        "clips": [
          {
            "asset": {
              "type": "luma",
              "src": "https://templates.shotstack.io/travel-diary-adventure-promo-template/b0137277-f535-4ceb-9585-df01befbb0eb/source.png"
            },
            "start": 0,
            "length": "end"
          },
          {
            "asset": {
              "type": "text",
              "text": "",
              "alignment": {
                "horizontal": "center",
                "vertical": "center"
              },
              "font": {
                "color": "#000000",
                "family": "Montserrat SemiBold",
                "size": 24,
                "lineHeight": 1
              },
              "width": 903,
              "height": 822,
              "background": {
                "color": "{{ SHAPE_COLOR_1 }}"
              }
            },
            "start": 0.1,
            "length": "end",
            "offset": {
              "x": 0,
              "y": -0.142
            },
            "position": "center",
            "transition": {
              "in": "slideUp"
            }
          }
        ]
      },
      {
        "clips": [
          {
            "asset": {
              "type": "luma",
              "src": "https://templates.shotstack.io/travel-diary-adventure-promo-template/96909f13-d321-4a3f-a6e3-97b572707688/source.png"
            },
            "start": 0,
            "length": 5
          },
          {
            "asset": {
              "type": "text",
              "text": "",
              "alignment": {
                "horizontal": "center",
                "vertical": "center"
              },
              "font": {
                "color": "#000000",
                "family": "Montserrat SemiBold",
                "size": 24,
                "lineHeight": 1
              },
              "width": 903,
              "height": 822,
              "background": {
                "color": "{{ SHAPE_COLOR_1 }}"
              }
            },
            "start": 0.1,
            "length": "end",
            "offset": {
              "x": 0,
              "y": 0.148
            },
            "position": "center",
            "transition": {
              "in": "slideUp"
            }
          }
        ]
      },
      {
        "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": 5,
            "position": "center"
          },
          {
            "asset": {
              "type": "luma",
              "src": "https://templates.shotstack.io/travel-diary-adventure-promo-template/a217f66b-f911-4c04-9029-429cabf52e5c/source.mp4"
            },
            "start": 0,
            "length": 5
          }
        ]
      }
    ]
  },
  "output": {
    "format": "mp4",
    "fps": 25,
    "size": {
      "width": 1080,
      "height": 1920
    }
  },
  "merge": [
    {
      "find": "Title",
      "replace": "TRAVEL DIARY"
    },
    {
      "find": "Subtitle",
      "replace": "SHOW ONE: A TOUR IN NEW ZEELAND"
    },
    {
      "find": "Place_1",
      "replace": "Auckland"
    },
    {
      "find": "Place_2",
      "replace": "Queenstown"
    },
    {
      "find": "Place_3",
      "replace": "Rotorua"
    },
    {
      "find": "Place_4",
      "replace": "Christchurch"
    },
    {
      "find": "CTA",
      "replace": "VIEW TOADY"
    },
    {
      "find": "FONT_COLOR_1",
      "replace": "#ffffff"
    },
    {
      "find": "BACKGROUND_COLOR",
      "replace": "#006fe6"
    },
    {
      "find": "SHAPE_COLOR_1",
      "replace": "#dedede"
    },
    {
      "find": "FONT_COLOR_2",
      "replace": "#000000"
    },
    {
      "find": "SHAPE_COLOR_2",
      "replace": "#ffea00"
    },
    {
      "find": "VIDEO_1",
      "replace": "https://templates.shotstack.io/travel-diary-adventure-promo-template/dafc188a-fdcc-414e-8a1f-ab89489086d6/source.mp4"
    },
    {
      "find": "VIDEO_2",
      "replace": "https://templates.shotstack.io/travel-diary-adventure-promo-template/2979b869-898e-4a1c-a1f7-2f7e89e76738/source.mp4"
    },
    {
      "find": "VIDEO_3",
      "replace": "https://templates.shotstack.io/travel-diary-adventure-promo-template/62f9acf9-b056-45e7-b78b-644c6a4c99a1/source.mp4"
    },
    {
      "find": "VIDEO_4",
      "replace": "https://templates.shotstack.io/travel-diary-adventure-promo-template/34735019-0650-4124-8a2d-6c6028c994df/source.mp4"
    },
    {
      "find": "Flag",
      "replace": "https://templates.shotstack.io/travel-diary-adventure-promo-template/077eae67-1433-4f8f-96ff-5d7ab35353fc/source.png"
    },
    {
      "find": "AUDIO",
      "replace": "https://templates.shotstack.io/travel-diary-adventure-promo-template/6bd8a808-151c-4e43-8262-64215cb9391c/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