GET/v1/hooks/searchceil(filas / 25) créditos

Buscar hooks

Página ligera, q en el texto. q obligatorio. Página de 50.

La petición reserva 2 créditos y luego settle ceil(filas / 25). Página vacía: 0. Una cartera con 1 crédito sigue recibiendo 402.

Es un permiso de la clave, no un header. Si falta: 403 api_not_enabled.

Parámetros de la petición

Nombre	En	Tipo	Obligatorio	Descripción
`q`	query	string	Obligatorio	Texto. Vacío/ausente: `422`.
`cursor`	query	string	Opcional	Cursor de la página anterior.

Respuesta

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

Campos de respuesta

Nombre	Tipo	Obligatorio	Descripción
`object`	string	Obligatorio	Siempre `list`.
`data`	array	Obligatorio	Página de hooks ligeros. Puede estar vacía.
`has_more`	boolean	Obligatorio	True si hay otra página.
`next_cursor`	string	Nullable	Devolver como `cursor`. `null` si `has_more` es false.

campos data[]

Nombre	Tipo	Obligatorio	Descripción
`id`	string	Obligatorio	Id público, `hook_` más 32 hex.
`text`	string	Obligatorio	Texto del hook.
`platform`	string	Obligatorio	Plataforma de origen, p. ej. `tiktok`.
`media_type`	string	Nullable	Tipo de medio si se conoce.
`thumbnail_url`	string	Nullable	URL de miniatura si se conoce.
`category`	string	Nullable	Slug de categoría si se conoce.
`hook_duration_sec`	number	Nullable	Duración de apertura en segundos si se conoce.
`published_at`	string	Nullable	Fecha de publicación si se conoce.