Skip to main content
GET
https://api.submagic.co
/
v1
/
hook-title
/
templates
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"
  ]
}

​
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

​
x-api-key
string
required
Your Submagic API key starting with sk-

​
Response

​
templates
array
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

​
templates
array
Array of available hook title template names

​
Request Example

cURL
curl -X GET "https://api.submagic.co/v1/hook-title/templates" \
  -H "x-api-key: sk-your-api-key-here"
JavaScript
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);
Python
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

​
401 Unauthorized
object
{
  "error": "UNAUTHORIZED",
  "message": "Invalid or missing API key"
}
​
429 Rate Limited
object
{
  "error": "RATE_LIMIT_EXCEEDED",
  "message": "Too many requests",
  "retryAfter": 30
}
​
400 Validation Error
object
{
  "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.