YTubeInsight

Ytubeinsight

YTubeInsight es un paquete de Python para el análisis de canales de YouTube sin esfuerzo. Rastree el recuento de video, extraiga detalles y obtenga información de los canales de YouTube con facilidad.

Características

• Analice los canales de YouTube utilizando URL de canal completo o ID de canal
• Conte videos publicados en el último año
• Recupere información detallada sobre cada video (título, Fecha de publicación, URL)
• API fácil de usar con manejo integral de errores
• Compatibilidad con Python 3.6+

Instalación

Puede instalar YTubeInsight usando PIP. Recomendamos utilizar un entorno virtual para administrar sus dependencias. Puede elegir entre Venv (integrado en Python) o conda en función de su preferencia.

Opción 1: Uso de Venv

1. Crear un entorno virtual:

    python -m venv ytubeinsight-env
   

2. Active el entorno virtual:

   • En Windows:

      ytubeinsight-envScriptsactivate
     

   • En macOS y Linux:

      source ytubeinsight-env/bin/activate
     

3. Instale YTubeInsight:

    pip install ytubeinsight
   

Opción 2: Uso de conda

1. Crea un entorno de conda:

    conda create --name ytubeinsight-env python=3.8
   

2. Active el entorno de conda:

    conda activate ytubeinsight-env
   

3. Instale YTubeInsight:

    pip install ytubeinsight
   

Comienzo rápido

Aquí hay un ejemplo simple de cómo usar 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 detallado

Análisis de un canal por URL

 from ytubeinsight import analyze_channel

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

Analizar un canal por identificación

 from ytubeinsight import analyze_channel

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

Errores de manejo

 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 ) } " )

Referencia de API

analze_channel (canal_input, api_key, is_channel_id = false)

Analiza un canal de YouTube y devuelve datos de video durante el año pasado.

• channel_input : ya sea una URL de canal completa o una ID de canal
• api_key : clave API de datos de YouTube
• is_channel_id : boolean indicando si channel_input es una ID de canal

Devuelve un diccionario que contiene:

• video_count : número de videos publicados en el último año
• video_data : lista de diccionarios, cada uno que contiene detalles de video (título, fecha de publicación, URL)

Para obtener una documentación de API más detallada, visite nuestra página Leer los documentos.

Obteniendo una clave de API de datos de YouTube

Para usar YTubeInsight, necesita una clave de API de datos de YouTube. Aquí le mostramos cómo obtener uno:

1. Vaya a la consola de Google Developers.
2. Cree un nuevo proyecto o seleccione uno existente.
3. Habilite la API de datos de YouTube V3 para su proyecto.
4. Crear credenciales (clave API) para su proyecto.
5. Use esta clave API en sus llamadas de YTubeInsight.

Recuerde mantener su clave API en secreto y nunca compartirla públicamente.

Requisitos

• Python 3.6+
• Google-API-Python-Client
• solicitudes
• BeautifulSoup4

Desarrollo

Para configurar el entorno de desarrollo:

1. Clon el repositorio:

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

2. Crear y activar un entorno virtual (elija uno):

   • Usando Venv:

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

   • Uso de condena:

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

3. Instale las dependencias de desarrollo:

    pip install -e .[dev]
   

4. Ejecute las pruebas:

    pytest
   

Que contribuye

¡Las contribuciones son bienvenidas! No dude en enviar una solicitud de extracción.

1. Bifurca el repositorio
2. Cree su rama de características ( git checkout -b feature/AmazingFeature )
3. Comprometer sus cambios ( git commit -m 'Add some AmazingFeature' )
4. Push to the Branch ( git push origin feature/AmazingFeature )
5. Abra una solicitud de extracción

Asegúrese de actualizar las pruebas según corresponda y cumplir con el código de conducta.

Licencia

Este proyecto tiene licencia bajo la licencia MIT; consulte el archivo de licencia para obtener más detalles.

Colegio de cambios

Para un ChangeLog detallado, consulte el archivo ChangeLog.md.

Expresiones de gratitud

• Google por proporcionar la API de datos de YouTube
• Todos los contribuyentes que ayudan a mejorar este paquete

Apoyo

Si encuentra algún problema o tiene alguna pregunta, abra un problema en GitHub.

Descargo de responsabilidad

Este proyecto no está afiliado, autorizado, mantenido, patrocinado o respaldado por YouTube ni a cualquiera de sus afiliadas o subsidiarias. Esta es una API independiente y no oficial. Use bajo su propio riesgo.