- name
- scavio-youtube
- description
- Search YouTube and retrieve video metadata. Use for finding videos, checking view counts, channel info, or AI training suitability.
- version
- 2.1.0
- tags
- youtube, video-search, metadata, agents, langchain, crewai, autogen, structured-data, json, ai-agents, content-research
- metadata
- openclaw
- requires
- env
- primaryEnv
- SCAVIO_API_KEY
- emoji
- \▶
- homepage
- https://scavio.dev/docs
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 (1,000 free credits/month, no card required):
export SCAVIO_API_KEY=sk_live_your_keyWorkflow
- Finding a video: call
/searchwith the topic. Usesort_by: view_countfor the most-watched result. - Checking metadata: call
/metadatafor view counts, likes, tags, or channel info. - Trainability: call
/trainabilityto check license and caption availability before ingesting.
Endpoints
| Endpoint | Description |
|---|---|
POST https://api.scavio.dev/api/v1/youtube/search | Search YouTube videos |
POST https://api.scavio.dev/api/v1/youtube/metadata | Get structured video metadata |
POST https://api.scavio.dev/api/v1/youtube/trainability | Check AI training suitability |
Authorization: Bearer $SCAVIO_API_KEYSearch Parameters
| Parameter | Type | Default | Description |
|---|---|---|---|
search | string | required | Search query — note: this field is search, not query |
upload_date | string | -- | last_hour, today, this_week, this_month, this_year |
type | string | -- | video, channel, or playlist |
duration | string | -- | short (< 4 min), medium (4-20 min), long (> 20 min) |
sort_by | string | relevance | relevance, date, view_count, rating |
subtitles | boolean | false | Videos with captions only |
creative_commons | boolean | false | Creative Commons videos only |
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, notquery— 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_KEYis not set, prompt the user to export it before continuing.
LangChain
pip install scavio-langchainfrom scavio_langchain import ScavioSearchTool
tool = ScavioSearchTool(engine="youtube")