Skip to main content
POST
/
v1
/
youtube-suggestions
/
generate
Generate YouTube video suggestions using AI
curl --request POST \
  --url https://api.yalg.ai/v1/youtube-suggestions/generate \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "topic": "Founder-led content systems"
}
'
[
  {
    "id": "123e4567-e89b-12d3-a456-426614174000",
    "title": "10 Tips to Master TypeScript in 2024",
    "description": "In this video, we explore...",
    "hook": "Are you still writing JavaScript like it's 2015?",
    "tags": [
      "typescript",
      "programming"
    ],
    "score": 85,
    "status": "pending"
  }
]

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
topic
string
required

Topic or niche to generate suggestions for

Example:

"web development"

count
number

Number of suggestions to generate

Required range: 1 <= x <= 10
Example:

5

targetAudience
string

Target audience for the suggestions

Example:

"beginners"

category
enum<string>

Preferred video category

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

Language for suggestions

Example:

"fr"

Response

Suggestions generated successfully