Get Public Hooks

Public hooks feed — one merged, paginated list combining two sources:

• narrative hooks — the curated library (DB), tagged source: "narrative_hook"
• video hooks — ad hooks from the research OpenSearch index, tagged source: "video_hook"

Every page is split half-and-half between the sources (page_size 20 -> 10 narrative + 10 video, narrative block first) while both have items; when one source is exhausted the other fills the remainder. search applies to both sources; the narrative_hook_* filters scope narrative hooks, the research filters (category/sub_industries/creative_category/ keyword_value/brand_value) scope video hooks. family and is_organic scope both sides: they filter the video hooks in OpenSearch, and — since the narrative catalog is all TikTok organic — asking for paid-only or non-TikTok families drops the narrative side entirely (reported as "filtered" in sources). A failing source reports "unavailable" in sources and the other still returns.

family is the research index's own platform field ("META", "TIKTOK", "YOUTUBE", "LINKEDIN", "INSTAGRAM", "PINTEREST"), and only family + is_organic together name a platform — META with is_organic false is Meta paid, META with true is Meta organic.