2.0.0 • Public • Published

Note: Updated for API v2.0

Create videos programmatically in Node JS

Create and edit videos: add watermarks, resize videos, create slideshows, add soundtrack, automate the creation of videos in multiple languages, add voice-over, add text animations.

JSON2Video API is the easiest way to create, edit and customise videos programmatically. Its dead simple approach, close to the web development mindset, makes it the ultimate solution for developers that want to create or customise videos in an automated way.

Additionally, the simple integration of real HTML5+CSS elements, the already built-in text animations and voice generation (TTS) converts JSON2Video in the best solution in its category.

Use cases

  • Automate the production of promotional videos for your e-commerce products
  • Automate publication of social media videos created directly from your news feed
  • Customize your advertising campaigns with different images, videos, texts and create tens or hundreds of different options
  • From weather forecasts to traffic bulletins or financial reports, if you have a data source you can create an audiovisual experience
  • Convert your text, pictures and information into engaging videos of your real estate properties
  • Add watermarks, bumpers, titles; Concatenate different videos into one; Add voice-over or music; Create photo slideshows; …

Get your FREE API Key

JSON2Video is free to use. Get your API Key at JSON2Video.com


The API Specification will provide you with all the details of the JSON payload and the endpoints.

For a step by step guide, read the Tutorial that will introduce you through all features with code examples.

NodeJS SDK installation

The SDK has no external dependencies on other packages.

  1. Open the terminal and cd to your project directory
  2. Use npm:
npm install json2video-sdk

Hello world

JSON2Video makes video creation easy as a piece of cake:

    const {Movie, Scene} = require("json2video-sdk");
    async function main() {
        // Create a new movie
        let movie = new Movie;

        // Set your API key
        // Get your free API key at https://json2video.com

        // Set movie quality: low, medium, high
        movie.set("quality", "high");

        // Generate a video draft 
        movie.set("draft", true);

        // Create a new scene
        let scene = new Scene;

        // Set the scene background color
        scene.set("background-color",  "#4392F1");

        // Add a text element printing "Hello world" in a fancy way (style 003)
        // The element is 10 seconds long and starts 2 seconds from the scene start
            type: "text",
            style: "003",
            text: "Hello world",
            duration: 10,
            start: 2

        // Add the scene to the movie

        // Call the API and render the movie
        let render = await movie.render();

        // Wait for the movie to finish rendering
        await movie
            .waitToFinish((status) => {
                console.log("Rendering: ", status.movie.status, " / ", status.movie.message);
            .then((status) => {
                console.log("Movie is ready: ", status.movie.url);
                console.log("Remaining final movies: ", status.remaining_quota.movies);
                console.log("Remaining drafts: ", status.remaining_quota.drafts);
            .catch((err) => {
                console.log("Error: ", err);


This is the resulting video:



npm i json2video-sdk

DownloadsWeekly Downloads






Unpacked Size

11.5 kB

Total Files


Last publish


  • json2video