Introduction

Public HTTP API for a scored hook catalog, short-form video scoring, and a credit wallet. Base URL https://api.hookest.com.

OpenAPI JSON Postman llms.txt Authentication

Quick start. Use the invited hk_live_… key. Send Authorization: Bearer hk_live_…. Query-string keys are rejected. Then read the wallet, search hooks, or score a clip. Or import the Postman collection.

What you can call

Wallet

Monthly and top-up balances.

Hooks

Search, list, and fetch a scored hook.

Predict

Get a link, send the MP4, then poll.

Webhooks

Account URL and secret for job results.

Response codes

200 Success

400 invalid_cursor

401 invalid_api_key

402 insufficient_credits

403 api_not_enabled / account_suspended

404 not_found

422 validation_error

429 rate_limit_exceeded