Blotato icon

Blotato

Use Blotato API

Actions5

Overview

This node integrates with the Blotato API to manage videos, media, and social media posts. Specifically for the Video - Get operation, it retrieves detailed information about a video by its unique ID. This is useful when you want to fetch the current status, metadata, or other details of a previously created video.

Common scenarios include:

  • Checking the processing status of a video after creation.
  • Retrieving video metadata for further automation or reporting.
  • Verifying that a video exists before performing additional actions like posting or deleting.

Example: After creating a video from a template, use this node to get the video's current status and confirm it is ready for publishing.

Properties

Name Meaning
Video ID The unique identifier of the video to retrieve. Example format: 123e4567-e89b-12d3-a456-426614174000

Output

The output JSON contains the full response from the Blotato API for the requested video. It typically includes:

  • item: An object representing the video details.
  • status: The current processing state of the video (e.g., "generating-script", "script-ready", "queueing", or completed).
  • Additional metadata fields describing the video content, creation time, and other relevant attributes.

If the video is still being processed (statuses like "generating-script", "script-ready", or "queueing"), the output will include a warning hint advising to wait longer and check credits.

No binary data is output for this operation.

Example snippet of output JSON structure:

{
  "item": {
    "id": "video-id",
    "status": "completed",
    "metadata": { /* video metadata */ }
  },
  "_hint": "⚠️ Your video/carousel is not done yet. Wait a little longer..."
}

Dependencies

  • Requires an API key credential for authenticating with the Blotato API.
  • The node uses the base URL configured in the credential to build API requests.
  • No other external dependencies are required.

Troubleshooting

  • Missing Video ID: If the Video ID property is empty, the node throws an error indicating the Video ID is required.
  • Video Not Found: If the provided Video ID does not exist, the API may return an error or empty result.
  • Video Still Processing: When the video status is one of "generating-script", "script-ready", or "queueing", the node outputs a warning hint. Users should wait until processing completes.
  • API Errors: Network issues or invalid credentials will cause API request failures. Ensure the API key is valid and the server URL is correct.
  • JSON Parsing Errors: The node attempts to parse API responses; malformed responses could cause errors.

Links and References

Discussion