Skip to content
Hookzen API

Hookzen,
from your code.

The same tools as on the site, over REST: search viral videos, analyze their structure, write a script, prepare an edit.

API base URL: https://hookzen.app/api/v1

Routes

Costs in credits

Format catalog, search, variants, video analysis
Free
Script
2 credits
Edit plan
15 credits per video (up to 10 min of footage, then 5 credits per additional 5 min)

Credits are refunded if the AI fails. With the Idempotency-Key header, a request resent after a dropped connection is never charged twice.

Example: write a script

curl -X POST https://hookzen.app/api/v1/scripts \
  -H "Authorization: Bearer $HOOKZEN_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "content-type: application/json" \
  -d '{"product": "Insulated water bottle", "referenceVideoId": "vid_010"}'

The response contains the script, the credits charged, the new balance and SRT subtitles.

Errors

All errors have the shape { "error": "message" }. Every response carries an X-Request-Id header: quote it to support if something goes wrong.

Getting started

  1. 01

    Get a key

    API keys will be available in your account when accounts open. Sign up to be notified.

  2. 02

    Import the specification

    Postman, Insomnia, a custom GPT action or a client generator: everything starts from /api/v1/openapi.json.

  3. 03

    Call the API

    Authenticate with the Authorization: Bearer header. Every response carries an X-Request-Id to quote to support.