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 data = await response.json();
console.log(data.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
)
data = response.json()

print("Available templates:", data['templates'])

{
  "templates": [
    "tiktok",
    "laura",
    "steph",
    "kevin",
    "kelly",
    "mark",
    "logan",
    "enrico",
    "mike",
    "devin",
    "hormozi",
    "masi",
    "ali"
  ]
}

GET

hook-title

templates

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 data = await response.json();
console.log(data.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
)
data = response.json()

print("Available templates:", data['templates'])

{
  "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

string

required

Your Submagic API key starting with sk-

Response

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"

const response = await fetch(
  "https://api.submagic.co/v1/hook-title/templates",
  {
    headers: { "x-api-key": "sk-your-api-key-here" },
  }
);

const data = await response.json();
console.log(data.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
)
data = response.json()

print("Available templates:", data['templates'])

{
  "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

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

object

{
  "error": "UNAUTHORIZED",
  "message": "Invalid or missing API key"
}

object

{
  "error": "RATE_LIMIT_EXCEEDED",
  "message": "Too many requests",
  "retryAfter": 30
}

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.

Get Started

Guides

API Reference

Get Hook Title Templates

Get Hook Title Templates

Authentication

Response

Using Hook Title Templates

Response

Request Example

Example Response

Error Handling

​Get Hook Title Templates

​Authentication

​Response

​Using Hook Title Templates

​Response

​Request Example

​Example Response

​Error Handling

Get Hook Title Templates

Authentication

Response

Using Hook Title Templates

Response

Request Example

Example Response

Error Handling