YouTube Video Scraper API

POST /v1/youtube

Use this endpoint to turn a YouTube video URL into structured metadata you can store, analyze, or show inside your product.

#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"
}

#Pricing

• 3 credits

Credits are only deducted for successful requests.

#Supported Input URLs

• standard watch URLs
• youtu.be short links
• YouTube Shorts URLs

#Example Response

{
  "response": {
    "title": "Video title",
    "description": "Video description",
    "view_count": "123,456 views",
    "like_count": "12K",
    "publish_date": "Jan 1, 2026",
    "relative_date": "2 weeks ago",
    "hashtags": ["#laravel", "#api"],
    "chapters": [
      {
        "title": "Intro",
        "url": "https://www.youtube.com/watch?v=dQw4w9WgXcQ&t=0"
      }
    ],
    "thumbnail_url": "https://i.ytimg.com/vi/dQw4w9WgXcQ/maxresdefault.jpg",
    "author": "Channel Name",
    "channel_id": "UC123",
    "subscriber_count": "10K subscribers"
  }
}

#Response Includes

• title and description
• views and likes
• publish and relative dates
• hashtags and chapters
• channel metadata

#Error Cases

• invalid YouTube URL format -> 422
• fetch or parse failure -> 400
• insufficient credits -> 403