# Ideal Apartment in a Coveted Location (video template) > Showcase your apartment in a prime location with this sleek, user-friendly template. Perfect for creating compelling real estate listings. ## Overview - **Page**: https://shotstack.io/studio/templates/ideal-apartment-coveted-location/ - **Output**: MP4, 1080x1920 (9:16), 25 fps - **Length**: 10s - **Timeline**: 30 clips on 24 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=eyJ0aW1lbGluZSI6eyJmb250cyI6W3sic3JjIjoiaHR0cHM6Ly90ZW1wbGF0ZXMuc2hvdHN0YWNrLmlvL2lkZWFsLWFwYXJ0bWVudC1jb3ZldGVkLWxvY2F0aW9uLzAwNzBmMGNhLTRmMjktNGI3Ny1hMWUwLWZmYWRmY2Q3N2FiZC9qaXp6UkZWS3NtNEJ0OVByYlN6QzRLTGxRVUY1bFJKZzVqLWw1UHZ5aGZUZGQ0VGNZTU5mLnR0ZiJ9XSwiYmFja2dyb3VuZCI6IiNGRkZGRkYiLCJ0cmFja3MiOlt7ImNsaXBzIjpbeyJsZW5ndGgiOiJlbmQiLCJhc3NldCI6eyJ0eXBlIjoiYXVkaW8iLCJzcmMiOiJ7eyBBVURJT19TUkMgfX0iLCJ2b2x1bWUiOjF9LCJzdGFydCI6MH1dfSx7ImNsaXBzIjpbeyJhc3NldCI6eyJ0eXBlIjoidGV4dCIsInRleHQiOiJ7e1MxX0RFU0NSSVBUSU9OXzN9fSIsImFsaWdubWVudCI6eyJob3Jpem9udGFsIjoibGVmdCIsInZlcnRpY2FsIjoiY2VudGVyIn0sImZvbnQiOnsiY29sb3IiOiJ7eyBURVhUX0ZPTlRfQ09MT1IgfX0iLCJmYW1pbHkiOiJNb250c2VycmF0IFNlbWlCb2xkIiwic2l6ZSI6IjM1IiwibGluZUhlaWdodCI6MX0sIndpZHRoIjoyODMsImhlaWdodCI6NzV9LCJzdGFydCI6MC42LCJsZW5ndGgiOiJlbmQiLCJvZmZzZXQiOnsieCI6LTAuMTQ5LCJ5IjotMC4zMDJ9LCJwb3NpdGlvbiI6ImNlbnRlciIsInRyYW5zaXRpb24iOnsiaW4iOiJzbGlkZVVwIn19XX0seyJjbGlwcyI6W3siYXNzZXQiOnsidHlwZSI6InRleHQiLCJ0ZXh0Ijoie3tTMV9ERVNDUklQVElPTl80fX0iLCJhbGlnbm1lbnQiOnsiaG9yaXpvbnRhbCI6ImxlZnQiLCJ2ZXJ0aWNhbCI6ImNlbnRlciJ9LCJmb250Ijp7ImNvbG9yIjoie3sgVEVYVF9GT05UX0NPTE9SIH19IiwiZmFtaWx5IjoiTW9udHNlcnJhdCBTZW1pQm9sZCIsInNpemUiOiIzNSIsImxpbmVIZWlnaHQiOjF9LCJ3aWR0aCI6MjgzLCJoZWlnaHQiOjc1fSwic3RhcnQiOjAuNiwibGVuZ3RoIjoiZW5kIiwib2Zmc2V0Ijp7IngiOjAuMjUxLCJ5IjotMC4zMDJ9LCJwb3NpdGlvbiI6ImNlbnRlciIsInRyYW5zaXRpb24iOnsiaW4iOiJzbGlkZVVwIn19XX0seyJjbGlwcyI6W3siYXNzZXQiOnsidHlwZSI6InRleHQiLCJ0ZXh0Ijoie3tTMV9ERVNDUklQVElPTn19IiwiYWxpZ25tZW50Ijp7Imhvcml6b250YWwiOiJsZWZ0IiwidmVydGljYWwiOiJjZW50ZXIifSwiZm9udCI6eyJjb2xvciI6Int7IFRFWFRfRk9OVF9DT0xPUiB9fSIsImZhbWlseSI6Ik1vbnRzZXJyYXQgU2VtaUJvbGQiLCJzaXplIjoiMzUiLCJsaW5lSGVpZ2h0IjoxfSwid2lkdGgiOjI4MywiaGVpZ2h0Ijo3NX0sInN0YXJ0IjowLjQ1LCJsZW5ndGgiOiJlbmQiLCJvZmZzZXQiOnsieCI6LTAuMTQ5LCJ5IjotMC4yMDZ9LCJwb3NpdGlvbiI6ImNlbnRlciIsInRyYW5zaXRpb24iOnsiaW4iOiJzbGlkZVVwIn19XX0seyJjbGlwcyI6W3siYXNzZXQiOnsidHlwZSI6InRleHQiLCJ0ZXh0Ijoie3tTMV9ERVNDUklQVElPTl8yfX0iLCJhbGlnbm1lbnQiOnsiaG9yaXpvbnRhbCI6ImxlZnQiLCJ2ZXJ0aWNhbCI6ImNlbnRlciJ9LCJmb250Ijp7ImNvbG9yIjoie3sgVEVYVF9GT05UX0NPTE9SIH19IiwiZmFtaWx5IjoiTW9udHNlcnJhdCBTZW1pQm9sZCIsInNpemUiOiIzNSIsImxpbmVIZWlnaHQiOjF9LCJ3aWR0aCI6MjgzLCJoZWlnaHQiOjc1fSwic3RhcnQiOjAuNDUsImxlbmd0aCI6ImVuZCIsIm9mZnNldCI6eyJ4IjowLjI1MSwieSI6LTAuMjA2fSwicG9zaXRpb24iOiJjZW50ZXIiLCJ0cmFuc2l0aW9uIjp7ImluIjoic2xpZGVVcCJ9fV19LHsiY2xpcHMiOlt7ImFzc2V0Ijp7InR5cGUiOiJ0ZXh0IiwidGV4dCI6Int7UzJfREVTQ1JJUFRJT05fMn19IiwiYWxpZ25tZW50Ijp7Imhvcml6b250YWwiOiJjZW50ZXIiLCJ2ZXJ0aWNhbCI6ImNlbnRlciJ9LCJmb250Ijp7ImNvbG9yIjoie3sgVEVYVF9GT05UX0NPTE9SIH19IiwiZmFtaWx5IjoiRGlkYWN0IEdvdGhpYyIsInNpemUiOiI0MCIsImxpbmVIZWlnaHQiOjF9LCJ3aWR0aCI6NDAwLCJoZWlnaHQiOjYwfSwic3RhcnQiOjAuOCwibGVuZ3RoIjoiZW5kIiwib2Zmc2V0Ijp7InkiOi0wLjQzMn0sInRyYW5zaXRpb24iOnsiaW4iOiJzbGlkZVVwIn19XX0seyJjbGlwcyI6W3siYXNzZXQiOnsidHlwZSI6InRleHQiLCJ0ZXh0IjoiIHt7UzJfREVTQ1JJUFRJT05fMX19IiwiYWxpZ25tZW50Ijp7Imhvcml6b250YWwiOiJjZW50ZXIiLCJ2ZXJ0aWNhbCI6ImNlbnRlciJ9LCJmb250Ijp7ImNvbG9yIjoie3sgVEVYVF9GT05UX0NPTE9SIH19IiwiZmFtaWx5IjoiRGlkYWN0IEdvdGhpYyIsInNpemUiOiI0MCIsImxpbmVIZWlnaHQiOjF9LCJ3aWR0aCI6NjAwLCJoZWlnaHQiOjYyfSwic3RhcnQiOjAuNzUsImxlbmd0aCI6ImVuZCIsIm9mZnNldCI6eyJ5IjotMC4zOTl9LCJ0cmFuc2l0aW9uIjp7ImluIjoic2xpZGVVcCJ9fV19LHsiY2xpcHMiOlt7ImFzc2V0Ijp7InR5cGUiOiJ0ZXh0IiwidGV4dCI6IiIsImFsaWdubWVudCI6eyJob3Jpem9udGFsIjoiY2VudGVyIiwidmVydGljYWwiOiJjZW50ZXIifSwiZm9udCI6eyJjb2xvciI6IiMwMDAwMDAiLCJmYW1pbHkiOiJNb250c2VycmF0IEV4dHJhQm9sZCIsInNpemUiOjcyLCJsaW5lSGVpZ2h0IjoxfSwid2lkdGgiOjcwLCJoZWlnaHQiOjcwLCJiYWNrZ3JvdW5kIjp7ImNvbG9yIjoie3sgVEVYVF9GT05UX0NPTE9SIH19In19LCJzdGFydCI6MC41NSwibGVuZ3RoIjoiZW5kIiwib2Zmc2V0Ijp7IngiOi0wLjMyOSwieSI6LTAuMjk4fSwicG9zaXRpb24iOiJjZW50ZXIiLCJ0cmFuc2l0aW9uIjp7ImluIjoiZmFkZSJ9fSx7ImFzc2V0Ijp7InR5cGUiOiJsdW1hIiwic3JjIjoiaHR0cHM6Ly90ZW1wbGF0ZXMuc2hvdHN0YWNrLmlvL2lkZWFsLWFwYXJ0bWVudC1jb3ZldGVkLWxvY2F0aW9uL2JlM2E1YjkxLTMxMzctNGRkMy1iNGJiLWY3MDNlZmY1ZjFjNC9zb3VyY2UucG5nIn0sInN0YXJ0IjowLjU1LCJsZW5ndGgiOiJlbmQifV19LHsiY2xpcHMiOlt7ImFzc2V0Ijp7InR5cGUiOiJ0ZXh0IiwidGV4dCI6IiIsImFsaWdubWVudCI6eyJob3Jpem9udGFsIjoiY2VudGVyIiwidmVydGljYWwiOiJjZW50ZXIifSwiZm9udCI6eyJjb2xvciI6IiMwMDAwMDAiLCJmYW1pbHkiOiJNb250c2VycmF0IEV4dHJhQm9sZCIsInNpemUiOjcyLCJsaW5lSGVpZ2h0IjoxfSwid2lkdGgiOjcwLCJoZWlnaHQiOjcwLCJiYWNrZ3JvdW5kIjp7ImNvbG9yIjoie3sgVEVYVF9GT05UX0NPTE9SIH19In19LCJzdGFydCI6MC41NSwibGVuZ3RoIjoiZW5kIiwib2Zmc2V0Ijp7IngiOjAuMDcsInkiOi0wLjI5OH0sInBvc2l0aW9uIjoiY2VudGVyIiwidHJhbnNpdGlvbiI6eyJpbiI6ImZhZGUifX0seyJhc3NldCI6eyJ0eXBlIjoibHVtYSIsInNyYyI6Imh0dHBzOi8vdGVtcGxhdGVzLnNob3RzdGFjay5pby9pZGVhbC1hcGFydG1lbnQtY292ZXRlZC1sb2NhdGlvbi83NzExYWQ5Yy1mZTM5LTQwMmUtOGQwMy0wZGE2MjYzMTA1OGUvc291cmNlLnBuZyJ9LCJzdGFydCI6MC41NSwibGVuZ3RoIjoiZW5kIn1dfSx7ImNsaXBzIjpbeyJhc3NldCI6eyJ0eXBlIjoibHVtYSIsInNyYyI6Imh0dHBzOi8vdGVtcGxhdGVzLnNob3RzdGFjay5pby9pZGVhbC1hcGFydG1lbnQtY292ZXRlZC1sb2NhdGlvbi9iZmEyNGMyNi1iMGVhLTQ1OTUtODNjNS04ODJiMTlmODY3ZTAvc291cmNlLnBuZyJ9LCJzdGFydCI6MC40LCJsZW5ndGgiOiJlbmQifSx7ImFzc2V0Ijp7InR5cGUiOiJ0ZXh0IiwidGV4dCI6IiIsImFsaWdubWVudCI6eyJob3Jpem9udGFsIjoiY2VudGVyIiwidmVydGljYWwiOiJjZW50ZXIifSwiZm9udCI6eyJjb2xvciI6IiMwMDAwMDAiLCJmYW1pbHkiOiJNb250c2VycmF0IEV4dHJhQm9sZCIsInNpemUiOjcyLCJsaW5lSGVpZ2h0IjoxfSwid2lkdGgiOjcwLCJoZWlnaHQiOjcwLCJiYWNrZ3JvdW5kIjp7ImNvbG9yIjoie3sgVEVYVF9GT05UX0NPTE9SIH19In19LCJzdGFydCI6MC40LCJsZW5ndGgiOiJlbmQiLCJvZmZzZXQiOnsieCI6LTAuMzI5LCJ5IjotMC4yMDV9LCJwb3NpdGlvbiI6ImNlbnRlciIsInRyYW5zaXRpb24iOnsiaW4iOiJmYWRlIn19XX0seyJjbGlwcyI6W3siYXNzZXQiOnsidHlwZSI6InRleHQiLCJ0ZXh0IjoiIiwiYWxpZ25tZW50Ijp7Imhvcml6b250YWwiOiJjZW50ZXIiLCJ2ZXJ0aWNhbCI6ImNlbnRlciJ9LCJmb250Ijp7ImNvbG9yIjoiIzAwMDAwMCIsImZhbWlseSI6Ik1vbnRzZXJyYXQgRXh0cmFCb2xkIiwic2l6ZSI6NzIsImxpbmVIZWlnaHQiOjF9LCJ3aWR0aCI6NzAsImhlaWdodCI6NzAsImJhY2tncm91bmQiOnsiY29sb3IiOiJ7eyBURVhUX0ZPTlRfQ09MT1IgfX0ifX0sInN0YXJ0IjowLjQsImxlbmd0aCI6ImVuZCIsIm9mZnNldCI6eyJ4IjowLjA3LCJ5IjotMC4yMDV9LCJwb3NpdGlvbiI6ImNlbnRlciIsInRyYW5zaXRpb24iOnsiaW4iOiJmYWRlIn19LHsiYXNzZXQiOnsidHlwZSI6Imx1bWEiLCJzcmMiOiJodHRwczovL3RlbXBsYXRlcy5zaG90c3RhY2suaW8vaWRlYWwtYXBhcnRtZW50LWNvdmV0ZWQtbG9jYXRpb24vZjA4M2ViMDktMWEzMi00ZWU2LWFlYTItY2QzYWZjMGMyNzQ4L3NvdXJjZS5wbmcifSwic3RhcnQiOjAuNCwibGVuZ3RoIjoiZW5kIn1dfSx7ImNsaXBzIjpbeyJhc3NldCI6eyJ0eXBlIjoidGV4dCIsInRleHQiOiJ7e1MyX1RJVExFfX0iLCJhbGlnbm1lbnQiOnsiaG9yaXpvbnRhbCI6ImNlbnRlciIsInZlcnRpY2FsIjoiY2VudGVyIn0sImZvbnQiOnsiY29sb3IiOiJ7eyBURVhUX0ZPTlRfQ09MT1IgfX0iLCJmYW1pbHkiOiJNb250c2VycmF0IEV4dHJhQm9sZCIsInNpemUiOiI0MiIsImxpbmVIZWlnaHQiOjF9LCJ3aWR0aCI6ODAwLCJoZWlnaHQiOjEwMH0sInN0YXJ0IjowLjcsImxlbmd0aCI6ImVuZCIsIm9mZnNldCI6eyJ5IjotMC4zNzF9LCJ0cmFuc2l0aW9uIjp7ImluIjoic2xpZGVVcCJ9fV19LHsiY2xpcHMiOlt7ImFzc2V0Ijp7InR5cGUiOiJ0ZXh0IiwidGV4dCI6IiIsImFsaWdubWVudCI6eyJob3Jpem9udGFsIjoiY2VudGVyIiwidmVydGljYWwiOiJjZW50ZXIifSwiZm9udCI6eyJjb2xvciI6IiMwMDAwMDAiLCJmYW1pbHkiOiJNb250c2VycmF0IEV4dHJhQm9sZCIsInNpemUiOjcyLCJsaW5lSGVpZ2h0IjoxfSwid2lkdGgiOjgwMCwiaGVpZ2h0Ijo0LCJiYWNrZ3JvdW5kIjp7ImNvbG9yIjoie3sgVEVYVF9GT05UX0NPTE9SIH19In19LCJzdGFydCI6MC42LCJsZW5ndGgiOiJlbmQiLCJvZmZzZXQiOnsieSI6LTAuMzN9LCJ0cmFuc2l0aW9uIjp7ImluIjoiZmFkZSJ9fV19LHsiY2xpcHMiOlt7ImFzc2V0Ijp7InR5cGUiOiJ0ZXh0IiwidGV4dCI6IiIsImFsaWdubWVudCI6eyJob3Jpem9udGFsIjoiY2VudGVyIiwidmVydGljYWwiOiJjZW50ZXIifSwiZm9udCI6eyJjb2xvciI6IiMwMDAwMDAiLCJmYW1pbHkiOiJNb250c2VycmF0IEV4dHJhQm9sZCIsInNpemUiOjcyLCJsaW5lSGVpZ2h0IjoxfSwid2lkdGgiOjgwMCwiaGVpZ2h0IjozLCJiYWNrZ3JvdW5kIjp7ImNvbG9yIjoie3sgVEVYVF9GT05UX0NPTE9SIH19In19LCJzdGFydCI6MC41LCJsZW5ndGgiOiJlbmQiLCJvZmZzZXQiOnsieSI6LTAuMjM1fSwidHJhbnNpdGlvbiI6eyJpbiI6ImZhZGUifX1dfSx7ImNsaXBzIjpbeyJhc3NldCI6eyJ0eXBlIjoidGV4dCIsInRleHQiOiIiLCJhbGlnbm1lbnQiOnsiaG9yaXpvbnRhbCI6ImNlbnRlciIsInZlcnRpY2FsIjoiY2VudGVyIn0sImZvbnQiOnsiY29sb3IiOiIjMDAwMDAwIiwiZmFtaWx5IjoiTW9udHNlcnJhdCBFeHRyYUJvbGQiLCJzaXplIjo3MiwibGluZUhlaWdodCI6MX0sIndpZHRoIjozLCJoZWlnaHQiOjM1MCwiYmFja2dyb3VuZCI6eyJjb2xvciI6Int7IFRFWFRfRk9OVF9DT0xPUiB9fSJ9fSwic3RhcnQiOjAuNCwibGVuZ3RoIjoiZW5kIiwib2Zmc2V0Ijp7IngiOjAsInkiOi0wLjI1NH0sInBvc2l0aW9uIjoiY2VudGVyIiwidHJhbnNpdGlvbiI6eyJpbiI6ImZhZGUifX1dfSx7ImNsaXBzIjpbeyJhc3NldCI6eyJ0eXBlIjoidGV4dCIsInRleHQiOiJ7e0RFU0NSSVBUSU9OfX0iLCJhbGlnbm1lbnQiOnsiaG9yaXpvbnRhbCI6ImNlbnRlciIsInZlcnRpY2FsIjoiY2VudGVyIn0sImZvbnQiOnsiY29sb3IiOiJ7eyBURVhUX0ZPTlRfQ09MT1IgfX0iLCJmYW1pbHkiOiJEaWRhY3QgR290aGljIiwic2l6ZSI6IjQ2IiwibGluZUhlaWdodCI6MX0sIndpZHRoIjo0MDAsImhlaWdodCI6NzV9LCJzdGFydCI6MC4yNSwibGVuZ3RoIjoiZW5kIiwib2Zmc2V0Ijp7IngiOjAsInkiOjAuMTI3fSwicG9zaXRpb24iOiJjZW50ZXIiLCJ0cmFuc2l0aW9uIjp7ImluIjoic2xpZGVVcCJ9fV19LHsiY2xpcHMiOlt7ImFzc2V0Ijp7InR5cGUiOiJ0ZXh0IiwidGV4dCI6Int7QUREUkVTU319IiwiYWxpZ25tZW50Ijp7Imhvcml6b250YWwiOiJjZW50ZXIiLCJ2ZXJ0aWNhbCI6ImNlbnRlciJ9LCJmb250Ijp7ImNvbG9yIjoie3sgVEVYVF9GT05UX0NPTE9SIH19IiwiZmFtaWx5IjoiRGlkYWN0IEdvdGhpYyIsInNpemUiOiI0MSIsImxpbmVIZWlnaHQiOjF9LCJ3aWR0aCI6NjAwLCJoZWlnaHQiOjU1fSwic3RhcnQiOjAuMTUsImxlbmd0aCI6ImVuZCIsIm9mZnNldCI6eyJ4IjowLCJ5IjowLjI0N30sInBvc2l0aW9uIjoiY2VudGVyIiwidHJhbnNpdGlvbiI6eyJpbiI6InNsaWRlVXAifX1dfSx7ImNsaXBzIjpbeyJhc3NldCI6eyJ0eXBlIjoidGV4dCIsInRleHQiOiJ7e1RJVExFfX0iLCJhbGlnbm1lbnQiOnsiaG9yaXpvbnRhbCI6ImNlbnRlciIsInZlcnRpY2FsIjoiY2VudGVyIn0sImZvbnQiOnsiY29sb3IiOiJ7eyBURVhUX0ZPTlRfQ09MT1IgfX0iLCJmYW1pbHkiOiJOb3RvIFNlcmlmIEtoaXRhbiBTbWFsbCBTY3JpcHQiLCJzaXplIjoiMTI3IiwibGluZUhlaWdodCI6MX0sIndpZHRoIjo3MDAsImhlaWdodCI6MjAwfSwic3RhcnQiOjAuMiwibGVuZ3RoIjoiZW5kIiwib2Zmc2V0Ijp7IngiOjAsInkiOjAuMTg1fSwicG9zaXRpb24iOiJjZW50ZXIiLCJ0cmFuc2l0aW9uIjp7ImluIjoic2xpZGVVcCJ9fV19LHsiY2xpcHMiOlt7ImFzc2V0Ijp7InR5cGUiOiJsdW1hIiwic3JjIjoiaHR0cHM6Ly90ZW1wbGF0ZXMuc2hvdHN0YWNrLmlvL2lkZWFsLWFwYXJ0bWVudC1jb3ZldGVkLWxvY2F0aW9uL2U2MzM4MjQ2LWU4NzItNGZmYS1hZTNmLTlkMjc5YThkNWI0MS9zb3VyY2UucG5nIn0sInN0YXJ0IjowLCJsZW5ndGgiOiJlbmQifSx7ImFzc2V0Ijp7InR5cGUiOiJ0ZXh0IiwidGV4dCI6IiIsImFsaWdubWVudCI6eyJob3Jpem9udGFsIjoiY2VudGVyIiwidmVydGljYWwiOiJjZW50ZXIifSwiZm9udCI6eyJjb2xvciI6IiMwMDAwMDAiLCJmYW1pbHkiOiJNb250c2VycmF0IEV4dHJhQm9sZCIsInNpemUiOjcyLCJsaW5lSGVpZ2h0IjoxfSwid2lkdGgiOjgwMCwiaGVpZ2h0Ijo0MDAsImJhY2tncm91bmQiOnsiY29sb3IiOiJ7eyBURVhUX0ZPTlRfQ09MT1IgfX0ifX0sInN0YXJ0IjowLCJsZW5ndGgiOiJlbmQiLCJvZmZzZXQiOnsieSI6MC4xODUsIngiOjB9LCJwb3NpdGlvbiI6ImNlbnRlciIsInRyYW5zaXRpb24iOnsiaW4iOiJmYWRlRmFzdCJ9fV19LHsiY2xpcHMiOlt7ImFzc2V0Ijp7InR5cGUiOiJ0ZXh0IiwidGV4dCI6IiIsImFsaWdubWVudCI6eyJob3Jpem9udGFsIjoiY2VudGVyIiwidmVydGljYWwiOiJjZW50ZXIifSwiZm9udCI6eyJjb2xvciI6Int7IFRFWFRfRk9OVF9DT0xPUiB9fSIsImZhbWlseSI6Ik1vbnRzZXJyYXQgRXh0cmFCb2xkIiwic2l6ZSI6NzIsImxpbmVIZWlnaHQiOjF9LCJ3aWR0aCI6MTA1MCwiaGVpZ2h0Ijo2NTAsImJhY2tncm91bmQiOnsiY29sb3IiOiJ7eyBURVhUX0ZPTlRfQ09MT1IgfX0ifX0sInN0YXJ0IjowLjM1LCJsZW5ndGgiOiJlbmQiLCJvZmZzZXQiOnsieSI6LTAuMzA2LCJ4IjowfSwicG9zaXRpb24iOiJjZW50ZXIiLCJ0cmFuc2l0aW9uIjp7ImluIjoiZmFkZSJ9fSx7ImFzc2V0Ijp7InR5cGUiOiJsdW1hIiwic3JjIjoiaHR0cHM6Ly90ZW1wbGF0ZXMuc2hvdHN0YWNrLmlvL2lkZWFsLWFwYXJ0bWVudC1jb3ZldGVkLWxvY2F0aW9uLzFmMDVhNGQ3LTg1MDMtNGY4NC1hNmQxLTQ2NWMwZjY5M2YwZS9zb3VyY2UucG5nIn0sInN0YXJ0IjowLjM1LCJsZW5ndGgiOiJlbmQifV19LHsiY2xpcHMiOlt7ImFzc2V0Ijp7InR5cGUiOiJ0ZXh0IiwidGV4dCI6IiIsImFsaWdubWVudCI6eyJob3Jpem9udGFsIjoiY2VudGVyIiwidmVydGljYWwiOiJjZW50ZXIifSwiZm9udCI6eyJjb2xvciI6IiMwMDAwMDAiLCJmYW1pbHkiOiJNb250c2VycmF0IEV4dHJhQm9sZCIsInNpemUiOjcyLCJsaW5lSGVpZ2h0IjoxfSwid2lkdGgiOjc4MCwiaGVpZ2h0IjozOTAsImJhY2tncm91bmQiOnsiY29sb3IiOiJ7eyBCQUNLR1JPVU5EX0NPTE9SIH19IiwiYm9yZGVyUmFkaXVzIjo0MH19LCJzdGFydCI6MCwibGVuZ3RoIjoiZW5kIiwib2Zmc2V0Ijp7InkiOjAuMTg1fSwidHJhbnNpdGlvbiI6eyJpbiI6ImZhZGVGYXN0In19XX0seyJjbGlwcyI6W3sibGVuZ3RoIjoiZW5kIiwiYXNzZXQiOnsidHlwZSI6InZpZGVvIiwic3JjIjoie3sgVklERU9fU1JDXzIgfX0iLCJ2b2x1bWUiOjB9LCJzdGFydCI6MCwic2NhbGUiOjAuMywib2Zmc2V0Ijp7InkiOjAuMDIzfSwidHJhbnNpdGlvbiI6eyJpbiI6ImZhZGUifX1dfSx7ImNsaXBzIjpbeyJsZW5ndGgiOjEwLCJhc3NldCI6eyJ0eXBlIjoidmlkZW8iLCJzcmMiOiJ7eyBWSURFT19TUkMgfX0iLCJ2b2x1bWUiOjB9LCJzdGFydCI6MCwic2NhbGUiOjAuMywib2Zmc2V0Ijp7IngiOjAsInkiOjAuMzM3fSwicG9zaXRpb24iOiJjZW50ZXIiLCJ0cmFuc2l0aW9uIjp7ImluIjoiZmFkZSJ9fV19LHsiY2xpcHMiOlt7ImFzc2V0Ijp7InR5cGUiOiJ0ZXh0IiwidGV4dCI6IiIsImFsaWdubWVudCI6eyJob3Jpem9udGFsIjoiY2VudGVyIiwidmVydGljYWwiOiJjZW50ZXIifSwiZm9udCI6eyJjb2xvciI6IiMwMDAwMDAiLCJmYW1pbHkiOiJNb250c2VycmF0IEV4dHJhQm9sZCIsInNpemUiOjcyLCJsaW5lSGVpZ2h0IjoxfSwid2lkdGgiOjEwODAsImhlaWdodCI6MTkyMCwiYmFja2dyb3VuZCI6eyJjb2xvciI6Int7IEJBQ0tHUk9VTkRfQ09MT1IgfX0ifX0sInN0YXJ0IjowLCJsZW5ndGgiOiJlbmQifV19XX0sIm91dHB1dCI6eyJmb3JtYXQiOiJtcDQiLCJmcHMiOjI1LCJzaXplIjp7IndpZHRoIjoxMDgwLCJoZWlnaHQiOjE5MjB9fSwibWVyZ2UiOlt7ImZpbmQiOiJBRERSRVNTIiwicmVwbGFjZSI6IjEyMyBBbnl3aGVyZSBTdC4sIEFueSBDaXR5In0seyJmaW5kIjoiVElUTEUiLCJyZXBsYWNlIjoiRk9SIFNBTEUifSx7ImZpbmQiOiJERVNDUklQVElPTiIsInJlcGxhY2UiOiJQUklDRSA6ICQzNTAwMDAifSx7ImZpbmQiOiJTMV9ERVNDUklQVElPTiIsInJlcGxhY2UiOiIyIEJhdGhyb29tcyJ9LHsiZmluZCI6IlMxX0RFU0NSSVBUSU9OXzIiLCJyZXBsYWNlIjoiMiBCZWRyb29tcyJ9LHsiZmluZCI6IlMxX0RFU0NSSVBUSU9OXzMiLCJyZXBsYWNlIjoiMTUwMCBTcWZ0LiJ9LHsiZmluZCI6IlMxX0RFU0NSSVBUSU9OXzQiLCJyZXBsYWNlIjoiMSBDYXIgR2FyYWdlIn0seyJmaW5kIjoiUzJfVElUTEUiLCJyZXBsYWNlIjoiR2V0IGluIFRvdWNoIEZvciBNb3JlIEluZm8hIn0seyJmaW5kIjoiUzJfREVTQ1JJUFRJT05fMSIsInJlcGxhY2UiOiJoZWxsb0ByZWFsbHlncmVhdHNpdGUuY29tIn0seyJmaW5kIjoiUzJfREVTQ1JJUFRJT05fMiIsInJlcGxhY2UiOiIrMTIzLTQ1Ni03ODkwIn0seyJmaW5kIjoiVEVYVF9GT05UX0NPTE9SIiwicmVwbGFjZSI6IiMwMDAwMDAifSx7ImZpbmQiOiJCQUNLR1JPVU5EX0NPTE9SIiwicmVwbGFjZSI6IiNmZmZmZmYifSx7ImZpbmQiOiJWSURFT19TUkMiLCJyZXBsYWNlIjoiaHR0cHM6Ly90ZW1wbGF0ZXMuc2hvdHN0YWNrLmlvL2lkZWFsLWFwYXJ0bWVudC1jb3ZldGVkLWxvY2F0aW9uLzQ3MmViMWQ0LTdhODItNDYxYi1iOTExLTRiNzkzNjE1YTQ1MS9zb3VyY2UubXA0In0seyJmaW5kIjoiVklERU9fU1JDXzIiLCJyZXBsYWNlIjoiaHR0cHM6Ly90ZW1wbGF0ZXMuc2hvdHN0YWNrLmlvL2lkZWFsLWFwYXJ0bWVudC1jb3ZldGVkLWxvY2F0aW9uLzIzYmMxNDEyLWQzYjEtNDRmZS05NmZjLTkzZDVkNGE1YjZjMC9zb3VyY2UubXA0In0seyJmaW5kIjoiQVVESU9fU1JDIiwicmVwbGFjZSI6Imh0dHBzOi8vdGVtcGxhdGVzLnNob3RzdGFjay5pby9pZGVhbC1hcGFydG1lbnQtY292ZXRlZC1sb2NhdGlvbi85NWUzMzI2Ni1jNWYzLTQ3NTMtYTcyYy1hYzM4MmZlYWRlZmIvc2hvdHN0YWNrLXByb3h5Lm1wMyJ9XX0 - **Edit and save to an account**: https://dashboard.shotstack.io/studio/editor/ideal-apartment-coveted-location ## 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 | | --- | --- | | `{{ ADDRESS }}` | 123 Anywhere St., Any City | | `{{ TITLE }}` | FOR SALE | | `{{ DESCRIPTION }}` | PRICE : $350000 | | `{{ S1_DESCRIPTION }}` | 2 Bathrooms | | `{{ S1_DESCRIPTION_2 }}` | 2 Bedrooms | | `{{ S1_DESCRIPTION_3 }}` | 1500 Sqft. | | `{{ S1_DESCRIPTION_4 }}` | 1 Car Garage | | `{{ S2_TITLE }}` | Get in Touch For More Info! | | `{{ S2_DESCRIPTION_1 }}` | hello@reallygreatsite.com | | `{{ S2_DESCRIPTION_2 }}` | +123-456-7890 | | `{{ TEXT_FONT_COLOR }}` | #000000 | | `{{ BACKGROUND_COLOR }}` | #ffffff | | `{{ VIDEO_SRC }}` | https://templates.shotstack.io/ideal-apartment-coveted-location/472eb1d4-7a82-461b-b911-4b793615a451/source.mp4 | | `{{ VIDEO_SRC_2 }}` | https://templates.shotstack.io/ideal-apartment-coveted-location/23bc1412-d3b1-44fe-96fc-93d5d4a5b6c0/source.mp4 | | `{{ AUDIO_SRC }}` | https://templates.shotstack.io/ideal-apartment-coveted-location/95e33266-c5f3-4753-a72c-ac382feadefb/shotstack-proxy.mp3 | ## Template JSON ```json { "timeline": { "fonts": [ { "src": "https://templates.shotstack.io/ideal-apartment-coveted-location/0070f0ca-4f29-4b77-a1e0-ffadfcd77abd/jizzRFVKsm4Bt9PrbSzC4KLlQUF5lRJg5j-l5PvyhfTdd4TcYMNf.ttf" } ], "background": "#FFFFFF", "tracks": [ { "clips": [ { "length": "end", "asset": { "type": "audio", "src": "{{ AUDIO_SRC }}", "volume": 1 }, "start": 0 } ] }, { "clips": [ { "asset": { "type": "text", "text": "{{S1_DESCRIPTION_3}}", "alignment": { "horizontal": "left", "vertical": "center" }, "font": { "color": "{{ TEXT_FONT_COLOR }}", "family": "Montserrat SemiBold", "size": "35", "lineHeight": 1 }, "width": 283, "height": 75 }, "start": 0.6, "length": "end", "offset": { "x": -0.149, "y": -0.302 }, "position": "center", "transition": { "in": "slideUp" } } ] }, { "clips": [ { "asset": { "type": "text", "text": "{{S1_DESCRIPTION_4}}", "alignment": { "horizontal": "left", "vertical": "center" }, "font": { "color": "{{ TEXT_FONT_COLOR }}", "family": "Montserrat SemiBold", "size": "35", "lineHeight": 1 }, "width": 283, "height": 75 }, "start": 0.6, "length": "end", "offset": { "x": 0.251, "y": -0.302 }, "position": "center", "transition": { "in": "slideUp" } } ] }, { "clips": [ { "asset": { "type": "text", "text": "{{S1_DESCRIPTION}}", "alignment": { "horizontal": "left", "vertical": "center" }, "font": { "color": "{{ TEXT_FONT_COLOR }}", "family": "Montserrat SemiBold", "size": "35", "lineHeight": 1 }, "width": 283, "height": 75 }, "start": 0.45, "length": "end", "offset": { "x": -0.149, "y": -0.206 }, "position": "center", "transition": { "in": "slideUp" } } ] }, { "clips": [ { "asset": { "type": "text", "text": "{{S1_DESCRIPTION_2}}", "alignment": { "horizontal": "left", "vertical": "center" }, "font": { "color": "{{ TEXT_FONT_COLOR }}", "family": "Montserrat SemiBold", "size": "35", "lineHeight": 1 }, "width": 283, "height": 75 }, "start": 0.45, "length": "end", "offset": { "x": 0.251, "y": -0.206 }, "position": "center", "transition": { "in": "slideUp" } } ] }, { "clips": [ { "asset": { "type": "text", "text": "{{S2_DESCRIPTION_2}}", "alignment": { "horizontal": "center", "vertical": "center" }, "font": { "color": "{{ TEXT_FONT_COLOR }}", "family": "Didact Gothic", "size": "40", "lineHeight": 1 }, "width": 400, "height": 60 }, "start": 0.8, "length": "end", "offset": { "y": -0.432 }, "transition": { "in": "slideUp" } } ] }, { "clips": [ { "asset": { "type": "text", "text": " {{S2_DESCRIPTION_1}}", "alignment": { "horizontal": "center", "vertical": "center" }, "font": { "color": "{{ TEXT_FONT_COLOR }}", "family": "Didact Gothic", "size": "40", "lineHeight": 1 }, "width": 600, "height": 62 }, "start": 0.75, "length": "end", "offset": { "y": -0.399 }, "transition": { "in": "slideUp" } } ] }, { "clips": [ { "asset": { "type": "text", "text": "", "alignment": { "horizontal": "center", "vertical": "center" }, "font": { "color": "#000000", "family": "Montserrat ExtraBold", "size": 72, "lineHeight": 1 }, "width": 70, "height": 70, "background": { "color": "{{ TEXT_FONT_COLOR }}" } }, "start": 0.55, "length": "end", "offset": { "x": -0.329, "y": -0.298 }, "position": "center", "transition": { "in": "fade" } }, { "asset": { "type": "luma", "src": "https://templates.shotstack.io/ideal-apartment-coveted-location/be3a5b91-3137-4dd3-b4bb-f703eff5f1c4/source.png" }, "start": 0.55, "length": "end" } ] }, { "clips": [ { "asset": { "type": "text", "text": "", "alignment": { "horizontal": "center", "vertical": "center" }, "font": { "color": "#000000", "family": "Montserrat ExtraBold", "size": 72, "lineHeight": 1 }, "width": 70, "height": 70, "background": { "color": "{{ TEXT_FONT_COLOR }}" } }, "start": 0.55, "length": "end", "offset": { "x": 0.07, "y": -0.298 }, "position": "center", "transition": { "in": "fade" } }, { "asset": { "type": "luma", "src": "https://templates.shotstack.io/ideal-apartment-coveted-location/7711ad9c-fe39-402e-8d03-0da62631058e/source.png" }, "start": 0.55, "length": "end" } ] }, { "clips": [ { "asset": { "type": "luma", "src": "https://templates.shotstack.io/ideal-apartment-coveted-location/bfa24c26-b0ea-4595-83c5-882b19f867e0/source.png" }, "start": 0.4, "length": "end" }, { "asset": { "type": "text", "text": "", "alignment": { "horizontal": "center", "vertical": "center" }, "font": { "color": "#000000", "family": "Montserrat ExtraBold", "size": 72, "lineHeight": 1 }, "width": 70, "height": 70, "background": { "color": "{{ TEXT_FONT_COLOR }}" } }, "start": 0.4, "length": "end", "offset": { "x": -0.329, "y": -0.205 }, "position": "center", "transition": { "in": "fade" } } ] }, { "clips": [ { "asset": { "type": "text", "text": "", "alignment": { "horizontal": "center", "vertical": "center" }, "font": { "color": "#000000", "family": "Montserrat ExtraBold", "size": 72, "lineHeight": 1 }, "width": 70, "height": 70, "background": { "color": "{{ TEXT_FONT_COLOR }}" } }, "start": 0.4, "length": "end", "offset": { "x": 0.07, "y": -0.205 }, "position": "center", "transition": { "in": "fade" } }, { "asset": { "type": "luma", "src": "https://templates.shotstack.io/ideal-apartment-coveted-location/f083eb09-1a32-4ee6-aea2-cd3afc0c2748/source.png" }, "start": 0.4, "length": "end" } ] }, { "clips": [ { "asset": { "type": "text", "text": "{{S2_TITLE}}", "alignment": { "horizontal": "center", "vertical": "center" }, "font": { "color": "{{ TEXT_FONT_COLOR }}", "family": "Montserrat ExtraBold", "size": "42", "lineHeight": 1 }, "width": 800, "height": 100 }, "start": 0.7, "length": "end", "offset": { "y": -0.371 }, "transition": { "in": "slideUp" } } ] }, { "clips": [ { "asset": { "type": "text", "text": "", "alignment": { "horizontal": "center", "vertical": "center" }, "font": { "color": "#000000", "family": "Montserrat ExtraBold", "size": 72, "lineHeight": 1 }, "width": 800, "height": 4, "background": { "color": "{{ TEXT_FONT_COLOR }}" } }, "start": 0.6, "length": "end", "offset": { "y": -0.33 }, "transition": { "in": "fade" } } ] }, { "clips": [ { "asset": { "type": "text", "text": "", "alignment": { "horizontal": "center", "vertical": "center" }, "font": { "color": "#000000", "family": "Montserrat ExtraBold", "size": 72, "lineHeight": 1 }, "width": 800, "height": 3, "background": { "color": "{{ TEXT_FONT_COLOR }}" } }, "start": 0.5, "length": "end", "offset": { "y": -0.235 }, "transition": { "in": "fade" } } ] }, { "clips": [ { "asset": { "type": "text", "text": "", "alignment": { "horizontal": "center", "vertical": "center" }, "font": { "color": "#000000", "family": "Montserrat ExtraBold", "size": 72, "lineHeight": 1 }, "width": 3, "height": 350, "background": { "color": "{{ TEXT_FONT_COLOR }}" } }, "start": 0.4, "length": "end", "offset": { "x": 0, "y": -0.254 }, "position": "center", "transition": { "in": "fade" } } ] }, { "clips": [ { "asset": { "type": "text", "text": "{{DESCRIPTION}}", "alignment": { "horizontal": "center", "vertical": "center" }, "font": { "color": "{{ TEXT_FONT_COLOR }}", "family": "Didact Gothic", "size": "46", "lineHeight": 1 }, "width": 400, "height": 75 }, "start": 0.25, "length": "end", "offset": { "x": 0, "y": 0.127 }, "position": "center", "transition": { "in": "slideUp" } } ] }, { "clips": [ { "asset": { "type": "text", "text": "{{ADDRESS}}", "alignment": { "horizontal": "center", "vertical": "center" }, "font": { "color": "{{ TEXT_FONT_COLOR }}", "family": "Didact Gothic", "size": "41", "lineHeight": 1 }, "width": 600, "height": 55 }, "start": 0.15, "length": "end", "offset": { "x": 0, "y": 0.247 }, "position": "center", "transition": { "in": "slideUp" } } ] }, { "clips": [ { "asset": { "type": "text", "text": "{{TITLE}}", "alignment": { "horizontal": "center", "vertical": "center" }, "font": { "color": "{{ TEXT_FONT_COLOR }}", "family": "Noto Serif Khitan Small Script", "size": "127", "lineHeight": 1 }, "width": 700, "height": 200 }, "start": 0.2, "length": "end", "offset": { "x": 0, "y": 0.185 }, "position": "center", "transition": { "in": "slideUp" } } ] }, { "clips": [ { "asset": { "type": "luma", "src": "https://templates.shotstack.io/ideal-apartment-coveted-location/e6338246-e872-4ffa-ae3f-9d279a8d5b41/source.png" }, "start": 0, "length": "end" }, { "asset": { "type": "text", "text": "", "alignment": { "horizontal": "center", "vertical": "center" }, "font": { "color": "#000000", "family": "Montserrat ExtraBold", "size": 72, "lineHeight": 1 }, "width": 800, "height": 400, "background": { "color": "{{ TEXT_FONT_COLOR }}" } }, "start": 0, "length": "end", "offset": { "y": 0.185, "x": 0 }, "position": "center", "transition": { "in": "fadeFast" } } ] }, { "clips": [ { "asset": { "type": "text", "text": "", "alignment": { "horizontal": "center", "vertical": "center" }, "font": { "color": "{{ TEXT_FONT_COLOR }}", "family": "Montserrat ExtraBold", "size": 72, "lineHeight": 1 }, "width": 1050, "height": 650, "background": { "color": "{{ TEXT_FONT_COLOR }}" } }, "start": 0.35, "length": "end", "offset": { "y": -0.306, "x": 0 }, "position": "center", "transition": { "in": "fade" } }, { "asset": { "type": "luma", "src": "https://templates.shotstack.io/ideal-apartment-coveted-location/1f05a4d7-8503-4f84-a6d1-465c0f693f0e/source.png" }, "start": 0.35, "length": "end" } ] }, { "clips": [ { "asset": { "type": "text", "text": "", "alignment": { "horizontal": "center", "vertical": "center" }, "font": { "color": "#000000", "family": "Montserrat ExtraBold", "size": 72, "lineHeight": 1 }, "width": 780, "height": 390, "background": { "color": "{{ BACKGROUND_COLOR }}", "borderRadius": 40 } }, "start": 0, "length": "end", "offset": { "y": 0.185 }, "transition": { "in": "fadeFast" } } ] }, { "clips": [ { "length": "end", "asset": { "type": "video", "src": "{{ VIDEO_SRC_2 }}", "volume": 0 }, "start": 0, "scale": 0.3, "offset": { "y": 0.023 }, "transition": { "in": "fade" } } ] }, { "clips": [ { "length": 10, "asset": { "type": "video", "src": "{{ VIDEO_SRC }}", "volume": 0 }, "start": 0, "scale": 0.3, "offset": { "x": 0, "y": 0.337 }, "position": "center", "transition": { "in": "fade" } } ] }, { "clips": [ { "asset": { "type": "text", "text": "", "alignment": { "horizontal": "center", "vertical": "center" }, "font": { "color": "#000000", "family": "Montserrat ExtraBold", "size": 72, "lineHeight": 1 }, "width": 1080, "height": 1920, "background": { "color": "{{ BACKGROUND_COLOR }}" } }, "start": 0, "length": "end" } ] } ] }, "output": { "format": "mp4", "fps": 25, "size": { "width": 1080, "height": 1920 } }, "merge": [ { "find": "ADDRESS", "replace": "123 Anywhere St., Any City" }, { "find": "TITLE", "replace": "FOR SALE" }, { "find": "DESCRIPTION", "replace": "PRICE : $350000" }, { "find": "S1_DESCRIPTION", "replace": "2 Bathrooms" }, { "find": "S1_DESCRIPTION_2", "replace": "2 Bedrooms" }, { "find": "S1_DESCRIPTION_3", "replace": "1500 Sqft." }, { "find": "S1_DESCRIPTION_4", "replace": "1 Car Garage" }, { "find": "S2_TITLE", "replace": "Get in Touch For More Info!" }, { "find": "S2_DESCRIPTION_1", "replace": "hello@reallygreatsite.com" }, { "find": "S2_DESCRIPTION_2", "replace": "+123-456-7890" }, { "find": "TEXT_FONT_COLOR", "replace": "#000000" }, { "find": "BACKGROUND_COLOR", "replace": "#ffffff" }, { "find": "VIDEO_SRC", "replace": "https://templates.shotstack.io/ideal-apartment-coveted-location/472eb1d4-7a82-461b-b911-4b793615a451/source.mp4" }, { "find": "VIDEO_SRC_2", "replace": "https://templates.shotstack.io/ideal-apartment-coveted-location/23bc1412-d3b1-44fe-96fc-93d5d4a5b6c0/source.mp4" }, { "find": "AUDIO_SRC", "replace": "https://templates.shotstack.io/ideal-apartment-coveted-location/95e33266-c5f3-4753-a72c-ac382feadefb/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