Skip to main content
POST
/
v1
/
video
/
details
Extract structured metadata from a YouTube video
curl --request POST \
  --url https://api.stophy.dev/v1/video/details \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "videoUrl": "https://www.youtube.com/watch?v=dQw4w9WgXcQ"
}
'
{
  "video": {
    "videoId": "<string>",
    "title": "<string>",
    "description": "<string>",
    "duration": 123,
    "uploadDate": "<string>",
    "isLiveContent": false,
    "viewCount": 123,
    "likeCount": 123,
    "tags": [
      "<string>"
    ],
    "thumbnails": {
      "best": "<string>",
      "min": "<string>"
    },
    "channel": {
      "id": "<string>",
      "name": "<string>",
      "handle": "<string>",
      "subscriberCount": "<string>",
      "thumbnails": {
        "best": "<string>",
        "min": "<string>"
      }
    },
    "chapters": [
      {
        "title": "<string>",
        "start": 123,
        "thumbnails": {
          "best": "<string>",
          "min": null
        }
      }
    ],
    "relatedVideos": [
      {
        "videoId": "<string>",
        "title": "<string>",
        "duration": 123,
        "isLive": false,
        "uploadDate": "<string>",
        "viewCount": 123,
        "thumbnails": {
          "best": "<string>",
          "min": "<string>"
        },
        "channel": {
          "id": "<string>",
          "name": "<string>",
          "handle": null,
          "subscriberCount": "<string>",
          "thumbnails": {
            "best": null,
            "min": "<string>"
          }
        }
      }
    ]
  }
}
Use this endpoint to extract structured metadata from a YouTube video, including title, channel information, duration, thumbnails, and engagement metrics. Designed for AI agents, the response is clean, predictable, and ready for downstream tasks like enrichment, classification, or content understanding.

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json
​
videoUrl
string
required
Example:

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

Response

​
video
object