> ## Documentation Index
> Fetch the complete documentation index at: https://docs.narrative.video/llms.txt
> Use this file to discover all available pages before exploring further.

# Introduction

> AI-powered social media hook generation and video analysis

## 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

```bash theme={null}
# 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) |

<Card title="OpenAPI Specification" icon="file-code" href="/api-reference/clipping-openapi.json">
  View the full OpenAPI specification
</Card>