long form
packaging
The long-form hooks and packages you kept
The videos you kept, newest decision first: one entry a video on each tab (its newest find), or the kept finds of one run when run_id is given; full find objects, a page at a time. count is the number on this page. Free. MCP: list_kept_finds.
get/v1/finds/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/finds/keeps
- Auth: none declared
Query parameters
kindstring nullable
only long or only packaging; leave out for both
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
Example response
{
"count": 1,
"kept": [
{
"about_subject": "yes",
"age_days": 584,
"analysed": true,
"audience": "people curious about cold plunges",
"auto_captions": false,
"baseline_videos": 28,
"beats": [
{
"beat": "hook",
"does": "admits he nearly quit",
"from": 1,
"to": 1
},
{
"beat": "promise",
"does": "holds back the result",
"from": 2,
"to": 2
}
],
"channel": "Someone",
"channel_handle": "someone",
"channel_id": "UC0000000000000000000001",
"channel_median_views": 85000,
"duration_s": 1104,
"find_id": "7c8d9e0f-1a2b-4c3d-8e4f-5a6b7c8d9e0f",
"hook": "I got into freezing water every single morning for a month, and by day nine I wanted to quit.",
"hook_end_s": 7.4,
"hook_lines": 1,
"hook_seconds": 7.4,
"hook_start_s": 0.2,
"hook_type": "story_open",
"hook_words": 18,
"intro": [
{
"n": 1,
"t": 0.2,
"text": "I got into freezing water every single morning for a month, and by day nine I wanted to quit."
},
{
"n": 2,
"t": 7.4,
"text": "But what happened to my sleep by the end is the reason I am still doing it."
}
],
"intro_seconds": 60,
"intro_text": "I got into freezing water every single morning for a month, and by day nine I wanted to quit. But what happened to my sleep by the end is the reason I am still doing it.",
"kind": "long",
"language": "English",
"mechanism": "\"By day nine I wanted to quit\" admits the cost before any benefit, so the viewer trusts what follows and waits to hear why he stayed.",
"open_loop": "What happened to his sleep?",
"outlier": 28.2,
"platform": "youtube",
"player_url": "https://www.youtube.com/embed/dQw4w9WgXcQ",
"posted_at": "2025-03-02T15:00:00Z",
"posted_exact": false,
"promise": "You will see what a month of cold plunges really changes.",
"rank": 1,
"run_id": "8f1c2d3e-4b5a-4c6d-8e7f-9a0b1c2d3e4f",
"score": 2.4,
"steal_it": "Open on the moment you nearly gave up, then hold the result back.",
"template": "I did {hard thing} every day for {time}, and by {early point} I wanted to quit.",
"thumbnail_url": "https://i.ytimg.com/vi/dQw4w9WgXcQ/hq720.jpg",
"title": "I Cold Plunged Every Day For 30 Days",
"title_link": "The first line repeats the title's thirty days and adds the low point.",
"video_id": "dQw4w9WgXcQ",
"views": 2400000,
"views_per_day": 4109.6,
"watch_url": "https://www.youtube.com/watch?v=dQw4w9WgXcQ",
"why": "28x this channel's usual 85K views"
}
]
}Changes
No recorded changes to this operation across all 1 revision of this API.