Video Information

POST /api/info

Video Information

cURL

curl --request POST \
  --url https://api.example.com/api/info \
  --header 'Content-Type: application/json' \
  --data '
{
  "url": "<string>"
}
'

200

{
  "id": "<string>",
  "title": "<string>",
  "description": "<string>",
  "thumbnail": "<string>",
  "duration": 123,
  "uploader": "<string>",
  "uploader_url": "<string>",
  "view_count": 123,
  "like_count": 123,
  "upload_date": "<string>",
  "webpage_url": "<string>",
  "is_playlist": true,
  "playlist_count": {},
  "subtitles": {},
  "formats": [
    {
      "format_id": "<string>",
      "ext": "<string>",
      "quality": "<string>",
      "resolution": "<string>",
      "filesize": {},
      "filesize_approx": {},
      "vcodec": "<string>",
      "acodec": "<string>",
      "abr": {},
      "vbr": {},
      "fps": {},
      "asr": {},
      "audio_channels": {},
      "format_note": "<string>"
    }
  ]
}

Retrieve detailed information about a YouTube video, including all available download formats.

Request Body

url · string · required

YouTube video URL to fetch information for

Response

id · string

YouTube video ID

title · string

Video title

description · string

Full video description

thumbnail · string

Thumbnail image URL

duration · integer

Video duration in seconds

uploader · string

Channel name or uploader name

uploader_url · string

URL to the uploader’s channel

view_count · integer

Total number of views

like_count · integer

Number of likes

upload_date · string

Upload date in YYYYMMDD format

webpage_url · string

Original webpage URL

is_playlist · boolean

Whether the URL is a playlist

playlist_count · integer | null

Number of videos in playlist (null if not a playlist)

subtitles · object

Available subtitle tracks by language code

formats · array

Array of all available download formats

Show Format Object

format_id · string

Unique format identifier (used for download selection)

ext · string

File extension (mp4, webm, m4a, etc.)

quality · string

Human-readable quality (e.g., “1080p”, “720p”, “audio”)

resolution · string

Resolution in WIDTHxHEIGHT format

filesize · integer | null

Exact file size in bytes (if available)

filesize_approx · string | null

Approximate file size as string

vcodec · string

Video codec (e.g., “avc1”, “vp9”, “none” for audio-only)

acodec · string

Audio codec (e.g., “mp4a”, “opus”, “none” for video-only)

abr · number | null

Audio bitrate in kbps

vbr · number | null

Video bitrate in kbps

fps · number | null

Frames per second

asr · integer | null

Audio sample rate in Hz

audio_channels · integer | null

Number of audio channels

format_note · string

Additional format notes (e.g., “premium”, “medium”)

Example Request

curl -X POST "http://localhost:8001/api/info" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://www.youtube.com/watch?v=dQw4w9WgXcQ"
  }'

Example Response

{
  "id": "dQw4w9WgXcQ",
  "title": "Example Video Title",
  "description": "This is a detailed video description...",
  "thumbnail": "https://i.ytimg.com/vi/dQw4w9WgXcQ/maxresdefault.jpg",
  "duration": 212,
  "uploader": "Example Channel",
  "uploader_url": "https://www.youtube.com/@ExampleChannel",
  "view_count": 1000000000,
  "like_count": 15000000,
  "upload_date": "20091025",
  "webpage_url": "https://www.youtube.com/watch?v=dQw4w9WgXcQ",
  "is_playlist": false,
  "playlist_count": null,
  "subtitles": {
    "en": [
      {
        "ext": "vtt",
        "url": "https://..."
      }
    ]
  },
  "formats": [
    {
      "format_id": "137",
      "ext": "mp4",
      "quality": "1080p",
      "resolution": "1920x1080",
      "filesize": 45678901,
      "filesize_approx": null,
      "vcodec": "avc1.640028",
      "acodec": "none",
      "abr": null,
      "vbr": 2500,
      "fps": 30,
      "asr": null,
      "audio_channels": null,
      "format_note": "1080p"
    },
    {
      "format_id": "136",
      "ext": "mp4",
      "quality": "720p",
      "resolution": "1280x720",
      "filesize": 23456789,
      "filesize_approx": null,
      "vcodec": "avc1.4d401f",
      "acodec": "none",
      "abr": null,
      "vbr": 1500,
      "fps": 30,
      "asr": null,
      "audio_channels": null,
      "format_note": "720p"
    },
    {
      "format_id": "140",
      "ext": "m4a",
      "quality": "audio",
      "resolution": "",
      "filesize": 3456789,
      "filesize_approx": null,
      "vcodec": "none",
      "acodec": "mp4a.40.2",
      "abr": 128,
      "vbr": null,
      "fps": null,
      "asr": 44100,
      "audio_channels": 2,
      "format_note": "medium"
    }
  ]
}

Error Responses

400 Bad Request

Returned when the URL is missing or invalid.

{
  "detail": "URL requerida"
}

{
  "detail": "No se pudo obtener información: [error message]"
}

Implementation Notes

• Uses yt-dlp to extract comprehensive video metadata
• Returns all available formats (video-only, audio-only, and combined streams)
• Format IDs can be used with the /api/download endpoint for specific quality selection
• Video-only formats (acodec=“none”) require merging with audio during download
• Audio-only formats (vcodec=“none”) are suitable for audio extraction
• Supports both individual videos and playlists
• Does not download content, only extracts metadata