hooks

Playable embed so the clip runs in your page

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.

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

Path parameters

hook_idstring uuid required

Headers

authorizationstring nullable

Bearer hd_... from POST /v1/accounts or POST /v1/keys

Response

Successful Response

platformstring required

video_idstring nullable required

watch_urlstring nullable required

embed_htmlstring nullable required

thumbnailstring nullable required

a picture for the card: the provider's thumbnail, else cover_url, else still_url; never empty on a fallback

authorstring nullable required

cachedboolean required

cover_urlstring nullable required

still_urlstring nullable

the hook's still as a JPEG, served by this API; no key needed

Example response

{
  "author": "someone",
  "cached": true,
  "embed_html": "<blockquote ...></blockquote>",
  "kind": "embed",
  "platform": "tiktok",
  "still_url": "https://api.hookdetector.com/v1/hooks/1a2b3c4d-5e6f-4a7b-8c9d-0e1f2a3b4c5d/still",
  "video_id": "7412345678901234567",
  "watch_url": "https://www.tiktok.com/@someone/video/7412345678901234567"
}

Changes

No recorded changes to this operation across all 1 revision of this API.