Skip to main content
POST
/
v1
/
youtube-suggestions
Create a new YouTube video suggestion
curl --request POST \
  --url https://api.yalg.ai/v1/youtube-suggestions \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "title": "How to turn stories into content"
}
'
"<string>"

Authorizations

​
x-api-key
string
header
default:yalg_live_your_api_key
required

YALG Developer API key. Send it in the x-api-key header from a server-side environment only.

Body

application/json
​
title
string
required

Video title

Maximum string length: 200
Example:

"10 Tips to Master TypeScript in 2024"

​
description
string
required

Video description

Example:

"In this video, we explore the best practices for TypeScript development..."

​
hook
string

Video hook/intro

Example:

"Are you still writing JavaScript like it's 2015? Here's what you're missing..."

​
tags
string[]

Video tags

Example:
["typescript", "programming", "tutorial"]
​
keywords
string[]

SEO keywords

Example:
[
  "typescript tutorial",
  "learn typescript",
  "typescript 2024"
]
​
category
enum<string>

Video category

Available options:
tutorial,
review,
vlog,
educational,
entertainment,
news,
how_to,
interview,
documentary,
other
Example:

"tutorial"

​
estimatedDuration
string

Estimated video duration

Example:

"15-20 minutes"

​
targetAudience
string

Target audience description

Example:

"Intermediate JavaScript developers looking to level up"

Response

Suggestion created successfully

The response is of type file.