Hooks

Hook taxonomy with effectiveness stats

The two hook vocabularies with per-value corpus stats: hook_type (spoken/text opening-line types; Virlo adds new ones over time) and visual_hook_type (12 first-frame visual types). They are orthogonal: every analyzed video has one of each. Stats come from the latest daily snapshot of the ~970k-video hook corpus: count and share, views, and Virality Score (ln(views/followers) x ln(followers), comparable across creator sizes and platforms). To answer "which hook types work best", use sort=strong_hit_rate: the share of videos using that type that scored strong or better (>= 18). avg_weighted_score reads negative for most types and is not a ranking signal. Also the place to discover the values the hook_type and visual_hook_type filters accept. Free.

get/v1/hooks/types

Request

  • Base URL: https://api.virlo.ai
  • URL: https://api.virlo.ai/v1/hooks/types
  • Auth: HTTP bearer

Query parameters

dimension'hook_type' | 'visual_hook_type'

Which taxonomy to return: hook_type (the spoken/text opening-line vocabulary) or visual_hook_type (what fills frame 1, 12 values). The two are orthogonal — a video has one of each.

platform'tiktok' | 'youtube' | 'instagram'

Restrict stats to one platform. Omit for all platforms combined.

category'art_design' | 'automotive' | 'beauty' | 'business_career' | 'crafts_diy' | 'education' | 'entertainment' | 'fashion' | 'finance' | 'fitness' | 'food_beverage' | 'gaming' | 'health_wellness' | 'home_garden' | 'kids_content' | 'lifestyle' | 'music' | 'news_politics' | 'parenting_family' | 'pets' | 'real_estate' | 'relationships_dating' | 'religion_spirituality' | 'science_nature' | 'sports' | 'tech' | 'travel' | 'other'

Restrict stats to one content category. Omit for all categories combined.

sort'video_count' | 'strong_hit_rate' | 'median_weighted_score' | 'p90_weighted_score'

Order of the types array. video_count (default) answers "which hooks are most common"; strong_hit_rate answers "which hooks work best" (share of videos scoring strong or better). Rank effectiveness by strong_hit_rate or median_weighted_score, never by avg_weighted_score.

Response

Example response

{
  "data": {
    "types": [
      {
        "value": "tutorial_promise",
        "strong_hit_rate": 0.27
      }
    ]
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.