Python · YouTube
Scraping do YouTube com Python
Fazer scraping do YouTube com um navegador significa rolar listas infinitas, esperar scripts e fazer parsing de um markup que muda com frequência. A YouTube Data API oficial exige um projeto no Google Cloud e raciona as requisições com uma cota diária. Este guia segue um terceiro caminho: você faz scraping do YouTube com Python chamando a API da everydata.io, que lê as páginas públicas do YouTube e as devolve como JSON.
Você vai criar três pequenos scripts: um scraper do YouTube para resultados de busca, que percorre as páginas de resultados e as salva em CSV, outro que lista os vídeos mais recentes de um canal e um terceiro que busca todos os detalhes de um vídeo – visualizações, curtidas, número de comentários, data de publicação, duração, categoria e tags.
Atualizado em · por everydata.io
O que você terá no final
- Um script Python que faz scraping dos resultados de busca do YouTube para qualquer termo em videos.csv.
- Os vídeos mais recentes de qualquer canal por ID do canal, URL do handle ou URL do canal.
- Detalhes completos do vídeo por ID, com uma função auxiliar reutilizável que lida com limites de taxa (rate limit) e novas tentativas.
O que você precisa
- Python 3.10 ou mais recente e o pacote
requests(pip install requests). - Uma chave de API gratuita da everydata.io – crie uma aqui.
- Um termo de busca, um canal ou um vídeo do qual você quer fazer scraping.
01Por que fazer scraping do YouTube por uma API?
O YouTube monta suas páginas com JavaScript e carrega mais resultados conforme você rola, então uma requisição HTTP simples traz poucos dados úteis e um navegador headless precisa rolar, esperar e fazer parsing. A API de YouTube da everydata.io faz esse trabalho no servidor: cada chamada retorna uma página de resultados, com um cursor para a próxima.
Em comparação com a YouTube Data API oficial, não há tela de OAuth, nem projeto no Google Cloud, nem cota diária de unidades – só a sua chave da everydata.io. Cada chamada é uma requisição do seu plano, e respostas com status 5xx não são contadas.
02Escreva uma pequena função auxiliar para as requisições
Coloque sua chave no ambiente (export EVERYDATA_API_KEY="ds_your_key") e salve esta função auxiliar como everydata.py. Ela espera quando você envia requisições demais de uma vez (status 429, a resposta diz quantos segundos) e tenta de novo, uma vez, uma página que não pôde ser carregada (5xx).
import os
import re
import time
import requests
API = "https://api.everydata.io"
KEY = os.environ["EVERYDATA_API_KEY"]
def api_get(path: str, params: dict) -> dict:
"""GET an everydata.io endpoint. Waits when rate limited (429) and retries a failed page load (5xx) once."""
retried = False
for _ in range(4):
resp = requests.get(f"{API}{path}", params=params, headers={"x-api-key": KEY}, timeout=60)
if resp.status_code == 429:
wait = re.search(r"in (\d+) seconds", resp.text)
time.sleep(int(wait.group(1)) + 1 if wait else 60)
continue
if resp.status_code >= 500 and not retried:
retried = True # 5xx answers are not counted against your quota
time.sleep(10)
continue
resp.raise_for_status()
return resp.json()
raise RuntimeError("still rate limited after several waits – try again later")03Extraia os resultados de busca do YouTube para um arquivo CSV
O endpoint de busca recebe uma query e, opcionalmente, languageCode e countryCode (padrão en e US), e retorna a lista de resultados em items e um cursor para a próxima página. Os resultados misturam vídeos, canais e playlists, então o script mantém apenas type video.
"""Scrape YouTube search results for a query into videos.csv – several pages via the cursor."""
import csv
from everydata import api_get # the helper from step 2, saved as everydata.py
QUERY = "lofi hip hop"
MAX_PAGES = 3 # every page is one request
rows, cursor = [], None
for page in range(1, MAX_PAGES + 1):
params = {"query": QUERY, "languageCode": "en", "countryCode": "US"}
if cursor:
params["cursor"] = cursor
data = api_get("/ytb/youtube-search-videos", params)
for item in data["items"]:
if item["type"] != "video": # results also contain channels and playlists
continue
rows.append({
"page": page,
"video_id": item["videoId"],
"title": item["title"],
"channel": item["channelName"],
"views": item["viewCount"],
"published": item["publishedTimeText"],
"duration_s": item["duration"],
"live": item["isLive"],
})
cursor = data.get("cursor")
if not cursor:
break
with open("videos.csv", "w", newline="") as f:
writer = csv.DictWriter(f, fieldnames=list(rows[0]))
writer.writeheader()
writer.writerows(rows)
print(len(rows), "videos saved to videos.csv")Uma versão resumida do exemplo documentado para a busca lofi hip hop:
{
"responseStatus": "PAGE_FOUND",
"responseMessage": "Page successfully found!",
"query": "lofi hip hop",
"estimatedResults": 2407972,
"items": [
{
"type": "video",
"videoId": "n61ULEU7CO0",
"title": "Best of lofi hip hop 2021 ✨ [beats to relax/study to]",
"channelId": "UCSJ4gkVC6NrvII8umztf0Ow",
"channelName": "Lofi Girl",
"viewCount": 57439529,
"viewCountText": "57,439,529 views",
"publishedTimeText": "4 years ago",
"duration": 22258,
"durationText": "6:10:58",
"isLive": false
}
]
}viewCount é um número que você pode ordenar e somar; viewCountText é o rótulo que o YouTube mostra. Em transmissões ao vivo, o rótulo diz “watching” e duration é null. Nos resultados de busca, publishedTimeText é relativo (“4 years ago”) – a chamada de detalhes do vídeo retorna o publishedAt exato.
04Scraping dos vídeos de um canal do YouTube
Para um canal, passe o ID do canal, a URL do handle (https://www.youtube.com/@WWE) ou a URL do canal como id. filter escolhe a aba: videos_latest (padrão), streams_latest, shorts_latest ou live_now. Avance as páginas com cursor, como no script de busca.
from everydata import api_get
data = api_get("/ytb/youtube-channel-videos", {"id": "https://www.youtube.com/@WWE", "filter": "videos_latest"})
for item in data["items"]:
print(item["videoId"], item["viewCount"], item["publishedTimeText"], item["title"])
next_page = data["cursor"] # pass as cursor=... for the next page{
"responseStatus": "PAGE_FOUND",
"responseMessage": "Page successfully found!",
"channelId": "UCJ5v_MCY6GNUBTO8-D3XoAg",
"filter": "videos_latest",
"items": [
{
"type": "video",
"videoId": "b7kl_pcHa0A",
"title": "Blake Monroe vows to get payback against Giulia: SmackDown exclusive, Sept. 18, 2026",
"viewCount": 6800,
"viewCountText": "6.8K views",
"publishedTimeText": "47 minutes ago",
"duration": 110,
"durationText": "1:50"
}
]
}05Scraping dos detalhes de vídeos do YouTube
As listas de busca e de canal fornecem IDs de vídeo. Para o registro completo de um vídeo – contagem exata de visualizações, curtidas e comentários, data de publicação, categoria, tags e mais – chame o endpoint de detalhes do vídeo com o ID ou a URL do vídeo.
from everydata import api_get
v = api_get("/ytb/youtube-video-details", {"id": "kJQP7kiw5Fk"})
print(v["title"], "by", v["channelName"])
print(v["viewCount"], "views,", v["likeCount"], "likes,", v["commentCount"], "comments")
print("published", v["publishedAt"], "| duration", v["durationText"], "| category", v["category"])
print("tags:", ", ".join(v["tags"])){
"responseStatus": "PAGE_FOUND",
"responseMessage": "Page successfully found!",
"videoId": "kJQP7kiw5Fk",
"title": "Luis Fonsi - Despacito ft. Daddy Yankee",
"channelName": "LuisFonsiVEVO",
"viewCount": 9125159593,
"likeCount": 56673581,
"commentCount": 4300000,
"publishedAt": "2017-01-12T21:00:02-08:00",
"duration": 282,
"durationText": "4:42",
"category": "Music",
"tags": [
"Calypso",
"Despacito"
]
}Para acompanhar esses números ao longo do tempo, o guia de estatísticas de vídeos do YouTube os salva periodicamente. Para a seção de comentários de um vídeo, veja a API de comentários do YouTube.
06Custos e limites do scraping do YouTube
- Cada página de busca, página de canal e consulta de vídeo é uma requisição. Três páginas de busca mais os detalhes de 20 vídeos somam 23 requisições; o plano gratuito inclui 100 requisições por mês.
- Os resultados seguem
languageCodeecountryCode, como o YouTube faz para um visitante daquele país. - Apenas dados públicos: vídeos privados, excluídos ou bloqueados na região respondem com HTTP 404 em vez de um objeto preenchido pela metade.
Endpoints usados neste guia
Search Videos · API YouTube
Channel Videos · API YouTube
Video Details · API YouTube
O que mais você pode fazer com esses dados
Metadados do YouTube em JSON – título, views, likes, comentários, duração, tags, thumbnails, legendas – por ID ou URL. Sem OAuth, sem cota da Data API.
Estatísticas públicas de canais do YouTube via REST: inscritos, número de vídeos, verificação, vídeos recentes, lives, Shorts e playlists por ID ou @handle.
Scraping de comentários do YouTube por ID ou URL: texto, autor, likes, respostas, fixado e com coração, com paginação por cursor nas respostas. Sem OAuth.
Teste com seus próprios dados
O plano gratuito inclui 100 requisições por mês, válidas em todas as plataformas – o suficiente para seguir este guia do início ao fim.