YouTube Generate API

#What YouTube Generate solves

Consistent, on-brand metadata is the fastest lever for CTR and session watch-time. youtube/generate produces titles, descriptions, tags/hashtags, scripts, social posts, and even a complete pack via All-in-One. Provide a topic (plus optional keywords, tone/mood/language), and you’ll get concise, platform-aware copy you can ship today.

#Endpoints & when to use them

#POST /v1/youtube/generate/all-in-one-generator — All-in-One Generator

• Best for: Drafting a full upload’s metadata in one call (title, description, tags).
• Output: title, description, tags[].
• Tip: Use for bulk production; override language to pre-localize.

#POST /v1/youtube/generate/title-generator — Generate Video Title

• Best for: Testing variants with curiosity hooks; fast A/B ideas.
• Output: title (≤150 chars; may include emojis if enabled).
• Tip: Put 1 key phrase up front; keep numbers (“Top 10”, “2025”) early.

#POST /v1/youtube/generate/description-generator — Generate Video Description

• Best for: SEO + viewer guidance; optional hashtags block.
• Output: description (≤1000 chars target, no markdown).
• Tip: Choose hashtags_mode=end to append a neat tag block.

#POST /v1/youtube/generate/tag-generator — Generate Video Tags

• Best for: Compact, mixed short/long-tail tag sets.
• Output: tags[] (parsed from CSV under the hood; capped by YouTube limits).
• Tip: Keep to 10–15 high-signal tags max; the rest is noise.

#POST /v1/youtube/generate/hashtag-generator — Generate Hashtags

• Best for: Shorts & community posts; appends discoverable tags.
• Output: hashtags[] (prefixed with #).
• Tip: hashtags_mode=seo_block → returns a tidy block to paste at the end.

#POST /v1/youtube/generate/script-generator — Video Script Generator

• Best for: Outlines/voiceover drafts in 1st/3rd person.
• Output: script (plain text, no markdown).
• Tip: Set person=1st for vlog voice; 3rd for narrations.

#POST /v1/youtube/generate/comment-generator — Generate Comment

• Best for: Pin comments, replies, or cross-promo notes.
• Output: comment (<=1000 chars; emoji rules apply).
• Tip: emojis_mode=random_inject for upbeat, human feel.

#POST /v1/youtube/generate/social-post-generator — Social-Post Generator

• Best for: Announcements per network (YouTube, Twitter/X, Facebook).
• Output: post (length tuned per network; Twitter capped to 280).
• Tip: Use hashtags_mode=seo_block on Facebook; lighter on Twitter.

#POST /v1/youtube/generate/channel-description-generator — Channel Description

• Best for: New channels or rebrands; crisp USP + posting cadence.
• Output: channelDescription (≤500 chars).
• Tip: Pass tone=friendly for broader audiences; authoritative for expert niches.

#POST /v1/youtube/generate/channel-name-ideas — Channel Name Ideas

• Best for: Brainstorming brandable names around your niche.
• Output: suggestions[] (10 concise name ideas).
• Tip: Re-run with 1 extra keyword to nudge the style (e.g., “mix”, “daily”, “live”).

#Quick start

# All-in-One (EN)
curl -X POST "https://api.yeb.to/v1/youtube/generate/all-in-one-generator" \
  -H "Accept: application/json" -H "Content-Type: application/json" \
  -H "X-API-Key: <YOUR_API_KEY>" \
  -d '{ "topic":"Budget travel tips 2025", "keywords":["cheap flights","hostels"] }'

# Title variant (TR), with emojis
curl -X POST "https://api.yeb.to/v1/youtube/generate/title-generator" \
  -H "Accept: application/json" -H "Content-Type: application/json" \
  -H "X-API-Key: <YOUR_API_KEY>" \
  -d '{ "topic":"En iyi ucuz uçuş tüyoları 2025", "language":"TR", "emojis_mode":"random_inject" }'

# Social post (Twitter), hashtags at end
curl -X POST "https://api.yeb.to/v1/youtube/generate/social-post-generator" \
  -H "Accept: application/json" -H "Content-Type: application/json" \
  -H "X-API-Key: <YOUR_API_KEY>" \
  -d '{ "topic":"Budget travel tips 2025", "network":"TWITTER", "hashtags_mode":"end" }'

#Parameters that actually matter

#Reading & acting on responses

#All-in-One — interpretation

{
  "title": "Top 10 Budget Travel Hacks for 2025 ✈️",
  "description": "Ready to explore the world…",
  "tags": ["budget travel","cheap flights","travel hacks"]
}

• Ship title as-is; skim description for claims/promise; paste tags into YouTube Studio.

#Title/Description — interpretation

• Titles keep the primary keyword early; consider a number or year to punch CTR.
• Descriptions avoid markdown and respect hashtag mode; add your own links block afterward.

#Tags/Hashtags — interpretation

• Use 8–12 tags; mix specific (artist/topic) with generic (genre/year).
• For Shorts, put 3–5 hashtags at the end of the description or community post.

#Practical recipes

• Localization at scale: Call All-in-One per locale (EN, ES, DE). Keep topic identical; let language drive copy.
• Channel-aware drafts: Pass channel to align tone with an existing brand; pass video to mirror a sequel/spinoff.
• Variant testing: Generate 3 titles, publish strongest; recycle the other two as A/B for future uploads or Shorts cuts.
• Social splash: Generate a Twitter post and a Facebook variant; on FB use hashtags_mode=seo_block.

#Errors & safeguards

• 400 "Missing "action" parameter" — route must include the action segment.
• 400 "Missing "topic"" — all generators require topic.
• Emoji/hashtag modes are optional; none is the safe default.
• Keywords sanitized and limited to 3; excessive punctuation stripped.

#API Changelog (youtube/generate)

Use the Playgrounds attached to each endpoint on this page to generate live assets and refine your defaults (language, tone, emoji/hashtag modes).