What is the ScriptHooks API?
A RESTful API that lets developers integrate ScriptHooks capabilities into custom applications, workflows, and automation pipelines. Every feature available in the web interface is accessible via API: script generation, hook generation, video grading, and more.
Getting your API key
Navigate to Settings > API. Click “Generate API Key.” Your key is displayed once — copy and store it securely. You can generate up to 5 active keys and revoke any key at any time. API keys inherit your account’s credit balance.
Use separate API keys for different applications or environments (development, staging, production). This makes it easy to track usage per app and revoke access without affecting other integrations.
Authentication and base URL
All requests use Bearer token authentication. Base URL: api.scripthooks.ai/v1. Include your API key in the Authorization header. Rate limits: 60 requests/minute on Pro, 300 requests/minute on Enterprise.
Core endpoints
POST /scripts/generate— Generate a scriptPOST /hooks/generate— Generate hooksPOST /videos/grade— Grade a videoPOST /scripts/grade— Grade a scriptGET /credits/balance— Check credit balance
Each endpoint accepts JSON payloads with the same parameters as the web interface.
Webhooks and advanced usage
Configure webhooks to receive completion notifications for async operations (video grading). Set up batch processing for bulk script generation. Use the /personas endpoint to create and manage Personas programmatically.
API calls consume credits at the same rate as the web interface. 1 script generation = 1 credit, whether triggered via API or web UI.
Frequently Asked Questions
API access is available on Pro ($29/mo) and Enterprise (custom pricing) plans. Free accounts do not have API access.
Pro plans: 60 requests per minute. Enterprise plans: 300 requests per minute. Rate limit headers are included in every response.
Yes. Use api-sandbox.scripthooks.ai for testing. Sandbox requests don’t consume credits but return realistic mock responses.
Yes. The /batch endpoint accepts up to 50 generation requests at once. Results are delivered via webhook or polling.