Hooklayer API

curl -X POST https://hooklayer.dev/api/v1/account/analyze \
  -H "Authorization: Bearer hl_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "handle": "@mrbeast",
    "platform": "tiktok"
  }'

{
  "success": true,
  "profile": {
    "handle": "@mrbeast",
    "platform": "tiktok",
    "follower_count": 50000000,
    "avg_views": 25000000,
    "niche": "challenge_videos",
    "region": "US"
  },
  "viral_dna": {
    "viral_dna_score": 87,
    "viral_dna_explanation": "Elite consistency + signature stakes-revelation hook formula.",
    "replicability_score": 34,
    "replicability_explanation": "Personality-dependent — face + production budget drive the format.",
    "originality_score": 78,
    "originality_explanation": "Originates the 'shocking premise + verified payout' template.",
    "consistency_score": 92,
    "hook_reuse_rate": 0.34,
    "audience_fatigue": "stable"
  },
  "format_fingerprint": {
    "avg_duration_sec": 47,
    "words_per_second": 3.1,
    "pacing": "Loud open, stakes reveal at 1.5s, pay-off at 30s"
  },
  "recent_videos": [/* 5 with url, views, transcript, hashtags */],
  "performance_summary": {
    "best_performing_hooks": [/* top 2 by engagement */],
    "worst_performing_hooks": [/* bottom 2 by engagement */]
  },
  "steal_map": [
    {
      "what": "Stakes-revelation hook formula",
      "how": "Open with shock claim → reveal stakes in second 1.5 → name the prize",
      "applicability": ["finance", "fitness", "tech_tutorials"],
      "example_remix": "You're losing $4K/yr → here's the 30-second fix that pays for your year of groceries"
    }
  ],
  "content_gaps": ["Never posts long-form (>60s) — saturated market opportunity"],
  "recommended_actions": [
    {
      "action": "Copy the stakes-revelation hook to your niche",
      "expected_lift": "+34% over a generic hook",
      "next_tool": "viral_remix"
    }
  ],
  "recommended_chain": [
    {
      "tool": "match_voice",
      "params": {
        "draft": "your script text here",
        "reference_samples": [
          "https://tiktok.com/@mrbeast/video/750...",
          "https://tiktok.com/@mrbeast/video/748...",
          "https://tiktok.com/@mrbeast/video/745..."
        ]
      },
      "reason": "High-signal voice DNA — consistent across top 5"
    },
    {
      "tool": "trend_pulse",
      "params": { "niche": "challenge_videos" },
      "reason": "Verify their formula maps to current trends"
    },
    {
      "tool": "viral_remix",
      "params": { "source_url": "https://tiktok.com/@mrbeast/video/..." },
      "reason": "Their #2 video has the highest copyable structure"
    }
  ],
  "data_freshness_days": 2,
  "credits_remaining": {"subscription": 4995, "payg": 0, "total": 4995}
}

curl -X POST https://hooklayer.dev/api/v1/hook/score \
  -H "Authorization: Bearer hl_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "text": "3 things I wish I knew about scaling B2B SaaS",
    "platform": "tiktok",
    "niche": "Finance & Business"
  }'

{
  "success": true,
  "score": 42,
  "percentile": 38,
  "weak_seconds": [],
  "pattern_match": "Generic",
  "rewrites": [
    "I lost $14k in 3 months trying this. Here's the receipt.",
    "Nobody told me this until I was 28 and broke.",
    "If you're a 30-something founder, this hook works."
  ],
  "why": "Generic listicle opener — no specific stake or proof.",
  "breakdown": {
    "hook_strength": 7,
    "script_structure": 10,
    "retention_pattern": 8,
    "cta_effectiveness": 12,
    "shareability": 8
  },
  "strengths": ["Clear topic"],
  "weaknesses": ["No specific stake", "No proof"],
  "credits_remaining": {"subscription": 4999, "payg": 0, "total": 4999},
  "from_subscription": 1,
  "from_payg": 0
}

curl -X POST https://hooklayer.dev/api/v1/remix \
  -H "Authorization: Bearer hl_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "source_url": "https://www.tiktok.com/@user/video/1234567890",
    "my_topic": "B2B SaaS pricing tiers"
  }'

