Search YouTube

search(query, options?): SearchResponse

GET/v1/search1 Credit

Search videos, channels, playlists, or movies. Does not consume YouTube Data API quota.

Security

API Token

The preferred authorization scheme for the YouTube Transcript API. Create a key with transcripts:read in the developer dashboard.

Example: Authorization: Bearer YOUR_API_KEY

See Authentication for scopes and rate limits.

Accepted permissions (at least one required)

transcripts:read

ParametersExpand Collapse

q:string

Query param:

Search keyword or phrase.

limit?:number

Query param:

Max results to return, from 1 to 50. Default 20.

type?:string

Query param:

video, channel, playlist, or movie. Default video.

upload_date?:string

Query param:

hour, today, week, month, or year.

sort_by?:string

Query param:

relevance, date, view_count, or rating. Default relevance.

ReturnsExpand Collapse

query:string

Echoed search string.

total_results:number

Number of items in this response.

results:SearchResult[]

Hits with id, type, title, channel fields, duration, views, and thumbnail.

Search YouTube

const params = new URLSearchParams({
  q: "AI Agents",
  type: "video",
  upload_date: "month",
  limit: "10",
});

const response = await fetch(`https://api.ytapi.dev/v1/search?${params}`, {
  headers: {
    Authorization: `Bearer ${process.env.YT_API_KEY}`,
  },
});

const data = await response.json();
console.log(data.results.map((item: { title: string }) => item.title));

import os
import requests

response = requests.get(
    "https://api.ytapi.dev/v1/search",
    headers={"Authorization": f"Bearer {os.environ['YT_API_KEY']}"},
    params={
        "q": "AI Agents",
        "type": "video",
        "upload_date": "month",
        "limit": 10,
    },
)

print(response.json())

curl -X GET "https://api.ytapi.dev/v1/search?q=AI+Agents&type=video&upload_date=month&limit=10" \
  -H "Authorization: Bearer $YT_API_KEY"

package main

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

func main() {
	url := "https://api.ytapi.dev/v1/search?q=AI+Agents&type=video&upload_date=month&limit=10"
	req, _ := http.NewRequest("GET", url, 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)
}

200 example

{
  "query": "AI Agents",
  "total_results": 10,
  "results": [
    {
      "id": "abc123xyz89",
      "type": "video",
      "title": "Building Autonomous AI Coding Agents from Scratch",
      "channel_title": "AI Engineering Hub",
      "channel_id": "UC1234567890",
      "duration_seconds": 1240,
      "view_count": 89420,
      "upload_date": "2024-03-10",
      "thumbnail_url": "https://i.ytimg.com/vi/abc123xyz89/mqdefault.jpg"
    }
  ]
}