Audiencia del creador

¿Qué hace Audiencia del creador?

YouTube no publica datos demográficos de la audiencia. La API de datos utilizada por youtube-channel-profile no los tiene. Existen dos fuentes honestas: los propios análisis del propietario del canal, compartidos con su consentimiento, o una estimación paga de un tercero que el humano apruebe. Cualquier otra cosa es una suposición. Dilo.

La regla del consentimiento

1. Los datos del propietario provienen del propietario. Ellos eligen qué compartir, para qué fechas y quién lo ve. Obtén eso por escrito (un correo electrónico o mensaje) antes de solicitar acceso.
2. El propietario inicia sesión con su propia cuenta. Nunca pidas su contraseña o un código de inicio de sesión, y nunca escribas uno por ellos.
3. El gasto necesita un sí. Pregunta al humano antes de cada consulta paga y menciona su costo.
4. Nunca infieras edad, género o ubicación a partir de nombres, rostros, voces, comentarios o miniaturas.
5. Consérvalo solo para el trabajo. Muéstralo solo al propietario y a las personas que él haya aprobado (política de YouTube III.E.3.b). Elimínalo dentro de los 7 días posteriores a una solicitud (III.E.4.g). Si lo conservas, verifica nuevamente el consentimiento del propietario cada 30 días (III.E.4.b).

Ruta 1: el propietario comparte desde YouTube Studio (comienza aquí)

Esto no requiere trabajo de API. Es adecuado para un informe único.

Opción A, exportación: pide al propietario que abra YouTube Studio, vaya a Analytics, luego a la pestaña Audiencia. Elige un rango de fechas (los últimos 90 días es un buen valor predeterminado) y luego comparte una captura de pantalla o exportación de edad, género y países principales.

Opción B, acceso de solo lectura: el propietario abre YouTube Studio y va a Configuración, luego a Permisos, luego a Invitar. Ingresa el correo electrónico de la cuenta de Google del humano y elige el rol de Visor (Limitado). Ese rol puede ver análisis pero no ingresos. Las invitaciones caducan después de 30 días. Cuando termine el trabajo, el propietario elimina el acceso desde la misma pantalla. Los canales de Marca deben moverse primero a los permisos del canal.

Ruta 2: la API de YouTube Analytics (trabajos repetitivos o más grandes)

Úsalo cuando el propietario, o su equipo, lo ejecutarán, o para un compromiso continuo con un consentimiento por escrito.

1. En Google Cloud, crea un proyecto. Habilita la API de YouTube Analytics y la API de datos de YouTube v3.
2. Configura la pantalla de consentimiento OAuth: tipo de usuario Externo, estado de publicación Pruebas. Agrega la cuenta de Google del propietario como usuario de prueba.
3. Crea un ID de cliente OAuth de tipo Aplicación de escritorio y descarga el archivo de cliente. Trátalo como un secreto.
4. Solicita solo estos alcances:
   • https://www.googleapis.com/auth/yt-analytics.readonly
   • https://www.googleapis.com/auth/youtube.readonly (la referencia de reports.query ahora también lo requiere)
   • Agrega yt-analytics-monetary.readonly solo si el propietario acepta compartir ingresos.
5. Ejecuta el inicio de sesión en la máquina donde el propietario inicia sesión él mismo. Por ejemplo:

# pip install google-auth-oauthlib requests
from google_auth_oauthlib.flow import InstalledAppFlow
import requests
SCOPES = ["https://www.googleapis.com/auth/yt-analytics.readonly",
          "https://www.googleapis.com/auth/youtube.readonly"]
creds = InstalledAppFlow.from_client_secrets_file("client_secret.json", SCOPES).run_local_server(port=0)
base = "https://youtubeanalytics.googleapis.com/v2/reports"
common = {"ids": "channel==MINE", "startDate": "2026-08-01", "endDate": "2026-10-31"}
auth = {"Authorization": f"Bearer {creds.token}"}
age_gender = requests.get(base, headers=auth, params={**common,
    "metrics": "viewerPercentage", "dimensions": "ageGroup,gender"}).json()
countries = requests.get(base, headers=auth, params={**common,
    "metrics": "views,estimatedMinutesWatched", "dimensions": "country",
    "sort": "-views", "maxResults": 10}).json()

6. El propietario elige el canal correcto cuando Google lo solicite. channel==MINE significa el canal con el que iniciaron sesión.
7. Lee columnHeaders y rows. viewerPercentage cubre solo a los espectadores que estaban conectados. Cuando no hay datos, YouTube omite rows. Reporta eso como "no disponible", nunca como cero.
8. Mantén el token solo en memoria. Después, revócalo: el propietario puede hacerlo en myaccount.google.com/permissions. Los tokens de actualización de una aplicación en Pruebas también caducan después de 7 días.

Ruta 3: una estimación paga (Influencers Club MCP)

Influencers Club estima la demografía de la audiencia para canales públicos de YouTube. Es un modelo de terceros, no datos de YouTube. Cada consulta gasta créditos.

1. Ejecuta check_credits (gratis) y anota el saldo.
2. Informa al humano sobre la herramienta y su costo, luego espera un sí. Costos del README del servidor, verificado el 5 de noviembre de 2026: enrich_by_handle_analytics cuesta 0.8 créditos y devuelve datos demográficos de la audiencia. enrich_by_handle cuesta 1 crédito; en servidores más antiguos, pasa include_audience_data como verdadero para la sección de audiencia. enrich_by_handle_raw cuesta 0.03 créditos y no tiene datos de audiencia. Lee primero la descripción propia de la herramienta, porque las versiones difieren.
3. Realiza una llamada para el único canal, con platform configurado como youtube y handle configurado como el identificador o ID del canal.
4. Si alguna llamada devuelve un error de límite o crédito, detente. No reintentes e informa cuántas consultas se realizaron.
5. No uses get_audience_locations ni get_audience_interests para esto. Son listas gratuitas de valores de filtro, no la audiencia del creador.

Etiqueta el resultado como "estimado por Influencers Club", proporciona la fecha de la consulta y nunca lo mezcles con cifras del propietario sin indicar cuál es cuál.

Qué escribir en el informe

• La fuente de cada cifra: los análisis de YouTube del propietario con su rango de fechas, exportación de Studio del propietario o una estimación de un tercero.
• Las proporciones de edad y género para los espectadores conectados, y los principales países por visualizaciones.
• Si no hay consentimiento ni gasto aprobado, escribe "Datos demográficos de la audiencia: no disponibles sin los análisis del propietario o una estimación paga." Esa es una respuesta completa.

Verificado el 5 de noviembre de 2026 contra la referencia de la API de YouTube Analytics, las páginas de métricas y autorización, la Ayuda de YouTube sobre permisos de canal y el README y límites de uso de Influencers Club MCP.