YouTube URL Formats

POST /v1/youtube

#Request Example

curl -X POST /v1/youtube \
  -H "Authorization: Bearer your-token" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://www.youtube.com/watch?v=dQw4w9WgXcQ"
  }'

#Request Body

{
  "url": "https://www.youtube.com/watch?v=dQw4w9WgXcQ"
}

#Supported Input URLs

• https://www.youtube.com/watch?v=VIDEO_ID
• https://youtu.be/VIDEO_ID
• https://www.youtube.com/shorts/VIDEO_ID

#Normalization Behavior

• youtu.be/... becomes youtube.com/watch?v=...
• youtube.com/shorts/... becomes youtube.com/watch?v=...
• watch URLs keep the v query parameter as the source video ID

If no valid video ID can be extracted, the endpoint returns:

{
  "message": "Invalid YouTube URL"
}