YouTube Channel Analyzer via API (Not Scraping)

import requests, os

def analyze_channel_visibility(channel_name: str, topics: list) -> dict:
    """Analyze how a YouTube channel appears in search results."""
    headers = {"x-api-key": os.environ["SCAVIO_API_KEY"]}
    visibility = {"channel": channel_name, "topics": {}}

    for topic in topics:
        resp = requests.post(
            "https://api.scavio.dev/api/v1/search",
            headers=headers,
            json={
                "query": f"{topic} site:youtube.com",
                "num_results": 10,
            },
            timeout=10,
        )
        results = resp.json().get("results", [])
        channel_hits = [
            {"position": i + 1, "title": r["title"], "url": r["url"]}
            for i, r in enumerate(results)
            if channel_name.lower() in r["title"].lower()
            or channel_name.lower() in r.get("url", "").lower()
        ]
        competitors = [
            {"position": i + 1, "title": r["title"]}
            for i, r in enumerate(results)
            if channel_name.lower() not in r["title"].lower()
        ]
        visibility["topics"][topic] = {
            "own_videos": channel_hits,
            "competitor_videos": competitors[:5],
        }

    return visibility

result = analyze_channel_visibility("Fireship", [
    "javascript tutorial 2026",
    "react vs vue 2026",
    "web development trends",
])
for topic, data in result["topics"].items():
    own = len(data["own_videos"])
    print(f"{topic}: {own} videos in top 10")

def find_content_gaps(niche_topics: list) -> list:
    """Find YouTube topics with no dominant channel."""
    headers = {"x-api-key": os.environ["SCAVIO_API_KEY"]}
    gaps = []

    for topic in niche_topics:
        resp = requests.post(
            "https://api.scavio.dev/api/v1/search",
            headers=headers,
            json={"query": f"{topic} site:youtube.com", "num_results": 10},
            timeout=10,
        )
        results = resp.json().get("results", [])
        channels = set()
        for r in results:
            # Extract channel from YouTube URL patterns
            url = r.get("url", "")
            if "youtube.com" in url:
                channels.add(url.split("/")[3] if len(url.split("/")) > 3 else "unknown")

        # If many different channels appear, no one dominates
        if len(channels) >= 6:
            gaps.append({"topic": topic, "unique_channels": len(channels)})

    return sorted(gaps, key=lambda x: x["unique_channels"], reverse=True)

gaps = find_content_gaps([
    "rust async tutorial 2026",
    "bun vs deno performance 2026",
    "htmx real world project",
    "sqlite for production 2026",
])
for g in gaps:
    print(f"Gap: {g['topic']} ({g['unique_channels']} different channels)")