20 % de desconto em todos os planos pagos com o código

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).

everydata.py
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")

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.

channel_videos.py
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
Resposta de exemplo · GET /ytb/youtube-channel-videos
{
  "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.

video_details.py
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"]))
Resposta de exemplo · GET /ytb/youtube-video-details
{
  "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 languageCode e countryCode, 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

GET/ytb/youtube-search-videos

Search Videos · API YouTube

GET/ytb/youtube-channel-videos

Channel Videos · API YouTube

GET/ytb/youtube-video-details

Video Details · API YouTube

Todos os parâmetros na referência da API

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.