---
title: "Real delivered talking-head hooks, for a wait screen"
method: GET
path: "/v1/showcase"
tags: ["hooks"]
---

# Real delivered talking-head hooks, for a wait screen

`GET /v1/showcase`

## Request

- Base URL: `https://api.hookdetector.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.hookdetector.com/v1/showcase`
- Auth: none declared

Hooks this service has delivered, for the first seconds of a wait before a run's own
feed fills: talking heads only, a banner or opening line, a still (still_url, no key),
the most viewed first and one per creator. Only what is already public on TikTok or
Instagram: never a topic, an account or a run. No key needed. Cached 10 minutes. Free.
MCP: showcase.

## Query parameters

- `n` integer: how many; clamped to 1 to 24

## Response `200`

Successful Response

- ShowcaseHook[]
  - `hook_id` string, required
  - `still_url` string, required: the hook's still as a JPEG, no key needed
  - `platform` 'tiktok' | 'instagram' | 'youtube', required
  - `creator` string, required
  - `views` integer, nullable, required
  - `line` string, required: the banner on the video, else its opening line

## Other responses

- `422`: invalid input
- `429`: rate limited; see Retry-After
- `500`: our fault; names the request id

---

[API](https://skmtc.dev/hookdetector/apis/hook-detector.md) · [All operations](https://skmtc.dev/hookdetector/apis/hook-detector/llms.txt) · [OpenAPI document](https://skmtc.dev/hookdetector/apis/hook-detector/revisions/b136a2804d2b?raw)