Get basic video info

getVideoBasicInfo(id, query?, options?): VideoBasicInfo

GET

https://api.ytapi.dev/v1/videos/{id}/basic-info

Free

Free lookup. Returns essential video metadata: title, duration, channel attribution, and available caption languages without consuming credits or YouTube Data API quota. Use it as a quick pre-check or validation step before spending credits on transcript extraction or full metadata.

Credits

Successful basic-info responses are completely free (0 credits). Failed lookups are not billed.

Security

API Key

All requests require a valid API key from the developer dashboard.

Headers: Authorization: Bearer YOUR_API_KEYorX-API-Key: YOUR_API_KEY

See Authentication for headers and rate limits.

Path Parameters

Parameter	Type	Required	Description
`id`path	`string`	Yes	11-character YouTube video ID or video URL.

Response (HTTP 200)

{
  "video_id": string,          // Echoed YouTube video ID
  "title": string,             // Video title
  "length_seconds": number,    // Duration in seconds
  "channel": {                 // Channel attribution
    "id": string,              // Canonical channel ID
    "title": string,           // Channel display name
    "url": string              // Channel URL
  },
  "available_languages": [     // Caption tracks advertised for the video
    {
      "code": string,          // ISO language code (e.g. "en")
      "name": string,          // Display name (e.g. "English (auto-generated)")
      "kind": string           // "asr" or "manual"
    }
  ]
}

Get basic video info

curl -X GET "https://api.ytapi.dev/v1/videos/kCc8FmEb1nY/basic-info" \
  -H "Authorization: Bearer $YT_API_KEY"

const id = "kCc8FmEb1nY";
const response = await fetch(
  `https://api.ytapi.dev/v1/videos/${id}/basic-info`,
  {
    headers: {
      Authorization: `Bearer ${process.env.YT_API_KEY}`,
    },
  },
);

const video = await response.json();
console.log(video.title, video.length_seconds, video.available_languages);

import os
import requests

response = requests.get(
    "https://api.ytapi.dev/v1/videos/kCc8FmEb1nY/basic-info",
    headers={"Authorization": f"Bearer {os.environ['YT_API_KEY']}"},
)
video = response.json()
print(video["title"], video["length_seconds"])

package main

import (
	"fmt"
	"net/http"
	"os"
)

func main() {
	req, _ := http.NewRequest("GET", "https://api.ytapi.dev/v1/videos/kCc8FmEb1nY/basic-info", nil)
	req.Header.Set("Authorization", "Bearer "+os.Getenv("YT_API_KEY"))

	resp, err := http.DefaultClient.Do(req)
	if err != nil {
		panic(err)
	}
	defer resp.Body.Close()
	fmt.Println(resp.Status)
}