# Live News Promotional Announcement Template (video template)
> Announce your next big sale with our "Live News" template. Create urgent, eye-catching promotions that grab customer attention.
## Overview
- **Page**: https://shotstack.io/studio/templates/live-news-promo-announcement-template-sale-offer-v2/
- **Output**: MP4, 1080x1920 (9:16), 25 fps
- **Length**: 24s
- **Timeline**: 24 clips on 21 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=eyJ0aW1lbGluZSI6eyJiYWNrZ3JvdW5kIjoiI0ZGRkZGRiIsInRyYWNrcyI6W3siY2xpcHMiOlt7Imxlbmd0aCI6ImVuZCIsImFzc2V0Ijp7InR5cGUiOiJhdWRpbyIsInNyYyI6Int7IEFVRElPX1NSQyB9fSIsInZvbHVtZSI6MX0sInN0YXJ0IjowfV19LHsiY2xpcHMiOlt7ImFzc2V0Ijp7InR5cGUiOiJyaWNoLXRleHQiLCJ0ZXh0Ijoie3tDVEF9fSIsImZvbnQiOnsiZmFtaWx5IjoiSlRVU2pJZzFfaTZ0OGtDSEttNDV4VzVyeWdiaTQ5YyIsInNpemUiOjk2LCJ3ZWlnaHQiOjUwMCwiY29sb3IiOiJ7eyBXaGl0ZV9GT05UX0NPTE9SXzIgfX0iLCJvcGFjaXR5IjoxfSwic3R5bGUiOnsibGV0dGVyU3BhY2luZyI6MCwid29yZFNwYWNpbmciOjAsImxpbmVIZWlnaHQiOjEsInRleHRUcmFuc2Zvcm0iOiJub25lIiwidGV4dERlY29yYXRpb24iOiJub25lIn0sImFsaWduIjp7Imhvcml6b250YWwiOiJjZW50ZXIiLCJ2ZXJ0aWNhbCI6Im1pZGRsZSJ9LCJhbmltYXRpb24iOnsicHJlc2V0IjoiZmFkZUluIiwic3R5bGUiOiJ3b3JkIn19LCJzdGFydCI6MTYuMTI5MywibGVuZ3RoIjoiZW5kIiwib2Zmc2V0Ijp7IngiOjAuMDM5LCJ5IjowLjEzMX0sInBvc2l0aW9uIjoiY2VudGVyIiwidHJhbnNpdGlvbiI6eyJpbiI6InNsaWRlUmlnaHQifSwid2lkdGgiOjkwMCwiaGVpZ2h0IjoyNzB9XX0seyJjbGlwcyI6W3siYXNzZXQiOnsidHlwZSI6InJpY2gtdGV4dCIsInRleHQiOiJ7e1NPQ0lBTF9NRURJQX19IiwiZm9udCI6eyJmYW1pbHkiOiJKVFVTaklnMV9pNnQ4a0NIS200NXhXNXJ5Z2JpNDljIiwic2l6ZSI6ODEsIndlaWdodCI6NzAwLCJjb2xvciI6IiMwMDAwMDAiLCJvcGFjaXR5IjoxfSwic3R5bGUiOnsibGV0dGVyU3BhY2luZyI6MCwid29yZFNwYWNpbmciOjAsImxpbmVIZWlnaHQiOjEsInRleHRUcmFuc2Zvcm0iOiJub25lIiwidGV4dERlY29yYXRpb24iOiJub25lIn0sImFsaWduIjp7Imhvcml6b250YWwiOiJsZWZ0IiwidmVydGljYWwiOiJ0b3AifSwiYW5pbWF0aW9uIjp7InByZXNldCI6InR5cGV3cml0ZXIiLCJzdHlsZSI6ImNoYXJhY3RlciJ9fSwic3RhcnQiOjE2LjIsImxlbmd0aCI6ImVuZCIsIm9mZnNldCI6eyJ4IjowLjAyMSwieSI6LTAuMDN9LCJwb3NpdGlvbiI6ImNlbnRlciIsInRyYW5zaXRpb24iOnsiaW4iOiJzbGlkZVJpZ2h0In0sIndpZHRoIjo3NTQsImhlaWdodCI6MjAwfV19LHsiY2xpcHMiOlt7ImFzc2V0Ijp7InR5cGUiOiJzdmciLCJzcmMiOiI8c3ZnIHZpZXdCb3g9XCIwIDAgOTAwIDkwMFwiIHhtbG5zPVwiaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmdcIj48cmVjdCB3aWR0aD1cIjkwMFwiIGhlaWdodD1cIjkwMFwiIGZpbGw9XCJ7eyBFbGVtZW50X0NPTE9SIH19XCIvPjwvc3ZnPiJ9LCJzdGFydCI6MTYuMSwibGVuZ3RoIjoiZW5kIiwib2Zmc2V0Ijp7IngiOi0wLjA1MSwieSI6LTAuMDk0fSwicG9zaXRpb24iOiJjZW50ZXIiLCJ0cmFuc2l0aW9uIjp7ImluIjoic2xpZGVSaWdodCJ9LCJ3aWR0aCI6OTAwLCJoZWlnaHQiOjkwMH0seyJhc3NldCI6eyJ0eXBlIjoibHVtYSIsInNyYyI6Imh0dHBzOi8vdGVtcGxhdGVzLnNob3RzdGFjay5pby9saXZlLW5ld3MtcHJvbW8tYW5ub3VuY2VtZW50LXRlbXBsYXRlLXNhbGUtb2ZmZXIvNDFkYjc0M2YtMmE1MS00ODI0LTk2NDAtNzg0ZWQwYWY2NThlL3NvdXJjZS5wbmcifSwic3RhcnQiOjE2LjEsImxlbmd0aCI6Ny44OTk5OTk5OTk5OTk5OTl9XX0seyJjbGlwcyI6W3sibGVuZ3RoIjoiZW5kIiwiYXNzZXQiOnsidHlwZSI6ImltYWdlIiwic3JjIjoiaHR0cHM6Ly90ZW1wbGF0ZXMuc2hvdHN0YWNrLmlvL2xpdmUtbmV3cy1wcm9tby1hbm5vdW5jZW1lbnQtdGVtcGxhdGUtc2FsZS1vZmZlci84NGE2MzhlNy0yZDc3LTRiNDktOTA0ZC1kZWU4MDdkMTE3NTYvc291cmNlLnBuZyJ9LCJzdGFydCI6MTYsInBvc2l0aW9uIjoiY2VudGVyIiwic2NhbGUiOjEsInRyYW5zaXRpb24iOnsiaW4iOiJzbGlkZVJpZ2h0In0sImZpdCI6ImNvbnRhaW4iLCJ3aWR0aCI6ODYyLCJoZWlnaHQiOjkwNiwib2Zmc2V0Ijp7IngiOjAsInkiOjEuMTEwMjIzMDI0NjI1MTU2NWUtMTZ9fV19LHsiY2xpcHMiOlt7ImFzc2V0Ijp7InR5cGUiOiJyaWNoLXRleHQiLCJ0ZXh0Ijoie3tTMl9ERVNDUklQVElPTn19IiwiZm9udCI6eyJmYW1pbHkiOiJhaGNmdjhxejF6dDZoQ0M1RzRGX1A0QVNwVXlTcDBMbGN5USIsInNpemUiOjQ5LCJ3ZWlnaHQiOjQwMCwiY29sb3IiOiJ7eyBXaGl0ZV9GT05UX0NPTE9SXzIgfX0iLCJvcGFjaXR5IjoxfSwic3R5bGUiOnsibGV0dGVyU3BhY2luZyI6MCwid29yZFNwYWNpbmciOjAsImxpbmVIZWlnaHQiOjEsInRleHRUcmFuc2Zvcm0iOiJub25lIiwidGV4dERlY29yYXRpb24iOiJub25lIn0sImFsaWduIjp7Imhvcml6b250YWwiOiJsZWZ0IiwidmVydGljYWwiOiJ0b3AifSwiYW5pbWF0aW9uIjp7InByZXNldCI6InR5cGV3cml0ZXIiLCJzdHlsZSI6IndvcmQiLCJkaXJlY3Rpb24iOiJyaWdodCIsImR1cmF0aW9uIjoxLjV9fSwic3RhcnQiOjguOCwibGVuZ3RoIjo3LjIsIm9mZnNldCI6eyJ4IjotMC4wMTYsInkiOi0wLjMyMX0sInBvc2l0aW9uIjoiY2VudGVyIiwidHJhbnNpdGlvbiI6eyJpbiI6InNsaWRlUmlnaHQiLCJvdXQiOiJzbGlkZVJpZ2h0In0sIndpZHRoIjo4MDAsImhlaWdodCI6NTAwfV19LHsiY2xpcHMiOlt7ImFzc2V0Ijp7InR5cGUiOiJyaWNoLXRleHQiLCJ0ZXh0Ijoie3tTMl9USVRMRX19IiwiZm9udCI6eyJmYW1pbHkiOiJKVFVTaklnMV9pNnQ4a0NIS200NXhXNXJ5Z2JpNDljIiwic2l6ZSI6ODUsIndlaWdodCI6NzAwLCJjb2xvciI6Int7IEVsZW1lbnRfQ09MT1IgfX0iLCJvcGFjaXR5IjoxfSwic3R5bGUiOnsibGV0dGVyU3BhY2luZyI6MCwid29yZFNwYWNpbmciOjAsImxpbmVIZWlnaHQiOjEsInRleHRUcmFuc2Zvcm0iOiJub25lIiwidGV4dERlY29yYXRpb24iOiJub25lIn0sImFsaWduIjp7Imhvcml6b250YWwiOiJsZWZ0IiwidmVydGljYWwiOiJ0b3AifSwiYW5pbWF0aW9uIjp7InByZXNldCI6InNsaWRlSW4iLCJkaXJlY3Rpb24iOiJyaWdodCIsInN0eWxlIjoid29yZCJ9fSwic3RhcnQiOjguNywibGVuZ3RoIjo3LjIsIm9mZnNldCI6eyJ4IjotMC4wMTYsInkiOi0wLjEyNX0sInBvc2l0aW9uIjoiY2VudGVyIiwidHJhbnNpdGlvbiI6eyJvdXQiOiJzbGlkZVJpZ2h0IiwiaW4iOiJzbGlkZVJpZ2h0In0sIndpZHRoIjo4MDAsImhlaWdodCI6MjAwfV19LHsiY2xpcHMiOlt7ImFzc2V0Ijp7InR5cGUiOiJzdmciLCJzcmMiOiI8c3ZnIHZpZXdCb3g9XCIwIDAgMjUwIDIwXCIgeG1sbnM9XCJodHRwOi8vd3d3LnczLm9yZy8yMDAwL3N2Z1wiPjxyZWN0IHdpZHRoPVwiMjUwXCIgaGVpZ2h0PVwiMjBcIiBmaWxsPVwie3sgRWxlbWVudF9DT0xPUiB9fVwiLz48L3N2Zz4ifSwic3RhcnQiOjguNiwibGVuZ3RoIjo3LjIsIm9mZnNldCI6eyJ4IjotMC4yNzEsInkiOi0wLjA1N30sInBvc2l0aW9uIjoiY2VudGVyIiwidHJhbnNpdGlvbiI6eyJpbiI6InNsaWRlUmlnaHQiLCJvdXQiOiJzbGlkZVJpZ2h0In0sIndpZHRoIjoyNTAsImhlaWdodCI6MjB9XX0seyJjbGlwcyI6W3siYXNzZXQiOnsidHlwZSI6InJpY2gtdGV4dCIsInRleHQiOiJ7e1MxX0RFU0NSSVBUSU9OfX0iLCJmb250Ijp7ImZhbWlseSI6IktGT21DbnFFdTkyRnIxTWU1V1pMQ3pZbEt3Iiwic2l6ZSI6OTEsIndlaWdodCI6OTAwLCJjb2xvciI6Int7IEJsYWNrX0ZPTlRfQ09MT1IgfX0iLCJvcGFjaXR5IjoxfSwic3R5bGUiOnsibGV0dGVyU3BhY2luZyI6MCwid29yZFNwYWNpbmciOjAsImxpbmVIZWlnaHQiOjEsInRleHRUcmFuc2Zvcm0iOiJub25lIiwidGV4dERlY29yYXRpb24iOiJub25lIn0sImFsaWduIjp7Imhvcml6b250YWwiOiJjZW50ZXIiLCJ2ZXJ0aWNhbCI6Im1pZGRsZSJ9fSwic3RhcnQiOjguMywibGVuZ3RoIjo3LjcsIm9mZnNldCI6eyJ4IjotMC4zMTMsInkiOjAuMzY3fSwicG9zaXRpb24iOiJjZW50ZXIiLCJ0cmFuc2l0aW9uIjp7ImluIjoic2xpZGVSaWdodCIsIm91dCI6InNsaWRlUmlnaHQifSwid2lkdGgiOjM1MCwiaGVpZ2h0IjoxMjB9XX0seyJjbGlwcyI6W3sibGVuZ3RoIjo3LjUsImFzc2V0Ijp7InR5cGUiOiJpbWFnZSIsInNyYyI6Int7IFMyX0lNQUdFX1NSQyB9fSJ9LCJzdGFydCI6OC4yLCJzY2FsZSI6MSwib2Zmc2V0Ijp7IngiOjAsInkiOjAuMTA5MTc2NTU2NTMyNzgxMDJ9LCJwb3NpdGlvbiI6ImNlbnRlciIsInRyYW5zaXRpb24iOnsiaW4iOiJzbGlkZVJpZ2h0Iiwib3V0Ijoic2xpZGVSaWdodCJ9LCJmaXQiOiJjb250YWluIiwid2lkdGgiOjgyNSwiaGVpZ2h0Ijo1NTF9XX0seyJjbGlwcyI6W3siYXNzZXQiOnsidHlwZSI6InJpY2gtdGV4dCIsInRleHQiOiJ7e1MxX1RJVExFfX0iLCJmb250Ijp7ImZhbWlseSI6IktGT21DbnFFdTkyRnIxTWU1V1pMQ3pZbEt3Iiwic2l6ZSI6OTEsIndlaWdodCI6OTAwLCJjb2xvciI6Int7IEJsYWNrX0ZPTlRfQ09MT1IgfX0iLCJvcGFjaXR5IjoxfSwic3R5bGUiOnsibGV0dGVyU3BhY2luZyI6MCwid29yZFNwYWNpbmciOjAsImxpbmVIZWlnaHQiOjEsInRleHRUcmFuc2Zvcm0iOiJub25lIiwidGV4dERlY29yYXRpb24iOiJub25lIn0sImFsaWduIjp7Imhvcml6b250YWwiOiJjZW50ZXIiLCJ2ZXJ0aWNhbCI6Im1pZGRsZSJ9fSwic3RhcnQiOjguMiwibGVuZ3RoIjo3LjcsIm9mZnNldCI6eyJ4IjotMC4zMzgsInkiOjAuNDA5fSwicG9zaXRpb24iOiJjZW50ZXIiLCJ0cmFuc2l0aW9uIjp7ImluIjoic2xpZGVSaWdodCIsIm91dCI6InNsaWRlUmlnaHQifSwid2lkdGgiOjM1MCwiaGVpZ2h0IjoxMjB9XX0seyJjbGlwcyI6W3siYXNzZXQiOnsidHlwZSI6Imx1bWEiLCJzcmMiOiJodHRwczovL3RlbXBsYXRlcy5zaG90c3RhY2suaW8vbGl2ZS1uZXdzLXByb21vLWFubm91bmNlbWVudC10ZW1wbGF0ZS1zYWxlLW9mZmVyLzNkMDNmZTc5LTZhYmMtNGE3Ny1iNDY2LTIzNWFiN2FjZjlhMy9zb3VyY2UucG5nIn0sInN0YXJ0Ijo4LCJsZW5ndGgiOjcuOH0seyJhc3NldCI6eyJ0eXBlIjoic3ZnIiwic3JjIjoiPHN2ZyB2aWV3Qm94PVwiMCAwIDUwMCA1MDBcIiB4bWxucz1cImh0dHA6Ly93d3cudzMub3JnLzIwMDAvc3ZnXCI-PHJlY3Qgd2lkdGg9XCI1MDBcIiBoZWlnaHQ9XCI1MDBcIiBmaWxsPVwie3sgRWxlbWVudF9DT0xPUiB9fVwiLz48L3N2Zz4ifSwic3RhcnQiOjgsImxlbmd0aCI6Ny44LCJvZmZzZXQiOnsieCI6LTAuNDEsInkiOjAuMzI5fSwicG9zaXRpb24iOiJjZW50ZXIiLCJ0cmFuc2l0aW9uIjp7ImluIjoic2xpZGVSaWdodCIsIm91dCI6InNsaWRlUmlnaHQifSwid2lkdGgiOjUwMCwiaGVpZ2h0Ijo1MDB9XX0seyJjbGlwcyI6W3sibGVuZ3RoIjo3LjcsImFzc2V0Ijp7InR5cGUiOiJpbWFnZSIsInNyYyI6Imh0dHBzOi8vdGVtcGxhdGVzLnNob3RzdGFjay5pby9saXZlLW5ld3MtcHJvbW8tYW5ub3VuY2VtZW50LXRlbXBsYXRlLXNhbGUtb2ZmZXIvNTk2NzhiNmQtMWRhZS00YWMzLTk3ODgtYzY1YzRkYmQ5Yjg3L3NvdXJjZS5wbmcifSwic3RhcnQiOjgsIm9mZnNldCI6eyJ4IjotMC40MjEwMDAwMDAwMDAwMDAyLCJ5IjowLjM5NTg4NjU1OTQyNTQ1NTc1fSwicG9zaXRpb24iOiJjZW50ZXIiLCJzY2FsZSI6MSwidHJhbnNpdGlvbiI6eyJpbiI6InNsaWRlUmlnaHQiLCJvdXQiOiJzbGlkZVJpZ2h0In0sImZpdCI6ImNvbnRhaW4iLCJ3aWR0aCI6Njc0LCJoZWlnaHQiOjc1M31dfSx7ImNsaXBzIjpbeyJhc3NldCI6eyJ0eXBlIjoicmljaC10ZXh0IiwidGV4dCI6IiB7e1dFQlNJVEV9fSIsImZvbnQiOnsiZmFtaWx5IjoiSlRVU2pJZzFfaTZ0OGtDSEttNDV4VzVyeWdiaTQ5YyIsInNpemUiOjU2LCJ3ZWlnaHQiOjUwMCwiY29sb3IiOiJ7eyBXaGl0ZV9GT05UX0NPTE9SXzIgfX0iLCJvcGFjaXR5IjoxfSwic3R5bGUiOnsibGV0dGVyU3BhY2luZyI6MCwid29yZFNwYWNpbmciOjAsImxpbmVIZWlnaHQiOjEsInRleHRUcmFuc2Zvcm0iOiJub25lIiwidGV4dERlY29yYXRpb24iOiJub25lIn0sImFsaWduIjp7Imhvcml6b250YWwiOiJjZW50ZXIiLCJ2ZXJ0aWNhbCI6Im1pZGRsZSJ9fSwic3RhcnQiOjAuNSwibGVuZ3RoIjo3LjM1LCJvZmZzZXQiOnsieCI6MC4wMDksInkiOi0wLjQyOH0sInBvc2l0aW9uIjoiY2VudGVyIiwidHJhbnNpdGlvbiI6eyJpbiI6InNsaWRlUmlnaHQiLCJvdXQiOiJzbGlkZVJpZ2h0In0sIndpZHRoIjo4MDAsImhlaWdodCI6MjAwfV19LHsiY2xpcHMiOlt7ImFzc2V0Ijp7InR5cGUiOiJyaWNoLXRleHQiLCJ0ZXh0IjoiIHt7UzFfREVTQ1JJUFRJT059fSIsImZvbnQiOnsiZmFtaWx5IjoiS0ZPbUNucUV1OTJGcjFNZTVXWkxDellsS3ciLCJzaXplIjoyMjAsIndlaWdodCI6OTAwLCJjb2xvciI6Int7IEJsYWNrX0ZPTlRfQ09MT1IgfX0iLCJvcGFjaXR5IjoxfSwic3R5bGUiOnsibGV0dGVyU3BhY2luZyI6MCwid29yZFNwYWNpbmciOjAsImxpbmVIZWlnaHQiOjEsInRleHRUcmFuc2Zvcm0iOiJub25lIiwidGV4dERlY29yYXRpb24iOiJub25lIn0sImFsaWduIjp7Imhvcml6b250YWwiOiJjZW50ZXIiLCJ2ZXJ0aWNhbCI6Im1pZGRsZSJ9fSwic3RhcnQiOjAuMywibGVuZ3RoIjo3LjcsIm9mZnNldCI6eyJ4IjotMC4wMTIsInkiOjAuMDA4fSwicG9zaXRpb24iOiJjZW50ZXIiLCJ0cmFuc2l0aW9uIjp7ImluIjoic2xpZGVSaWdodCIsIm91dCI6InNsaWRlUmlnaHQifSwid2lkdGgiOjgwMCwiaGVpZ2h0IjoyMDB9XX0seyJjbGlwcyI6W3siYXNzZXQiOnsidHlwZSI6InJpY2gtdGV4dCIsInRleHQiOiIge3tTMV9USVRMRX19IiwiZm9udCI6eyJmYW1pbHkiOiJLRk9tQ25xRXU5MkZyMU1lNVdaTEN6WWxLdyIsInNpemUiOjIyMCwid2VpZ2h0Ijo5MDAsImNvbG9yIjoiIzAwMDAwMCIsIm9wYWNpdHkiOjF9LCJzdHlsZSI6eyJsZXR0ZXJTcGFjaW5nIjowLCJ3b3JkU3BhY2luZyI6MCwibGluZUhlaWdodCI6MSwidGV4dFRyYW5zZm9ybSI6Im5vbmUiLCJ0ZXh0RGVjb3JhdGlvbiI6Im5vbmUifSwiYWxpZ24iOnsiaG9yaXpvbnRhbCI6ImNlbnRlciIsInZlcnRpY2FsIjoibWlkZGxlIn19LCJzdGFydCI6MC4yLCJsZW5ndGgiOjcuNywib2Zmc2V0Ijp7IngiOi0wLjA5MiwieSI6MC4xMTJ9LCJwb3NpdGlvbiI6ImNlbnRlciIsInRyYW5zaXRpb24iOnsiaW4iOiJzbGlkZVJpZ2h0Iiwib3V0Ijoic2xpZGVSaWdodCJ9LCJ3aWR0aCI6ODAwLCJoZWlnaHQiOjIwMH1dfSx7ImNsaXBzIjpbeyJhc3NldCI6eyJ0eXBlIjoibHVtYSIsInNyYyI6Imh0dHBzOi8vdGVtcGxhdGVzLnNob3RzdGFjay5pby9saXZlLW5ld3MtcHJvbW8tYW5ub3VuY2VtZW50LXRlbXBsYXRlLXNhbGUtb2ZmZXIvNjA5MDZlOTItN2IwNi00N2I2LThmNjktNTYyMjUzMTVjYTVhL3NvdXJjZS5wbmcifSwic3RhcnQiOjAsImxlbmd0aCI6Ny44fSx7ImFzc2V0Ijp7InR5cGUiOiJzdmciLCJzcmMiOiI8c3ZnIHZpZXdCb3g9XCIwIDAgMTUwMCAxNTAwXCIgeG1sbnM9XCJodHRwOi8vd3d3LnczLm9yZy8yMDAwL3N2Z1wiPjxyZWN0IHdpZHRoPVwiMTUwMFwiIGhlaWdodD1cIjE1MDBcIiBmaWxsPVwie3sgRWxlbWVudF9DT0xPUiB9fVwiLz48L3N2Zz4ifSwic3RhcnQiOjAsImxlbmd0aCI6Ny44LCJvZmZzZXQiOnsieCI6LTAuNDA3LCJ5IjotMC4wNzR9LCJwb3NpdGlvbiI6ImNlbnRlciIsInRyYW5zaXRpb24iOnsiaW4iOiJzbGlkZVJpZ2h0Iiwib3V0Ijoic2xpZGVSaWdodCJ9LCJ3aWR0aCI6MTUwMCwiaGVpZ2h0IjoxNTAwfV19LHsiY2xpcHMiOlt7Imxlbmd0aCI6Ny43LCJhc3NldCI6eyJ0eXBlIjoiaW1hZ2UiLCJzcmMiOiJodHRwczovL3RlbXBsYXRlcy5zaG90c3RhY2suaW8vbGl2ZS1uZXdzLXByb21vLWFubm91bmNlbWVudC10ZW1wbGF0ZS1zYWxlLW9mZmVyLzA4YTRiOWY1LTQ3ZGMtNDIzOS1hNmE1LWUwOTQ1ZmY5OGExZC9zb3VyY2UucG5nIn0sInN0YXJ0IjowLCJvZmZzZXQiOnsieCI6LTAuMjg4LCJ5IjowLjA2OTM0MDMyMTcyMzYzMjY2fSwicG9zaXRpb24iOiJjZW50ZXIiLCJzY2FsZSI6MSwidHJhbnNpdGlvbiI6eyJpbiI6InNsaWRlUmlnaHQiLCJvdXQiOiJzbGlkZVJpZ2h0In0sImZpdCI6ImNvbnRhaW4iLCJ3aWR0aCI6MTY0NiwiaGVpZ2h0IjoxNjUyfV19LHsiY2xpcHMiOlt7Imxlbmd0aCI6OCwiYXNzZXQiOnsidHlwZSI6InZpZGVvIiwic3JjIjoiaHR0cHM6Ly90ZW1wbGF0ZXMuc2hvdHN0YWNrLmlvL2xpdmUtbmV3cy1wcm9tby1hbm5vdW5jZW1lbnQtdGVtcGxhdGUtc2FsZS1vZmZlci9mMWE1MWRjNi00YzdhLTRhNmItYjU1NS1jY2EyN2NhMzU1NTcvc291cmNlLm1wNCIsInZvbHVtZSI6MX0sInN0YXJ0IjoxNiwiZml0IjoiY29udGFpbiIsIndpZHRoIjoxMDgwLCJoZWlnaHQiOjE5MjAsIm9mZnNldCI6eyJ4IjowLCJ5IjowfX1dfSx7ImNsaXBzIjpbeyJsZW5ndGgiOjgsImFzc2V0Ijp7InR5cGUiOiJ2aWRlbyIsInNyYyI6Imh0dHBzOi8vdGVtcGxhdGVzLnNob3RzdGFjay5pby9saXZlLW5ld3MtcHJvbW8tYW5ub3VuY2VtZW50LXRlbXBsYXRlLXNhbGUtb2ZmZXIvMzVlMzhjNWEtNzMyYi00NjE5LTgxZjEtODU3ZDRhYjUyOGVkL3NvdXJjZS5tcDQiLCJ2b2x1bWUiOjF9LCJzdGFydCI6OCwiZml0IjoiY29udGFpbiIsIndpZHRoIjoxMDgwLCJoZWlnaHQiOjE5MjAsIm9mZnNldCI6eyJ4IjowLCJ5IjowfX1dfSx7ImNsaXBzIjpbeyJsZW5ndGgiOjgsImFzc2V0Ijp7InR5cGUiOiJ2aWRlbyIsInNyYyI6Imh0dHBzOi8vdGVtcGxhdGVzLnNob3RzdGFjay5pby9saXZlLW5ld3MtcHJvbW8tYW5ub3VuY2VtZW50LXRlbXBsYXRlLXNhbGUtb2ZmZXIvYzk4OTQ4ODgtYmEzNS00ZTIzLTg2NmMtNzY3N2ExNWE5YzFhL3NvdXJjZS5tcDQiLCJ2b2x1bWUiOjF9LCJzdGFydCI6MCwiZml0IjoiY29udGFpbiIsIndpZHRoIjoxMDgwLCJoZWlnaHQiOjE5MjAsIm9mZnNldCI6eyJ4IjowLCJ5IjowfX1dfV0sImZvbnRzIjpbeyJzcmMiOiJodHRwczovL2ZvbnRzLmdzdGF0aWMuY29tL3Mvcm9ib3RvL3Y1MC9LRk9tQ25xRXU5MkZyMU1lNVdaTEN6WWxLdy50dGYifSx7InNyYyI6Imh0dHBzOi8vZm9udHMuZ3N0YXRpYy5jb20vcy9tb250c2VycmF0L3YzMS9KVFVTaklnMV9pNnQ4a0NIS200NXhXNXJ5Z2JpNDljLnR0ZiJ9LHsic3JjIjoiaHR0cHM6Ly9mb250cy5nc3RhdGljLmNvbS9zL2RpZGFjdGdvdGhpYy92MjEvYWhjZnY4cXoxenQ2aENDNUc0Rl9QNEFTcFV5U3AwTGxjeVEudHRmIn1dfSwib3V0cHV0Ijp7ImZvcm1hdCI6Im1wNCIsImZwcyI6MjUsInNpemUiOnsid2lkdGgiOjEwODAsImhlaWdodCI6MTkyMH0sImRlc3RpbmF0aW9ucyI6W3sicHJvdmlkZXIiOiJzaG90c3RhY2sifV19LCJtZXJnZSI6W3siZmluZCI6IlMxX1RJVExFIiwicmVwbGFjZSI6IkxpdmUifSx7ImZpbmQiOiJTMV9ERVNDUklQVElPTiIsInJlcGxhY2UiOiJOZXdzIn0seyJmaW5kIjoiQmxhY2tfRk9OVF9DT0xPUiIsInJlcGxhY2UiOiIjMDAwMDAwIn0seyJmaW5kIjoiV0VCU0lURSIsInJlcGxhY2UiOiJ3d3cud2Vic2l0ZW5ld3MuY29tIn0seyJmaW5kIjoiV2hpdGVfRk9OVF9DT0xPUl8yIiwicmVwbGFjZSI6IiNmZmZmZmYifSx7ImZpbmQiOiJFbGVtZW50X0NPTE9SIiwicmVwbGFjZSI6IiMzM2NjZDcifSx7ImZpbmQiOiJTMl9USVRMRSIsInJlcGxhY2UiOiJTbWFydCBGYXJtaW5nIEJvb3N0cyBZaWVsZHMifSx7ImZpbmQiOiJTMl9ERVNDUklQVElPTiIsInJlcGxhY2UiOiJGYXJtZXJzIGluIG5vcnRoZXJuIE5pZ2VyaWEgbm93IHVzZSBzbWFydCB0b29scyBsaWtlIGRyb25lcyBhbmQgd2VhdGhlciBhcHBzIHRvIGJvb3N0IGNyb3AgeWllbGRzLiBNdXNhIERhbmp1bWEgc2F3IGEgMzAlIGluY3JlYXNlIGluIG1haXplLiBUaGUgZ292ZXJubWVudCBhaW1zIHRvIHN1cHBvcnQgNTAsMDAwIGZhcm1lcnMgYnkgMjAyNS4gRXhwZXJ0cyBzYXkgc21hcnQgZmFybWluZyBoZWxwcyB0YWNrbGUgY2xpbWF0ZSBjaGFuZ2UgYW5kIGltcHJvdmUgZm9vZCBzZWN1cml0eS4ifSx7ImZpbmQiOiJTMl9JTUFHRV9TUkMiLCJyZXBsYWNlIjoiaHR0cHM6Ly90ZW1wbGF0ZXMuc2hvdHN0YWNrLmlvL2xpdmUtbmV3cy1wcm9tby1hbm5vdW5jZW1lbnQtdGVtcGxhdGUtc2FsZS1vZmZlci8wYWJhMDMxZS1kZTkwLTQ0NjctOTMyZi1hY2IxODRlMjRkNzQvc291cmNlLmpwZyJ9LHsiZmluZCI6IkNUQSIsInJlcGxhY2UiOiJCZSBpbmZvcm1lZCBzdWJzY3JpYmUgdG9kYXkifSx7ImZpbmQiOiJTT0NJQUxfTUVESUEiLCJyZXBsYWNlIjoiQHdlYnNpdGVuZXdzIn0seyJmaW5kIjoiQVVESU9fU1JDIiwicmVwbGFjZSI6Imh0dHBzOi8vdGVtcGxhdGVzLnNob3RzdGFjay5pby9saXZlLW5ld3MtcHJvbW8tYW5ub3VuY2VtZW50LXRlbXBsYXRlLXNhbGUtb2ZmZXIvMTBkYzJmNTMtNzAxYy00NmVkLThjMzMtMDliMDQxZjQ5Mjc1L3Nob3RzdGFjay1wcm94eS5tcDMifV19
- **Edit and save to an account**: https://dashboard.shotstack.io/studio/editor/live-news-promo-announcement-template-sale-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 |
| --- | --- |
| `{{ S1_TITLE }}` | Live |
| `{{ S1_DESCRIPTION }}` | News |
| `{{ Black_FONT_COLOR }}` | #000000 |
| `{{ WEBSITE }}` | www.websitenews.com |
| `{{ White_FONT_COLOR_2 }}` | #ffffff |
| `{{ Element_COLOR }}` | #33ccd7 |
| `{{ S2_TITLE }}` | Smart Farming Boosts Yields |
| `{{ S2_DESCRIPTION }}` | Farmers in northern Nigeria now use smart tools like drones and weather apps to boost crop yields. Musa Danjuma saw a 30% increase in maize. The government aims to support 50,000 farmers by 2025. Experts say smart farming helps tackle climate change and improve food security. |
| `{{ S2_IMAGE_SRC }}` | https://templates.shotstack.io/live-news-promo-announcement-template-sale-offer/0aba031e-de90-4467-932f-acb184e24d74/source.jpg |
| `{{ CTA }}` | Be informed subscribe today |
| `{{ SOCIAL_MEDIA }}` | @websitenews |
| `{{ AUDIO_SRC }}` | https://templates.shotstack.io/live-news-promo-announcement-template-sale-offer/10dc2f53-701c-46ed-8c33-09b041f49275/shotstack-proxy.mp3 |
## Template JSON
```json
{
"timeline": {
"background": "#FFFFFF",
"tracks": [
{
"clips": [
{
"length": "end",
"asset": {
"type": "audio",
"src": "{{ AUDIO_SRC }}",
"volume": 1
},
"start": 0
}
]
},
{
"clips": [
{
"asset": {
"type": "rich-text",
"text": "{{CTA}}",
"font": {
"family": "JTUSjIg1_i6t8kCHKm45xW5rygbi49c",
"size": 96,
"weight": 500,
"color": "{{ White_FONT_COLOR_2 }}",
"opacity": 1
},
"style": {
"letterSpacing": 0,
"wordSpacing": 0,
"lineHeight": 1,
"textTransform": "none",
"textDecoration": "none"
},
"align": {
"horizontal": "center",
"vertical": "middle"
},
"animation": {
"preset": "fadeIn",
"style": "word"
}
},
"start": 16.1293,
"length": "end",
"offset": {
"x": 0.039,
"y": 0.131
},
"position": "center",
"transition": {
"in": "slideRight"
},
"width": 900,
"height": 270
}
]
},
{
"clips": [
{
"asset": {
"type": "rich-text",
"text": "{{SOCIAL_MEDIA}}",
"font": {
"family": "JTUSjIg1_i6t8kCHKm45xW5rygbi49c",
"size": 81,
"weight": 700,
"color": "#000000",
"opacity": 1
},
"style": {
"letterSpacing": 0,
"wordSpacing": 0,
"lineHeight": 1,
"textTransform": "none",
"textDecoration": "none"
},
"align": {
"horizontal": "left",
"vertical": "top"
},
"animation": {
"preset": "typewriter",
"style": "character"
}
},
"start": 16.2,
"length": "end",
"offset": {
"x": 0.021,
"y": -0.03
},
"position": "center",
"transition": {
"in": "slideRight"
},
"width": 754,
"height": 200
}
]
},
{
"clips": [
{
"asset": {
"type": "svg",
"src": ""
},
"start": 16.1,
"length": "end",
"offset": {
"x": -0.051,
"y": -0.094
},
"position": "center",
"transition": {
"in": "slideRight"
},
"width": 900,
"height": 900
},
{
"asset": {
"type": "luma",
"src": "https://templates.shotstack.io/live-news-promo-announcement-template-sale-offer/41db743f-2a51-4824-9640-784ed0af658e/source.png"
},
"start": 16.1,
"length": 7.899999999999999
}
]
},
{
"clips": [
{
"length": "end",
"asset": {
"type": "image",
"src": "https://templates.shotstack.io/live-news-promo-announcement-template-sale-offer/84a638e7-2d77-4b49-904d-dee807d11756/source.png"
},
"start": 16,
"position": "center",
"scale": 1,
"transition": {
"in": "slideRight"
},
"fit": "contain",
"width": 862,
"height": 906,
"offset": {
"x": 0,
"y": 1.1102230246251565e-16
}
}
]
},
{
"clips": [
{
"asset": {
"type": "rich-text",
"text": "{{S2_DESCRIPTION}}",
"font": {
"family": "ahcfv8qz1zt6hCC5G4F_P4ASpUySp0LlcyQ",
"size": 49,
"weight": 400,
"color": "{{ White_FONT_COLOR_2 }}",
"opacity": 1
},
"style": {
"letterSpacing": 0,
"wordSpacing": 0,
"lineHeight": 1,
"textTransform": "none",
"textDecoration": "none"
},
"align": {
"horizontal": "left",
"vertical": "top"
},
"animation": {
"preset": "typewriter",
"style": "word",
"direction": "right",
"duration": 1.5
}
},
"start": 8.8,
"length": 7.2,
"offset": {
"x": -0.016,
"y": -0.321
},
"position": "center",
"transition": {
"in": "slideRight",
"out": "slideRight"
},
"width": 800,
"height": 500
}
]
},
{
"clips": [
{
"asset": {
"type": "rich-text",
"text": "{{S2_TITLE}}",
"font": {
"family": "JTUSjIg1_i6t8kCHKm45xW5rygbi49c",
"size": 85,
"weight": 700,
"color": "{{ Element_COLOR }}",
"opacity": 1
},
"style": {
"letterSpacing": 0,
"wordSpacing": 0,
"lineHeight": 1,
"textTransform": "none",
"textDecoration": "none"
},
"align": {
"horizontal": "left",
"vertical": "top"
},
"animation": {
"preset": "slideIn",
"direction": "right",
"style": "word"
}
},
"start": 8.7,
"length": 7.2,
"offset": {
"x": -0.016,
"y": -0.125
},
"position": "center",
"transition": {
"out": "slideRight",
"in": "slideRight"
},
"width": 800,
"height": 200
}
]
},
{
"clips": [
{
"asset": {
"type": "svg",
"src": ""
},
"start": 8.6,
"length": 7.2,
"offset": {
"x": -0.271,
"y": -0.057
},
"position": "center",
"transition": {
"in": "slideRight",
"out": "slideRight"
},
"width": 250,
"height": 20
}
]
},
{
"clips": [
{
"asset": {
"type": "rich-text",
"text": "{{S1_DESCRIPTION}}",
"font": {
"family": "KFOmCnqEu92Fr1Me5WZLCzYlKw",
"size": 91,
"weight": 900,
"color": "{{ Black_FONT_COLOR }}",
"opacity": 1
},
"style": {
"letterSpacing": 0,
"wordSpacing": 0,
"lineHeight": 1,
"textTransform": "none",
"textDecoration": "none"
},
"align": {
"horizontal": "center",
"vertical": "middle"
}
},
"start": 8.3,
"length": 7.7,
"offset": {
"x": -0.313,
"y": 0.367
},
"position": "center",
"transition": {
"in": "slideRight",
"out": "slideRight"
},
"width": 350,
"height": 120
}
]
},
{
"clips": [
{
"length": 7.5,
"asset": {
"type": "image",
"src": "{{ S2_IMAGE_SRC }}"
},
"start": 8.2,
"scale": 1,
"offset": {
"x": 0,
"y": 0.10917655653278102
},
"position": "center",
"transition": {
"in": "slideRight",
"out": "slideRight"
},
"fit": "contain",
"width": 825,
"height": 551
}
]
},
{
"clips": [
{
"asset": {
"type": "rich-text",
"text": "{{S1_TITLE}}",
"font": {
"family": "KFOmCnqEu92Fr1Me5WZLCzYlKw",
"size": 91,
"weight": 900,
"color": "{{ Black_FONT_COLOR }}",
"opacity": 1
},
"style": {
"letterSpacing": 0,
"wordSpacing": 0,
"lineHeight": 1,
"textTransform": "none",
"textDecoration": "none"
},
"align": {
"horizontal": "center",
"vertical": "middle"
}
},
"start": 8.2,
"length": 7.7,
"offset": {
"x": -0.338,
"y": 0.409
},
"position": "center",
"transition": {
"in": "slideRight",
"out": "slideRight"
},
"width": 350,
"height": 120
}
]
},
{
"clips": [
{
"asset": {
"type": "luma",
"src": "https://templates.shotstack.io/live-news-promo-announcement-template-sale-offer/3d03fe79-6abc-4a77-b466-235ab7acf9a3/source.png"
},
"start": 8,
"length": 7.8
},
{
"asset": {
"type": "svg",
"src": ""
},
"start": 8,
"length": 7.8,
"offset": {
"x": -0.41,
"y": 0.329
},
"position": "center",
"transition": {
"in": "slideRight",
"out": "slideRight"
},
"width": 500,
"height": 500
}
]
},
{
"clips": [
{
"length": 7.7,
"asset": {
"type": "image",
"src": "https://templates.shotstack.io/live-news-promo-announcement-template-sale-offer/59678b6d-1dae-4ac3-9788-c65c4dbd9b87/source.png"
},
"start": 8,
"offset": {
"x": -0.4210000000000002,
"y": 0.39588655942545575
},
"position": "center",
"scale": 1,
"transition": {
"in": "slideRight",
"out": "slideRight"
},
"fit": "contain",
"width": 674,
"height": 753
}
]
},
{
"clips": [
{
"asset": {
"type": "rich-text",
"text": " {{WEBSITE}}",
"font": {
"family": "JTUSjIg1_i6t8kCHKm45xW5rygbi49c",
"size": 56,
"weight": 500,
"color": "{{ White_FONT_COLOR_2 }}",
"opacity": 1
},
"style": {
"letterSpacing": 0,
"wordSpacing": 0,
"lineHeight": 1,
"textTransform": "none",
"textDecoration": "none"
},
"align": {
"horizontal": "center",
"vertical": "middle"
}
},
"start": 0.5,
"length": 7.35,
"offset": {
"x": 0.009,
"y": -0.428
},
"position": "center",
"transition": {
"in": "slideRight",
"out": "slideRight"
},
"width": 800,
"height": 200
}
]
},
{
"clips": [
{
"asset": {
"type": "rich-text",
"text": " {{S1_DESCRIPTION}}",
"font": {
"family": "KFOmCnqEu92Fr1Me5WZLCzYlKw",
"size": 220,
"weight": 900,
"color": "{{ Black_FONT_COLOR }}",
"opacity": 1
},
"style": {
"letterSpacing": 0,
"wordSpacing": 0,
"lineHeight": 1,
"textTransform": "none",
"textDecoration": "none"
},
"align": {
"horizontal": "center",
"vertical": "middle"
}
},
"start": 0.3,
"length": 7.7,
"offset": {
"x": -0.012,
"y": 0.008
},
"position": "center",
"transition": {
"in": "slideRight",
"out": "slideRight"
},
"width": 800,
"height": 200
}
]
},
{
"clips": [
{
"asset": {
"type": "rich-text",
"text": " {{S1_TITLE}}",
"font": {
"family": "KFOmCnqEu92Fr1Me5WZLCzYlKw",
"size": 220,
"weight": 900,
"color": "#000000",
"opacity": 1
},
"style": {
"letterSpacing": 0,
"wordSpacing": 0,
"lineHeight": 1,
"textTransform": "none",
"textDecoration": "none"
},
"align": {
"horizontal": "center",
"vertical": "middle"
}
},
"start": 0.2,
"length": 7.7,
"offset": {
"x": -0.092,
"y": 0.112
},
"position": "center",
"transition": {
"in": "slideRight",
"out": "slideRight"
},
"width": 800,
"height": 200
}
]
},
{
"clips": [
{
"asset": {
"type": "luma",
"src": "https://templates.shotstack.io/live-news-promo-announcement-template-sale-offer/60906e92-7b06-47b6-8f69-56225315ca5a/source.png"
},
"start": 0,
"length": 7.8
},
{
"asset": {
"type": "svg",
"src": ""
},
"start": 0,
"length": 7.8,
"offset": {
"x": -0.407,
"y": -0.074
},
"position": "center",
"transition": {
"in": "slideRight",
"out": "slideRight"
},
"width": 1500,
"height": 1500
}
]
},
{
"clips": [
{
"length": 7.7,
"asset": {
"type": "image",
"src": "https://templates.shotstack.io/live-news-promo-announcement-template-sale-offer/08a4b9f5-47dc-4239-a6a5-e0945ff98a1d/source.png"
},
"start": 0,
"offset": {
"x": -0.288,
"y": 0.06934032172363266
},
"position": "center",
"scale": 1,
"transition": {
"in": "slideRight",
"out": "slideRight"
},
"fit": "contain",
"width": 1646,
"height": 1652
}
]
},
{
"clips": [
{
"length": 8,
"asset": {
"type": "video",
"src": "https://templates.shotstack.io/live-news-promo-announcement-template-sale-offer/f1a51dc6-4c7a-4a6b-b555-cca27ca35557/source.mp4",
"volume": 1
},
"start": 16,
"fit": "contain",
"width": 1080,
"height": 1920,
"offset": {
"x": 0,
"y": 0
}
}
]
},
{
"clips": [
{
"length": 8,
"asset": {
"type": "video",
"src": "https://templates.shotstack.io/live-news-promo-announcement-template-sale-offer/35e38c5a-732b-4619-81f1-857d4ab528ed/source.mp4",
"volume": 1
},
"start": 8,
"fit": "contain",
"width": 1080,
"height": 1920,
"offset": {
"x": 0,
"y": 0
}
}
]
},
{
"clips": [
{
"length": 8,
"asset": {
"type": "video",
"src": "https://templates.shotstack.io/live-news-promo-announcement-template-sale-offer/c9894888-ba35-4e23-866c-7677a15a9c1a/source.mp4",
"volume": 1
},
"start": 0,
"fit": "contain",
"width": 1080,
"height": 1920,
"offset": {
"x": 0,
"y": 0
}
}
]
}
],
"fonts": [
{
"src": "https://fonts.gstatic.com/s/roboto/v50/KFOmCnqEu92Fr1Me5WZLCzYlKw.ttf"
},
{
"src": "https://fonts.gstatic.com/s/montserrat/v31/JTUSjIg1_i6t8kCHKm45xW5rygbi49c.ttf"
},
{
"src": "https://fonts.gstatic.com/s/didactgothic/v21/ahcfv8qz1zt6hCC5G4F_P4ASpUySp0LlcyQ.ttf"
}
]
},
"output": {
"format": "mp4",
"fps": 25,
"size": {
"width": 1080,
"height": 1920
},
"destinations": [
{
"provider": "shotstack"
}
]
},
"merge": [
{
"find": "S1_TITLE",
"replace": "Live"
},
{
"find": "S1_DESCRIPTION",
"replace": "News"
},
{
"find": "Black_FONT_COLOR",
"replace": "#000000"
},
{
"find": "WEBSITE",
"replace": "www.websitenews.com"
},
{
"find": "White_FONT_COLOR_2",
"replace": "#ffffff"
},
{
"find": "Element_COLOR",
"replace": "#33ccd7"
},
{
"find": "S2_TITLE",
"replace": "Smart Farming Boosts Yields"
},
{
"find": "S2_DESCRIPTION",
"replace": "Farmers in northern Nigeria now use smart tools like drones and weather apps to boost crop yields. Musa Danjuma saw a 30% increase in maize. The government aims to support 50,000 farmers by 2025. Experts say smart farming helps tackle climate change and improve food security."
},
{
"find": "S2_IMAGE_SRC",
"replace": "https://templates.shotstack.io/live-news-promo-announcement-template-sale-offer/0aba031e-de90-4467-932f-acb184e24d74/source.jpg"
},
{
"find": "CTA",
"replace": "Be informed subscribe today"
},
{
"find": "SOCIAL_MEDIA",
"replace": "@websitenews"
},
{
"find": "AUDIO_SRC",
"replace": "https://templates.shotstack.io/live-news-promo-announcement-template-sale-offer/10dc2f53-701c-46ed-8c33-09b041f49275/shotstack-proxy.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