---
title: "Playable embed so the clip runs in your page"
method: GET
path: "/v1/hooks/{hook_id}/embed"
tags: ["hooks"]
---

# Playable embed so the clip runs in your page

`GET /v1/hooks/{hook_id}/embed`

## 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/hooks/{hook_id}/embed`
- Auth: none declared

Official TikTok or Instagram embed HTML. kind is "embed", or "fallback" when the
creator disabled embedding or the clip is a photo post found before 2026-09-26 (then
show thumbnail, which
falls back to the hook's still_url, and the transcript; a fallback is remembered for
an hour). For a plain vertical player use the hook's player_url.
Free. MCP: embed_hook.

## Path parameters

- `hook_id` string, uuid, required

## Headers

- `authorization` string, nullable: Bearer hd_... from POST /v1/accounts or POST /v1/keys

## Response `200`

Successful Response

- EmbedOut
  - `platform` string, required
  - `video_id` string, nullable, required
  - `watch_url` string, nullable, required
  - `embed_html` string, nullable, required
  - `thumbnail` string, nullable, required: a picture for the card: the provider's thumbnail, else cover_url, else still_url; never empty on a fallback
  - `author` string, nullable, required
  - `kind` union, required
    - 'embed' | 'fallback'
    - string
  - `cached` boolean, required
  - `cover_url` string, nullable, required
  - `still_url` string, nullable: the hook's still as a JPEG, served by this API; no key needed

## Other responses

- `401`: missing, invalid, revoked or expired API key (code key_expired)
- `403`: the key lacks the scope this call needs (insufficient_scope), or its credit_limit is spent (key_credit_limit_reached)
- `404`: not found on this account
- `413`: request body over the size cap
- `422`: invalid input
- `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)