YTubeInsight

YTubeInsight

YTubeInsight é um pacote Python para análises de canais do YouTube sem esforço. Rastrear contagens de vídeo, extrair detalhes e obter informações dos canais do YouTube com facilidade.

Características

• Analise os canais do YouTube usando URLs de canal completo ou IDs de canal
• Count Videos publicados no último ano
• Recuperar informações detalhadas sobre cada vídeo (título, data de publicação, URL)
• API fácil de usar com tratamento abrangente de erros
• Compatibilidade com Python 3.6+

Instalação

Você pode instalar o YTubeInsight usando o PIP. Recomendamos o uso de um ambiente virtual para gerenciar suas dependências. Você pode escolher entre Venv (incorporado ao Python) ou CONDA com base na sua preferência.

Opção 1: Usando Venv

1. Crie um ambiente virtual:

    python -m venv ytubeinsight-env
   

2. Ative o ambiente virtual:

   • No Windows:

      ytubeinsight-envScriptsactivate
     

   • No macOS e Linux:

      source ytubeinsight-env/bin/activate
     

3. Instale YtubeInsight:

    pip install ytubeinsight
   

Opção 2: Usando o CONA

1. Crie um ambiente de conda:

    conda create --name ytubeinsight-env python=3.8
   

2. Ative o ambiente do CONDA:

    conda activate ytubeinsight-env
   

3. Instale YtubeInsight:

    pip install ytubeinsight
   

Início rápido

Aqui está um exemplo simples de como usar o YTubeInsight:

 from ytubeinsight import analyze_channel

# Replace with your YouTube Data API key
API_KEY = 'YOUR_API_KEY_HERE'

# Analyze a channel by URL
channel_url = 'https://www.youtube.com/channel/UC_x5XG1OV2P6uZZ5FSM9Ttw'
result = analyze_channel ( channel_url , API_KEY )

print ( f"Videos published in the last year: { result [ 'video_count' ] } " )

# Print details of the first video
if result [ 'video_data' ]:
    video = result [ 'video_data' ][ 0 ]
    print ( f"Latest video:" )
    print ( f"Title: { video [ 'title' ] } " )
    print ( f"Published on: { video [ 'published_at' ] } " )
    print ( f"URL: { video [ 'url' ] } " )

Uso detalhado

Analisando um canal por URL

 from ytubeinsight import analyze_channel

result = analyze_channel ( 'https://www.youtube.com/channel/UC_x5XG1OV2P6uZZ5FSM9Ttw' , 'YOUR_API_KEY' )

Analisando um canal por id

 from ytubeinsight import analyze_channel

result = analyze_channel ( 'UCJFp8uSYCjXOMnkUyb3CQ3Q' , 'YOUR_API_KEY' , is_channel_id = True )

Erros de manuseio

 from ytubeinsight import analyze_channel , YTubeInsightError

try :
    result = analyze_channel ( 'invalid_channel_url' , 'YOUR_API_KEY' )
except YTubeInsightError as e :
    print ( f"An error occurred: { str ( e ) } " )

Referência da API

Analyze_Channel (canal_input, api_key, is_channel_id = false)

Analisa um canal do YouTube e retorna dados de vídeo no ano passado.

• channel_input : um URL de canal completo ou ID de canal
• api_key : Chave da API de dados do YouTube
• is_channel_id : booleano indicando se Channel_input é um ID do canal

Retorna um dicionário contendo:

• video_count : número de vídeos publicados no ano passado
• video_data : lista de dicionários, cada um contendo detalhes de vídeo (título, data de publicação, URL)

Para uma documentação da API mais detalhada, visite nossa página de leitura da leitura.

Obtenção de uma chave da API de dados do YouTube

Para usar o YTubeInsight, você precisa de uma chave da API de dados do YouTube. Veja como conseguir um:

1. Vá para o console do Google Developers.
2. Crie um novo projeto ou selecione um existente.
3. Ative a API de dados do YouTube V3 para o seu projeto.
4. Crie credenciais (chave da API) para o seu projeto.
5. Use esta chave da API em suas chamadas YTubeInsight.

Lembre -se de manter sua chave da API em segredo e nunca compartilhá -lo publicamente.

Requisitos

• Python 3.6+
• Google-api-python-client
• solicitações
• BELAGENSOUP4

Desenvolvimento

Para configurar o ambiente de desenvolvimento:

1. Clone o repositório:

    git clone https://github.com/FahimFBA/YTubeInsight.git
   cd YTubeInsight
   

2. Crie e ative um ambiente virtual (escolha um):

   • Usando Venv:

      python -m venv venv
     source venv/bin/activate  # On Windows, use `venvScriptsactivate`
     

   • Usando conda:

      conda create --name ytubeinsight-dev python=3.8
     conda activate ytubeinsight-dev
     

3. Instale as dependências de desenvolvimento:

    pip install -e .[dev]
   

4. Execute os testes:

    pytest
   

Contribuindo

As contribuições são bem -vindas! Sinta -se à vontade para enviar uma solicitação de tração.

1. Fork o repositório
2. Crie seu ramo de recursos ( git checkout -b feature/AmazingFeature )
3. Comprometa suas mudanças ( git commit -m 'Add some AmazingFeature' )
4. Empurre para o ramo ( git push origin feature/AmazingFeature )
5. Abra um pedido de tração

Certifique -se de atualizar os testes conforme apropriado e aderir ao Código de Conduta.

Licença

Este projeto está licenciado sob a licença do MIT - consulte o arquivo de licença para obter detalhes.

Changelog

Para um Changelog detalhado, consulte o arquivo changelog.md.

Agradecimentos

• Google para fornecer a API de dados do YouTube
• Todos os colaboradores que ajudam a melhorar este pacote

Apoiar

Se você encontrar algum problema ou tiver alguma dúvida, abra um problema no GitHub.

Isenção de responsabilidade

Este projeto não é afiliado, autorizado, mantido, patrocinado ou endossado pelo YouTube ou por qualquer uma de suas afiliadas ou subsidiárias. Esta é uma API independente e não oficial. Use por sua conta e risco.