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
GET/accountAccount balance, plan, quota and latest operationsGET/formatsCatalog of viral formats, from most to least viewed (free)POST/searchSuper Search: search viral videosPOST/variantsVariants of a video (same format, other topics)GET/videos/{id}/analysisVideo analysis: hook, structure, pacing, reasons for successPOST/scriptsScript Studio: write a script (2 credits)POST/montageAuto Montage: edit plan from the footage transcript (15 credits per video)
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.
400Invalid parameters (per-field details are in issues)Fix the request: the field at fault and the problem are listed in issues.401Missing or invalid API keyCheck the Authorization: Bearer <key> header and the key in your account.402Not enough creditsTop up your credits, then resend the request.404Video not found in the libraryCheck the video id (vid_…) or its link.409A request with the same Idempotency-Key is still in progressWait a few seconds, then resend the same request with the same key.413Request body too largeReduce the size of the request body.415Request body not declared as JSON (Content-Type: application/json)Add the Content-Type: application/json header.422Idempotency-Key already used for a different requestUse a new Idempotency-Key for a different request.429Too many calls or Super Search quota reached (see Retry-After)Wait for the delay given by Retry-After. Without that header, the monthly quota is used up: no point retrying.502The AI model didn't complete (credits refunded)Resend the request: the credits have been refunded.
Getting started
- 01
Get a key
API keys will be available in your account when accounts open. Sign up to be notified.
- 02
Import the specification
Postman, Insomnia, a custom GPT action or a client generator: everything starts from /api/v1/openapi.json.
- 03
Call the API
Authenticate with the Authorization: Bearer header. Every response carries an X-Request-Id to quote to support.