{
  "success": true,
  "extracted_formula": {
    "hook_type": "Result First",
    "structure": "Result reveal → backstory → method → CTA",
    "pacing": "PEAK-MEDIUM-RISING-WARM",
    "emotional_triggers": ["surprise", "social proof", "curiosity"],
    "why_it_works": "..."
  },
  "fresh_script": {
    "hook": "...",
    "scenes": [
      {
        "section": "HOOK",
        "voiceover": "...",
        "camera": "front camera selfie mode",
        "action": "creator holds phone, shocked expression",
        "text_overlay": "47% conversion. Here's how."
      }
    ],
    "cta": "..."
  },
  "camera_shots": ["..."],
  "overlays": ["..."],
  "hook_score": 88,
  "credits_remaining": {"subscription": 4996, "payg": 0, "total": 4996}
}

curl "https://hooklayer.dev/api/v1/trends?niche=Beauty%20%26%20Skincare" \
  -H "Authorization: Bearer hl_live_..."

{
  "success": true,
  "niche": "Beauty & Skincare",
  "rising": [
    {
      "title": "Mini-doc skincare evolution",
      "type": "format",
      "description": "...",
      "growth": "+180% this week",
      "competition": "low",
      "suggestion": "..."
    }
  ],
  "saturated": [
    {
      "title": "Get ready with me",
      "type": "format",
      "description": "...",
      "status": "saturated"
    }
  ],
  "generated_at": "2026-05-04T12:34:56.789Z",
  "credits_remaining": {"subscription": 4995, "payg": 0, "total": 4995}
}

curl "https://hooklayer.dev/v1/templates?niche=Finance%20%26%20Business&min_views=100000" \
  -H "Authorization: Bearer hl_live_..."

{
  "success": true,
  "niche": "Finance & Business",
  "templates": [
    {
      "title": "Stakes-revelation hook + 3-step proof",
      "hook_pattern": "I lost $X in Y months. Here's the receipt.",
      "format": "Talking head + receipts B-roll + CTA",
      "avg_views": 248000,
      "examples": [
        "https://www.tiktok.com/@user/video/...",
        "https://www.tiktok.com/@user/video/..."
      ]
    }
  ],
  "generated_at": "2026-05-11T12:34:56.789Z",
  "credits_remaining": {"subscription": 4994, "payg": 0, "total": 4994}
}

curl -X POST https://hooklayer.dev/v1/voice/match \
  -H "Authorization: Bearer hl_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "draft": "Today I want to talk about cold outreach for B2B SaaS",
    "reference_samples": [
      "https://www.tiktok.com/@alexhormozi/video/...",
      "https://www.tiktok.com/@alexhormozi/video/...",
      "https://www.tiktok.com/@alexhormozi/video/..."
    ]
  }'

{
  "success": true,
  "voice_profile": {
    "energyLevel": 7,
    "humorStyle": "none",
    "personality": "direct, authoritative",
    "vocabularyLevel": "plain-spoken",
    "sentenceLength": "short, punchy",
    "signatureMoves": ["names a number", "rejects soft framing", "ends with a directive"],
    "favoriteWords": ["receipts", "actually", "literally"],
    "avoidedWords": ["maybe", "perhaps", "kinda"],
    "audienceRelationship": "older brother giving advice"
  },
  "prompt_instructions": "<reusable system-prompt-ready voice spec>",
  "rewritten_draft": "Cold outreach is dead — but only the way you're doing it. Here's the 3-step receipt...",
  "credits_remaining": {"subscription": 4992, "payg": 0, "total": 4992}
}

curl -X POST https://hooklayer.dev/v1/predict \
  -H "Authorization: Bearer hl_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "script": "I tried 3 cold email tools so you don'\''t have to. The winner saved my Q3 pipeline. Here'\''s the breakdown...",
    "niche": "Finance & Business"
  }'

{
  "success": true,
  "virality_score": 78,
  "viral_dna": {
    "hook_type": "Stakes + Verdict",
    "structure": "Promise → Verdict → Proof → CTA",
    "pacing": "PEAK-MEDIUM-RISING-WARM",
    "emotional_triggers": ["curiosity", "FOMO", "social proof"]
  },
  "retention_diagnosis": {
    "first_3_seconds": "strong — stakes named with a number",
    "weak_seconds": [12, 22],
    "drop_off_risk": "moderate — payoff at 0:14 might land too late"
  },
  "target_emotion": "validated curiosity",
  "share_trigger": "Saves the viewer time on a B2B decision",
  "recommended_changes": [
    "Move the verdict to 0:08 instead of 0:14",
    "Add a callback to the hook at the end"
  ],
  "credits_remaining": {"subscription": 4990, "payg": 0, "total": 4990}
}