Introduction - Narrative API

Hooks API

The Hooks API provides tools for creating engaging social media content from episodic video. Transform TV series episodes into viral hooks with automatic cliffhanger detection.

Key Features

Episode Preparation - Merge multiple episodes into continuous video with smart transitions
Hook Generation - Create engaging 30-60 second hooks with AI-detected cliffhangers
Multiple Hook Types - Fine cut, compilation, or narration-style hooks
Summarization - Generate AI-powered summaries in multiple formats
Transcription - Extract audio-visual transcripts with timestamps and speaker diarization

Base URL

https://api.usenarrative.ai

API Groups

Group	Description
Hooks	Prepare episodes and generate social media hooks
Analysis	Summarize videos and extract transcripts

Quick Start

# 1. Prepare episodes into continuous video
curl -X POST https://api.usenarrative.ai/api/v1/hooks/prepare \
  -F "videos=@episode-1.mp4" \
  -F "videos=@episode-2.mp4"

# 2. Generate a hook
curl -X POST https://api.usenarrative.ai/api/v1/hooks/generate \
  -H "Content-Type: application/json" \
  -d '{
    "continuous_video_url": "...",
    "transcript_url": "...",
    "hook_type": "fine_cut"
  }'

Hook Types

Type	Description
`fine_cut`	Single 20-40s complete scene, no edits
`compilation`	Setup → Flashback → Continuation structure
`narration`	TikTok-style with AI voiceover (3-4 segments)

OpenAPI Specification

View the full OpenAPI specification