GET/v1/hooks/listceil(lignes / 25) crédits

Lister les hooks

Un slug category. Obligatoire. Inconnu: 422. Slugs: catégories.

La requête réserve 2 crédits, puis settle ceil(lignes / 25). Page vide: 0. Un wallet à 1 crédit reçoit encore 402.

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
`category`	query	string	Requis	Slug. Absent/inconnu: `422`.
`cursor`	query	string	Facultatif	Curseur précédent.

Réponse

{
  "object": "list",
  "data": [
    {
  "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"
}
  ],
  "has_more": true,
  "next_cursor": "cur_01J…"
}

Champs de réponse

Nom	Type	Requis	Description
`object`	string	Requis	Toujours `list`.
`data`	array	Requis	Page de hooks allégés. Peut être vide.
`has_more`	boolean	Requis	True s’il existe une autre page.
`next_cursor`	string	Nullable	Renvoyer comme `cursor`. `null` si `has_more` est false.

champs data[]

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.