Audience du créateur

Que fait Audience du créateur ?

YouTube ne publie pas de données démographiques sur l'audience. L'API Data utilisée par youtube-channel-profile n'en fournit pas. Il existe deux sources honnêtes : les analyses du propriétaire de la chaîne, partagées avec son consentement, ou une estimation payante d'un tiers que l'humain approuve. Tout le reste n'est que spéculation. Dites-le.

Règle du consentement

1. Les données du propriétaire viennent du propriétaire. Il choisit ce qu'il partage, pour quelles dates et à qui. Obtenez cela par écrit (un e-mail ou un message) avant de demander l'accès.
2. Le propriétaire se connecte avec son propre compte. Ne demandez jamais son mot de passe ou un code de connexion, et ne le saisissez jamais à sa place.
3. Une dépense nécessite un accord. Demandez à l'humain avant chaque recherche payante et indiquez son coût.
4. Ne déduisez jamais l'âge, le sexe ou la localisation à partir de noms, visages, voix, commentaires ou miniatures.
5. Conservez ces données uniquement pour la mission. Montrez-les uniquement au propriétaire et aux personnes qu'il a approuvées (politique YouTube III.E.3.b). Supprimez-les dans les 7 jours suivant une demande (III.E.4.g). Si vous les conservez, vérifiez à nouveau le consentement du propriétaire tous les 30 jours (III.E.4.b).

Voie 1 : le propriétaire partage depuis YouTube Studio (commencez ici)

Cela ne nécessite aucun travail d'API. Convient pour un brief ponctuel.

Option A, export : demandez au propriétaire d'ouvrir YouTube Studio, d'aller dans Analytics, puis l'onglet Audience. Il choisit une période (les 90 derniers jours est un bon défaut), puis partage une capture d'écran ou un export de l'âge, du sexe et des principaux pays.

Option B, accès en lecture seule : le propriétaire ouvre YouTube Studio, va dans Paramètres, puis Permissions, puis Inviter. Il saisit l'adresse e-mail Google de l'humain et choisit le rôle Viewer (Limited). Ce rôle permet de voir les analyses mais pas les revenus. Les invitations expirent après 30 jours. Une fois la mission terminée, le propriétaire supprime l'accès depuis le même écran. Les chaînes de type Brand Account doivent d'abord passer par les permissions de chaîne.

Voie 2 : l'API YouTube Analytics (tâches répétées ou plus vastes)

Utilisez cette voie lorsque le propriétaire, ou son équipe, exécutera la tâche, ou pour un engagement continu avec un consentement écrit.

1. Dans Google Cloud, créez un projet. Activez l'API YouTube Analytics et l'API YouTube Data v3.
2. Configurez l'écran de consentement OAuth : type d'utilisateur Externe, statut de publication Test. Ajoutez le compte Google du propriétaire comme utilisateur de test.
3. Créez un ID client OAuth de type Application de bureau et téléchargez le fichier client. Traitez-le comme un secret.
4. Demandez uniquement ces portées :
   • https://www.googleapis.com/auth/yt-analytics.readonly
   • https://www.googleapis.com/auth/youtube.readonly (la référence reports.query l'exige également désormais)
   • Ajoutez yt-analytics-monetary.readonly uniquement si le propriétaire accepte de partager les revenus.
5. Exécutez la connexion sur la machine où le propriétaire se connecte lui-même. Par exemple :

# 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. Le propriétaire choisit la bonne chaîne lorsque Google le demande. channel==MINE désigne la chaîne avec laquelle il s'est connecté.
7. Lisez columnHeaders et rows. viewerPercentage couvre uniquement les spectateurs connectés. Lorsqu'il n'y a pas de données, YouTube omet rows. Signalez cela comme « non disponible », jamais comme zéro.
8. Conservez le jeton uniquement en mémoire. Ensuite, révoquez-le : le propriétaire peut le faire sur myaccount.google.com/permissions. Les jetons d'actualisation d'une application en test expirent également après 7 jours.

Voie 3 : une estimation payante (Influencers Club MCP)

Influencers Club estime les données démographiques de l'audience pour les chaînes YouTube publiques. Il s'agit d'un modèle tiers, pas de données YouTube. Chaque recherche consomme des crédits.

1. Exécutez check_credits (gratuit) et notez le solde.
2. Informez l'humain de l'outil et de son coût, puis attendez un accord. Coûts d'après le README du serveur, vérifié le 5 novembre 2026 : enrich_by_handle_analytics coûte 0,8 crédit et renvoie les données démographiques de l'audience. enrich_by_handle coûte 1 crédit ; sur les serveurs plus anciens, passez include_audience_data à true pour la section audience. enrich_by_handle_raw coûte 0,03 crédit et ne contient pas de données d'audience. Lisez d'abord la description de l'outil lui-même, car les versions diffèrent.
3. Effectuez un seul appel pour une seule chaîne, avec platform défini sur youtube et handle défini sur le pseudonyme ou l'ID de la chaîne.
4. Si un appel renvoie une erreur de limite ou de crédit, arrêtez-vous. Ne réessayez pas et indiquez combien de recherches ont été effectuées.
5. N'utilisez pas get_audience_locations ou get_audience_interests pour cela. Ce sont des listes gratuites de valeurs de filtre, pas l'audience du créateur.

Étiquetez le résultat « estimé par Influencers Club », donnez la date de recherche et ne mélangez jamais ces données avec les chiffres du propriétaire sans préciser quelle est quelle source.

Que rédiger dans le brief

• La source de chaque chiffre : les analyses YouTube du propriétaire avec sa période, l'export Studio du propriétaire, ou une estimation tiers.
• Les parts d'âge et de sexe pour les spectateurs connectés, et les principaux pays par vues.
• S'il n'y a ni consentement ni dépense approuvée, écrivez « Données démographiques de l'audience : non disponibles sans les analyses du propriétaire ou une estimation payante. » C'est une réponse complète.

Vérifié le 5 novembre 2026 par rapport à la référence de l'API YouTube Analytics, aux pages de métriques et d'autorisation, à l'aide YouTube sur les permissions de chaîne, et au README et aux limites d'utilisation de l'Influencers Club MCP.