hooks

Make it mine: lines written from this hook's structure for your niche

Write up to n new opening lines (1 to 5, default 3) for your niche that keep this real hook's structure: the device that made it travel, with the subject swapped for yours. Body: {"niche": "teeth whitening", "n": 2}. Every answer carries the label "Written by Hook Detector from a real hook's structure", and each line names the structure it kept: these are written lines, never found hooks; they are never mixed into a deck, a keep or an export. Costs 1 credit per call (a cheap model), taken before the model is asked and refunded if it does not answer (503). 404 for a hook that is not yours. Limited per account per hour (429). Needs research. The answer carries remix_id; GET /v1/hooks/{hook_id}/remixes and GET /v1/remixes/{remix_id} read it back, free. MCP: remix_hook.

post/v1/hooks/{hook_id}/remix

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/hooks/{hook_id}/remix
Auth: none declared

Path parameters

hook_idstring uuid required

Headers

Idempotency-Keystring nullable

retry safely: the same key and body within 24 hours answer the saved remix (Idempotent-Replayed: true) and charge nothing; the same key with another body is 422 idempotency_key_reused

authorizationstring nullable

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

Request body

nichestring

your niche, product or audience, as you would say it (1 to 120 characters)

ninteger

how many lines to write, 1 to 5 (default 3)

mode'openings' | 'null' nullable

leave out (or "openings"). Write my intro works from a long-form find (POST /v1/finds/{find_id}/remix), so "intro" is refused here with 422

Example request

{
  "niche": "teeth whitening",
  "n": 3
}

Response

Successful Response

hook_idstring required

nichestring required

ninteger required

labelstring required

always "Written by Hook Detector from a real hook's structure": these are written lines, never found hooks; show the label with them

credits_chargedinteger required

always 1

creditsinteger required

your balance after this call

remix_idstring nullable

this remix's id: GET /v1/remixes/{remix_id} reads it back, free

created_atstring nullable

Example response

{
  "credits": 436,
  "credits_charged": 1,
  "hook_id": "1a2b3c4d-5e6f-4a7b-8c9d-0e1f2a3b4c5d",
  "label": "Written by Hook Detector from a real hook's structure",
  "n": 2,
  "niche": "teeth whitening",
  "written": [
    {
      "kept_structure": "the secret opener",
      "line": "Nobody tells you this about teeth whitening."
    },
    {
      "kept_structure": "the order to stop",
      "line": "Stop whitening your teeth for 10 minutes."
    }
  ]
}

Changes

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