Generating Bulk Video Topics
Need multiple ideas for upcoming videos? ShortGenius can generate about 50–100 unique topics in one go.
Endpoint: POST /videos/topics
curl --request POST \
--url "https://shortgenius.com/api/v1/videos/topics" \
--header "Authorization: Bearer YOUR_API_TOKEN" \
--header "Content-Type: application/json" \
--data '{
"parent_topic": "Water Conservation",
"locale": "en-US",
"number_of_topics": 50,
"content_type": "Custom"
}'
Sample Response:
[
"Why Saving Water Matters",
"Water Conservation Tips for Home",
"Rainwater Harvesting Basics",
...
]
Series (Batch or Ongoing Video Production)
If you want to create a continuous series of videos that follow a schedule, you can use the /series endpoints.
Create a Video Series
Endpoint: POST /series
curl --request POST \
--url "https://shortgenius.com/api/v1/series" \
--header "Authorization: Bearer YOUR_API_TOKEN" \
--header "Content-Type: application/json" \
--data '{
"content_type": "Custom",
"locale": "en-US",
"connection_ids": ["<CONNECTION-ID>"],
"aspect_ratio": "556",
"topics": [
{"topic": "Tip 1: Reusable Water Bottles"},
{"topic": "Tip 2: Short Showers vs Baths"}
],
"schedule": {
"timeZone": "America/Denver",
"times": [
{ "dayOfWeek": 1, "timeOfDay": 900 },
{ "dayOfWeek": 3, "timeOfDay": 1300 }
]
}
}'
Key Fields:
topics – An array of topics for each episode
schedule – The day/time you want new episodes published
timeOfDay uses 24-hour format but without a separator (e.g., 900 = 9:00, 1300 = 13:00)
Sample Response:
{
"id": "c9b59ab6-2f1e-4c98-a833-e47e368c9615",
"created_at": "2025-05-10T09:00:00Z",
"next_posting_at": "2025-05-15T15:00:00Z",
"type": "Series",
"schedule": {
"time_zone": "America/Denver",
"times": [
{
"day_of_week": 1,
"time_of_day": 900
},
{
"day_of_week": 3,
"time_of_day": 1300
}
]
},
...
}
List All Series
Endpoint: GET /series
curl --request GET \
--url "https://shortgenius.com/api/v1/series" \
--header "Authorization: Bearer YOUR_API_TOKEN"
Retrieve a Single Series
Endpoint: GET /series/{id}
Returns data about the series plus the individual episodes (videos) associated with it.
curl --request GET \
--url "https://shortgenius.com/api/v1/series/c9b59ab6-2f1e-4c98-a833-e47e368c9615" \
--header "Authorization: Bearer YOUR_API_TOKEN"
Next Steps
You can now:
Create video drafts from topics, scripts, or even news headlines.
Finalize those drafts into fully rendered videos.
Set up a video series with a publishing schedule.
