Marketing Architects icon

Marketing Architects

Consume Marketing Architects API

Video → Analyze Video

AI-generated

Summary

Analyze a video from a URL using the Marketing Architects API

Inputs

  • videoUrl (required) — The URL of the video to analyze. Sent as the url field in the request body.
  • customPrompt — Optional custom prompt for video analysis. Sent as the custom_prompt field; if omitted, no custom prompt is sent.
  • outputSchema — Optional JSON schema defining the expected output structure. Sent as the output_schema field after parsing; if omitted, no schema is sent.

Output shape

The API's JSON response, potentially shaped by the provided output schema. On error, the node throws an NodeApiError with status code and error details.

The operation sends a POST request to /video/analyze on the base URL https://pushbtn.api.misfitsandmachines.com, authenticating via the marketingArchitectsApi credentials (Bearer token). Request headers include Accept: application/json and Content-Type: application/json. Generic error handling converts non‑2xx responses into NodeApiError objects.

Examples

Example 1: Basic video analysis

Set Video URL to a publicly accessible MP4 link; leave Custom Prompt and Output Schema blank.

Example 2: Custom analysis with schema

Provide a Video URL, a Custom Prompt such as 'Describe any on‑screen text', and an Output Schema expecting a text string field.

Links

Discussion