---
title: "Turn a YouTube video into an article (HTML + Markdown + JSON-LD)"
method: POST
path: "/api/v1/youtube-to-article/generate"
---

# Turn a YouTube video into an article (HTML + Markdown + JSON-LD)

`POST /api/v1/youtube-to-article/generate`

## Request

- Base URL: `https://www.startuphub.ai`
- URL: `https://www.startuphub.ai/api/v1/youtube-to-article/generate`
- Auth: HTTP bearer

## Request body

- object
  - `url` string, uri, required
  - `transcript_only` boolean: Return transcript only, skip Gemini write
  - `options` object
    - `tone` 'neutral' | 'analytical' | 'conversational'
    - `length` 'short' | 'medium' | 'long' | 'auto'
    - `include_embed` boolean
    - `include_attribution` boolean

## Response `200`

Article payload (html, markdown, jsonld, video meta)

## Other responses

- `429`: Quota exhausted

---

[API](https://skmtc.dev/startuphub/apis/startuphub-ai-api.md) · [All operations](https://skmtc.dev/startuphub/apis/startuphub-ai-api/llms.txt) · [OpenAPI document](https://skmtc.dev/startuphub/apis/startuphub-ai-api/revisions/c9965e4ba7e2?raw)