GET/v1/hooks/{id}1 credits

Get a hook

Rich record for one hook. Unknown or malformed ids return 404.

Needs hooks:read on the key. This is a permission on the key, not a request header. Missing it returns 403 api_not_enabled.

Request parameters

Name	In	Type	Required	Description
`id`	path	string	Required	Public id, `hook_` plus 32 hex characters.

Response

{
  "id": "hook_9f2a1c0b4e7d4a1f8c3e2d1b0a9f8e7d",
  "text": "Stop scrolling if you edit short-form.",
  "platform": "tiktok",
  "media_type": "video",
  "thumbnail_url": "https://cdn.example/thumb.jpg",
  "category": "education",
  "hook_duration_sec": 2.4,
  "published_at": "2026-03-12T18:04:00.000Z",
  "source_url": "https://www.tiktok.com/@studio/video/1",
  "caption": "Cut the greeting. Start on the claim.",
  "duration_sec": 18,
  "summary": "A cut-bay lesson on opening frames.",
  "emotions": null,
  "comment_themes": null,
  "metrics": null,
  "creator": null,
  "audio": null
}

Response fields

Name	Type	Required	Description
`id`	string	Required	Public id, `hook_` plus 32 hex characters.
`text`	string	Required	Hook copy.
`platform`	string	Required	Source platform, for example `tiktok`.
`media_type`	string	Nullable	Media kind when known.
`thumbnail_url`	string	Nullable	Thumbnail URL when known.
`category`	string	Nullable	Category slug when known.
`hook_duration_sec`	number	Nullable	Opening duration in seconds when known.
`published_at`	string	Nullable	Publish timestamp when known.
`source_url`	string	Nullable	Canonical source URL when known.
`caption`	string	Nullable	Source caption when known.
`duration_sec`	number	Nullable	Full clip duration in seconds when known.
`summary`	string	Nullable	Short summary when known.
`emotions`	object	Nullable	Emotion weights, 0–100. Keys: `inspiration`, `fear`, `curiosity`, `satisfaction`, `happiness`, `anger`, `surprise`.
`comment_themes`	array	Nullable	Frequent comment words, each `{ "word": string, "count": number }`.
`metrics`	unknown	Nullable	Nullable JSON value. Inner keys are not fixed in the public schema.
`creator`	unknown	Nullable	Nullable JSON value. Inner keys are not fixed in the public schema.
`audio`	unknown	Nullable	Nullable JSON value. Inner keys are not fixed in the public schema.