Las herramientas de análisis de YouTube (vidIQ, TubeBuddy) cobran entre 8 y 40 dólares al mes por el análisis del canal. Para los desarrolladores y creadores basados en datos, una API de búsqueda proporciona datos sin procesar para crear análisis personalizados: qué clasificación tienen los competidores, dónde existen lagunas de contenido y qué palabras clave tienen una competencia débil.
Requisitos previos
- Python 3.8+
- Una clave API de Scavio
- Canales de destino o palabras clave para analizar
Guia paso a paso
Paso 1: Buscar contenido del canal
Encuentre todos los videos de un canal específico que se clasifiquen según las palabras clave objetivo.
Python
import requests, os
H = {'x-api-key': os.environ['SCAVIO_API_KEY'], 'Content-Type': 'application/json'}
def channel_keywords(channel_name: str, keywords: list) -> dict:
results = {'channel': channel_name, 'rankings': []}
for kw in keywords:
resp = requests.post('https://api.scavio.dev/api/v1/search', headers=H,
json={'platform': 'youtube', 'query': kw}, timeout=10)
for i, v in enumerate(resp.json().get('organic', [])):
if channel_name.lower() in v.get('channel', '').lower():
results['rankings'].append({
'keyword': kw, 'position': i + 1,
'title': v.get('title', ''), 'views': v.get('views', '')
})
break
return resultsPaso 2: Encontrar lagunas de contenido
Identifique palabras clave en las que no exista ningún vídeo potente (bajo número de visualizaciones o pocos resultados).
Python
def find_content_gaps(keywords: list, view_threshold: int = 10000) -> list:
gaps = []
for kw in keywords:
resp = requests.post('https://api.scavio.dev/api/v1/search', headers=H,
json={'platform': 'youtube', 'query': kw}, timeout=10)
videos = resp.json().get('organic', [])
# Gap conditions: few results OR top results have low views
if len(videos) < 5:
gaps.append({'keyword': kw, 'reason': 'few_videos', 'video_count': len(videos)})
elif videos and all(int(v.get('views','0').replace(',','') or '0') < view_threshold for v in videos[:3]):
gaps.append({'keyword': kw, 'reason': 'low_competition', 'top_views': videos[0].get('views','')})
return gapsPaso 3: Análisis de la competencia
Compare las clasificaciones de palabras clave de su canal con las de la competencia.
Python
def competitor_comparison(your_channel: str, competitor: str, keywords: list) -> dict:
your_ranks = channel_keywords(your_channel, keywords)
their_ranks = channel_keywords(competitor, keywords)
comparison = []
for kw in keywords:
your_pos = next((r['position'] for r in your_ranks['rankings'] if r['keyword'] == kw), None)
their_pos = next((r['position'] for r in their_ranks['rankings'] if r['keyword'] == kw), None)
comparison.append({
'keyword': kw,
'your_position': your_pos,
'their_position': their_pos,
'winning': 'you' if (your_pos and their_pos and your_pos < their_pos) else
'them' if (their_pos and (not your_pos or their_pos < your_pos)) else 'neither'
})
return {
'you': your_channel, 'competitor': competitor,
'you_winning': sum(1 for c in comparison if c['winning'] == 'you'),
'them_winning': sum(1 for c in comparison if c['winning'] == 'them'),
'details': comparison
}Ejemplo en Python
Python
import requests, os
H = {'x-api-key': os.environ['SCAVIO_API_KEY'], 'Content-Type': 'application/json'}
def yt_rank(keyword, channel):
r = requests.post('https://api.scavio.dev/api/v1/search', headers=H,
json={'platform': 'youtube', 'query': keyword}).json()
for i, v in enumerate(r.get('organic',[])):
if channel.lower() in v.get('channel','').lower():
return i + 1
return NoneEjemplo en JavaScript
JavaScript
async function ytRank(keyword, channel) {
const r = await fetch('https://api.scavio.dev/api/v1/search', {
method: 'POST', headers: {'x-api-key': process.env.SCAVIO_API_KEY, 'Content-Type': 'application/json'},
body: JSON.stringify({platform: 'youtube', query: keyword})
});
const results = (await r.json()).organic || [];
const idx = results.findIndex(v => v.channel?.toLowerCase().includes(channel.toLowerCase()));
return idx >= 0 ? idx + 1 : null;
}Salida esperada
JSON
A YouTube channel analyzer that tracks keyword rankings, finds content gaps, and compares performance against competitors using search API data.