---
title: "Curated hook template library"
method: GET
path: "/v1/hooks/library"
tags: ["Hooks"]
---

# Curated hook template library

`GET /v1/hooks/library`

## Request

- Base URL: `https://api.virlo.ai`
- URL: `https://api.virlo.ai/v1/hooks/library`
- Auth: HTTP bearer

4,000+ hand-curated, reusable hook templates across 30+ categories, each with a filled-in example, the psychology behind why it works, and psychology tags (curiosity, fomo, social_proof, …). Complements the corpus endpoints: /trending and /search show what IS working in the wild; the library is fill-in-the-blank material for writing your own. Filter by category slug, psychology_tag, or free text. $0.10 per call.

## Query parameters

- `limit` number
- `page` number
- `category` string
- `psychology_tag` string
- `q` string

## Response `200`

- HookLibraryResponseDto
  - `data` LibraryHookDto[], required
    - `hook_text` string, required: The hook template text.
    - `example` string, nullable: A filled-in example of the template.
    - `psychology` string, nullable: Why this hook works — the psychology behind it.
    - `psychology_tags` string[], nullable
    - `tags` string[], nullable
    - `library_category` LibraryCategoryRefDto, required
      - `slug` string, nullable
      - `name` string, nullable
  - `pagination` PaginationMetaDto, required
    - `page` number, required
    - `limit` number, required
    - `total` number, required
    - `total_pages` number, required
    - `has_next_page` boolean, required
    - `has_prev_page` boolean, required

## Other responses

- `401`: Missing or invalid API key (`missing_api_key` / `invalid_api_key`)
- `429`: Rate limit exceeded (`rate_limit_exceeded`); see the Retry-After header

---

[API](https://skmtc.dev/virlo/apis/virlo-public-api.md) · [All operations](https://skmtc.dev/virlo/apis/virlo-public-api/llms.txt) · [OpenAPI document](https://skmtc.dev/virlo/apis/virlo-public-api/revisions/3b69c6145087?raw)