Get Hook Title Templates
Retrieve a list of all hookt title available templates that can be applied to your projects. Hook titles render an animated caption for the first seconds of your video to grab attention before the main captions begin.
This endpoint requires authentication and has a rate limit of 1000 requests
per hour.
Authentication
Your Submagic API key starting with sk-
Response
Array of available hook title template names
curl -X GET "https://api.submagic.co/v1/hook-title/templates" \
-H "x-api-key: sk-your-api-key-here"
{
"templates": [
"tiktok",
"laura",
"steph",
"kevin",
"kelly",
"mark",
"logan",
"enrico",
"mike",
"devin",
"hormozi",
"masi",
"ali"
]
}
Using Hook Title Templates
When creating a project or updating a project, specify the template name in your request:
"hookTitle": {
"text": "Stop scrolling—watch this in 30 seconds",
"template": "tiktok",
"top": 45,
"size": 32
}
Response
Array of available hook title template names
Request Example
curl -X GET "https://api.submagic.co/v1/hook-title/templates" \
-H "x-api-key: sk-your-api-key-here"
const response = await fetch(
"https://api.submagic.co/v1/hook-title/templates",
{
headers: { "x-api-key": "sk-your-api-key-here" },
}
);
const { templates } = await response.json();
console.log("Hook title templates:", templates);
import requests
headers = {'x-api-key': 'sk-your-api-key-here'}
response = requests.get(
'https://api.submagic.co/v1/hook-title/templates',
headers=headers
)
templates = response.json()['templates']
print("Hook title templates:", templates)
Example Response
{
"templates": [
"tiktok",
"laura",
"steph",
"kevin",
"kelly",
"mark",
"logan",
"enrico",
"mike",
"devin",
"hormozi",
"masi",
"ali"
]
}
Error Handling
{
"error": "UNAUTHORIZED",
"message": "Invalid or missing API key"
}
{
"error": "RATE_LIMIT_EXCEEDED",
"message": "Too many requests",
"retryAfter": 30
}
{
"error": "VALIDATION_ERROR",
"message": "Invalid template name"
}
If you don’t specify a hookTitle when creating a project, the system will
automatically apply the “tiktok” template.
Template names are case-sensitive. Make sure to use the exact template name as
returned by this endpoint.
