YouTube Search and Metadata via Scavio

Search YouTube and retrieve video metadata. All endpoints return structured JSON.

When to trigger

Use this skill when the user asks to:

• Find YouTube videos on a topic
• Check view counts, upload date, or video metadata
• Verify if a video is suitable for AI training or has captions available

Setup

Get a free API key at https://scavio.dev (250 free credits/month, no card required):

export SCAVIO_API_KEY=sk_live_your_key

Workflow

1. Finding a video: call /search with the topic. Use sort_by: view_count for the most-watched result.
2. Checking metadata: call /metadata for view counts, likes, tags, or channel info.
3. Trainability: call /trainability to check license and caption availability before ingesting.

Endpoints

Authorization: Bearer $SCAVIO_API_KEY

Search Parameters

Examples

import os, requests

BASE = "https://api.scavio.dev"
HEADERS = {"Authorization": f"Bearer {os.environ['SCAVIO_API_KEY']}"}

# Search — use "search" field, not "query"
results = requests.post(f"{BASE}/api/v1/youtube/search", headers=HEADERS,
    json={"search": "langchain tutorial", "type": "video", "sort_by": "view_count"}).json()

video_id = results["data"][0]["videoId"]

# Metadata
metadata = requests.post(f"{BASE}/api/v1/youtube/metadata", headers=HEADERS,
    json={"video_id": video_id}).json()

Search Response

{
  "data": [
    {
      "videoId": "sVcwVQRHIc8",
      "title": "Learn RAG From Scratch - Python AI Tutorial",
      "channel": "freeCodeCamp.org",
      "publishedAt": "2024-04-17",
      "duration": "2:33:11",
      "viewCount": 1258310,
      "thumbnail": "https://i.ytimg.com/vi/sVcwVQRHIc8/hq720.jpg"
    }
  ],
  "credits_used": 1
}

Metadata response: title, view_count, like_count, comment_count, categories, tags, channel_id, upload_date, thumbnails.

Trainability response: has_transcript, transcript_languages, license, is_trainable.

Guardrails

• The search parameter is search, not query — this is different from other Scavio endpoints.
• Never fabricate video IDs, view counts, or metadata.

Failure handling

• If search returns no results, suggest different keywords or relaxing filters.
• If SCAVIO_API_KEY is not set, prompt the user to export it before continuing.

LangChain

pip install langchain-scavio

from langchain_scavio import ScavioSearchTool
tool = ScavioSearchTool(engine="youtube")