YouTube Impression Decay: Track It Before It's Gone

import requests, os, json
from datetime import date

H = {'x-api-key': os.environ['SCAVIO_API_KEY']}
URL = 'https://api.scavio.dev/api/v1/search'
TRACKING_FILE = 'youtube_positions.json'

def track_position(keyword: str, video_id: str) -> dict:
    """Track where a specific video ranks for a keyword."""
    resp = requests.post(URL, headers=H,
        json={'platform': 'youtube', 'query': keyword}, timeout=15)
    results = resp.json().get('organic_results', [])

    position = None
    for i, r in enumerate(results):
        if video_id in r.get('link', ''):
            position = i + 1
            break

    return {
        'date': date.today().isoformat(),
        'keyword': keyword,
        'video_id': video_id,
        'position': position,
        'total_results': len(results)
    }

# Track multiple keywords for your video
KEYWORDS = [
    'python fastapi tutorial 2026',
    'fastapi rest api beginner',
    'fastapi vs flask 2026'
]
VIDEO_ID = 'dQw4w9WgXcQ'  # your video ID

for kw in KEYWORDS:
    result = track_position(kw, VIDEO_ID)
    pos = result['position'] or 'not found'
    print(f"{kw}: position {pos}")

import json
from collections import defaultdict

def load_history(filepath: str) -> list[dict]:
    with open(filepath) as f:
        return json.load(f)

def analyze_decay(history: list[dict]) -> dict:
    """Group by keyword, calculate decay rate."""
    by_keyword = defaultdict(list)
    for entry in history:
        if entry['position'] is not None:
            by_keyword[entry['keyword']].append({
                'date': entry['date'],
                'position': entry['position']
            })

    decay_report = {}
    for kw, positions in by_keyword.items():
        positions.sort(key=lambda x: x['date'])
        if len(positions) >= 2:
            first = positions[0]['position']
            last = positions[-1]['position']
            days = len(positions)
            decay_rate = (last - first) / days  # positive = decaying
            decay_report[kw] = {
                'start_position': first,
                'current_position': last,
                'decay_rate_per_day': round(decay_rate, 2),
                'status': 'decaying' if decay_rate > 0.1 else 'stable'
            }
    return decay_report

import requests, os

H = {'x-api-key': os.environ['SCAVIO_API_KEY']}
URL = 'https://api.scavio.dev/api/v1/search'

def check_and_alert(keyword: str, video_id: str, threshold: int = 5):
    """Alert if video drops below threshold position."""
    resp = requests.post(URL, headers=H,
        json={'platform': 'youtube', 'query': keyword}, timeout=15)
    results = resp.json().get('organic_results', [])

    for i, r in enumerate(results):
        if video_id in r.get('link', ''):
            if i + 1 > threshold:
                print(f"ALERT: '{keyword}' dropped to position {i + 1}")
                # Send Slack/email notification here
            return i + 1

    print(f"ALERT: '{keyword}' -- video not found in results")
    return None