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

countinteger required

how many are on this page

next_cursorstring nullable required

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.