GET/v1/hooks/{id}1 crédits

Lire un hook

Fiche riche. Id inconnu ou malformé: 404.

C’est une permission de la clé, pas un en-tête. Sinon 403 api_not_enabled.

Paramètres de la requête

Nom	Dans	Type	Requis	Description
`id`	path	string	Requis	Id public, `hook_` plus 32 hex.

Réponse

{
  "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
}

Champs de réponse

Nom	Type	Requis	Description
`id`	string	Requis	Id public, `hook_` plus 32 hex.
`text`	string	Requis	Texte du hook.
`platform`	string	Requis	Plateforme source, ex. `tiktok`.
`media_type`	string	Nullable	Type de média si connu.
`thumbnail_url`	string	Nullable	URL de miniature si connue.
`category`	string	Nullable	Slug de catégorie si connu.
`hook_duration_sec`	number	Nullable	Durée d’ouverture en secondes si connue.
`published_at`	string	Nullable	Date de publication si connue.
`source_url`	string	Nullable	URL canonique si connue.
`caption`	string	Nullable	Légende source si connue.
`duration_sec`	number	Nullable	Durée du clip en secondes si connue.
`summary`	string	Nullable	Court résumé si connu.
`emotions`	object	Nullable	Poids des émotions, 0–100. Clés : `inspiration`, `fear`, `curiosity`, `satisfaction`, `happiness`, `anger`, `surprise`.
`comment_themes`	array	Nullable	Mots fréquents des commentaires, chacun `{ "word": string, "count": number }`.
`metrics`	unknown	Nullable	JSON nullable. Les clés internes ne sont pas figées.
`creator`	unknown	Nullable	JSON nullable. Les clés internes ne sont pas figées.
`audio`	unknown	Nullable	JSON nullable. Les clés internes ne sont pas figées.