research

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.

post/api/v1/research/get-public-hooks

Request

  • Base URL
    https://api.brandbooster.ai (the document declares no server; this is the origin it was published from)
  • URL
    https://api.brandbooster.ai/api/v1/research/get-public-hooks
  • Auth
    none declared. Required headers: x-api-key

Headers

x-api-keystring required

Request body

searchstring nullable
pageinteger
page_sizeinteger
include_video_hooksboolean
include_narrative_hooksboolean
categorystring[] nullable
sub_industriesstring[] nullable
creative_categorystring[] nullable
keyword_valuestring[] nullable
brand_valuestring[] nullable
familystring[] nullable
is_organicboolean nullable
narrative_hook_categorystring[] nullable
narrative_hook_industrystring[] nullable

Response

Successful Response

unknown required

Changes

No operation changes recorded.