Skip to main content
POST
/
youtube
/
metadata
Get YouTube video metadata
curl --request POST \
  --url https://{deployment}/api/v1/youtube/metadata \
  --header 'Content-Type: application/json' \
  --header 'X-API-KEY: <api-key>' \
  --data '
{
  "video_id": "dQw4w9WgXcQ"
}
'
{
  "video_id": "dQw4w9WgXcQ",
  "success": true,
  "metadata": {
    "title": "Rick Astley - Never Gonna Give You Up",
    "author_name": "Rick Astley",
    "author_url": "https://www.youtube.com/@RickAstleyYT",
    "thumbnail_url": "https://i.ytimg.com/vi/dQw4w9WgXcQ/hqdefault.jpg",
    "channel_id": "UCuAXFkgsw1L7xaCfnd5JJOw",
    "view_count": 1600000000,
    "like_count": 17000000
  },
  "retry_info": {
    "total_attempts": 1,
    "failed_attempts": 0
  }
}

Authorizations

X-API-KEY
string
header
required

Your deployment's API key (MMK_API_KEY).

Body

application/json

Provide either video_url or video_id.

video_url
string

Full YouTube URL. Use this or video_id.

video_id
string

11-character YouTube video ID. Use this or video_url.

Response

Video metadata

video_id
string
success
boolean
error
string
metadata
object
retry_info
object

Diagnostics about transcript/metadata fetch attempts.