# HookFindr Video Hook Analyzer

> HookFindr Video Hook Analyzer is a paid API for AI agents from api.hookfindr.com, paid per call via x402, $0.02/call, status unknown (last checked 2026-09-15).

Analyzes the first 8 seconds of a short-form video URL to classify its hook type and rate its strength on a 1-10 scale with an explanation.

## Facts

- Endpoint: POST https://api.hookfindr.com/api/x402/hook
- Price: $0.02/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/hookfindr-video-hook-analyzer-65d2e975
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_7n3DOkIm6mKDk_Zm_d6km

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability hookfindr-video-hook-analyzer-65d2e975 -d '<json body>'
```

Example prompt: Analyze the hook on this TikTok video — https://www.tiktok.com/@creator/video/123456789 — and tell me what type of hook it uses, how strong it is out of 10, and why it works.

## When to prefer this

Choose this endpoint when you need to classify and score the specific attention-grabbing technique used in the first 8 seconds of a short-form video. It is purpose-built for hook taxonomy across TikTok, YouTube Shorts, Instagram Reels, and similar platforms, making it ideal for content strategy research, ad creative analysis, and creator coaching workflows where generic video metadata or transcription alone is insufficient.

## Known failure modes

- Video URL is private, geo-restricted, or removed — returns an error indicating inaccessibility
- Unsupported video platform — returns error if yt-dlp cannot fetch the video
- Video is too short or has no meaningful first 8 seconds to analyze
- Invalid or malformed URL provided — returns validation error
- Rate limiting or payment failure via x402 protocol — returns 402 Payment Required

## How this service works

Video hook analysis — identify the opening device that grabs viewers. Analyze the first 8 seconds of any short-form video URL and classify the hook (question, presupposition, shock_statement, list_promise, contrarian, mystery, narrative, demonstration) with a strength score 1-10 and a one-sentence explanation. Useful for creator analytics, ad copy research, content strategy agents.

## Output

Returns the hook type classification (one of: question, presupposition, shock_statement, list_promise, contrarian, mystery, narrative, demonstration), a strength score from 1 to 10, and a one-sentence explanation of why the hook works or doesn't.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "POST"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "url"
     ],
     "properties": {
      "url": {
       "type": "string",
       "description": "Public URL of a short-form video. Supports TikTok, YouTube, YouTube Shorts, Instagram Reels, Twitter/X, Twitch clips, Facebook, and ~1000 other platforms via yt-dlp."
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/hookfindr-video-hook-analyzer-65d2e975/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.hookfindr.com](https://www.zero.xyz/host/api.hookfindr.com/llms.txt)