hooks

The hooks you kept

The hooks you kept, newest decision first, across all runs or within one run_id, as full hook objects, a page at a time (100 per page by default, and at most). count is the number on this page. Free. MCP: list_keeps.

get/v1/keeps

Request

Base URL: https://api.hookdetector.com (the document declares no server; this is the origin it was published from)
URL: https://api.hookdetector.com/v1/keeps
Auth: none declared

Query parameters

run_idstring uuid nullable

limitinteger

page size, 1 to 100

cursorstring nullable

next_cursor from the previous page; leave out for the first

Headers

authorizationstring nullable

Bearer hd_... from POST /v1/accounts or POST /v1/keys

Response

Successful Response

countinteger required

how many are on this page

next_cursorstring nullable required

Example response

{
  "count": 1,
  "kept": [
    {
      "above_floor": true,
      "age_days": 3.5,
      "aspect": "9:16",
      "audience": "people who already cold plunge",
      "banner": "STOP DOING 10 MINUTES",
      "caption": "cold plunge tips",
      "catchy_line": "Two minutes is the whole trick.",
      "creator": "someone",
      "creator_country": "US",
      "creator_median_views": 38000,
      "duration_s": 41,
      "format": "talking_head",
      "found_by": "search",
      "hashtags": [
        "coldplunge",
        "recovery"
      ],
      "hook": "Nobody tells you this about cold plunges.",
      "hook_id": "1a2b3c4d-5e6f-4a7b-8c9d-0e1f2a3b4c5d",
      "hook_type": "contrarian_claim",
      "language": "English",
      "likes": 90000,
      "main_idea": "Short exposure beats long.",
      "mechanism": "\"Nobody tells you this\" promises a secret about a routine the viewer already does. The clip pays it off with the two-minute rule.",
      "onscreen_text": "STOP DOING 10 MINUTES",
      "outlier": 31.2,
      "outlier_basis": "median_views",
      "own_sound": true,
      "paid": false,
      "platform": "tiktok",
      "player_url": "https://www.tiktok.com/player/v1/7412345678901234567?autoplay=1",
      "posted_at": "2026-09-28T10:00:00+00:00",
      "rank": 1,
      "section": "main",
      "sound_reuse": 1200,
      "steal_it": "Name a routine your viewers already do and promise the thing nobody says about it.",
      "template": "Nobody tells you this about {routine}.",
      "topic": "cold plunge timing",
      "transcript": "Nobody tells you this...",
      "transcript_kind": "speech",
      "video_id": "7412345678901234567",
      "views": 1200000,
      "views_per_day": 342857.1,
      "virality": 0.91,
      "virality_why": "31x this creator's usual",
      "visual_hook": "The banner \"STOP DOING 10 MINUTES\" adds an order that contradicts the usual advice.",
      "watch_url": "https://www.tiktok.com/@someone/video/7412345678901234567",
      "why_it_travelled": "\"Nobody tells you this\" promises a secret about a routine the viewer already does. The clip pays it off with the two-minute rule."
    }
  ]
}

Changes

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