> ## Documentation Index > Fetch the complete documentation index at: https://docs.athenahq.ai/llms.txt > Use this file to discover all available pages before exploring further. # Lister les créateurs YouTube > Liste les chaînes YouTube citées dans les réponses d’IA pour un site web, classées par nombre de citations (la chaîne inconnue apparaît en dernier). Comprend la part des citations de chaque chaîne, les répartitions par catégorie et durée des vidéos, et la disponibilité des métadonnées. Les totaux et répartitions portent sur l’ensemble des résultats filtrés, indépendamment de la pagination. Utilisez get_youtube_videos avec channel_key pour lister les vidéos d’un créateur. Les métadonnées enregistrées sont lues ; les informations en attente ou manquantes restent à null. Les dates correspondent à des jours UTC, bornes incluses. Les nombres portent sur les citations dans les réponses d’IA suivies par Athena, et non sur les vues YouTube ou les statistiques d’abonnés. Les métadonnées sont lues dans le cache enregistré d’Athena et peuvent être indisponibles. La part d’une chaîne se calcule sur toutes les citations YouTube, y compris les liens qui ne sont pas des vidéos ; les parts par catégorie et durée se calculent sur les citations de vidéos. Le champ citation_percentage d’une vidéo est le pourcentage de réponses d’IA distinctes répondant aux filtres qui citent cette vidéo. first_seen se situe dans la plage de dates sélectionnée. La répartition complète, avec les métriques de citations et les métadonnées enregistrées, est mise en cache pendant cinq minutes au maximum. ## OpenAPI ````yaml fr/api-reference/openapi.json post /api/v1/sources/youtube-creators openapi: 3.1.0 info: title: API AthenaHQ description: >- L’API AthenaHQ permet de gérer vos sites et prompts par programme pour l’optimisation de contenu par IA. version: 1.0.0 contact: email: support@athenahq.ai servers: - url: https://api.athenahq.ai description: Serveur de production security: - apiKey: [] tags: - name: Basics description: Opérations API principales pour gérer sites et prompts - name: Metrics description: Points de terminaison de métriques et analyses de visibilité IA - name: Billing description: Points de facturation et crédits pour gérer la consommation - name: Team Management description: Points de terminaison de gestion des membres et invitations - name: Groups description: Points de terminaison de gestion des groupes de sites - name: Content description: >- Points de terminaison Content Hub : onglets, URL suivies et détail des prompts par URL. - name: Pitch Workspace description: >- Points de terminaison des rapports Pitch Workspace : exécutions à l’échelle de l’organisation avec concurrents, prompts, attributs et métriques agrégées. - name: Knowledge Base description: >- Endpoints de lecture de la base de connaissances de la marque — faits approuvés et piliers qui les organisent. paths: /api/v1/sources/youtube-creators: post: tags: - Sources summary: Lister les créateurs YouTube description: >- Liste les chaînes YouTube citées dans les réponses d’IA pour un site web, classées par nombre de citations (la chaîne inconnue apparaît en dernier). Comprend la part des citations de chaque chaîne, les répartitions par catégorie et durée des vidéos, et la disponibilité des métadonnées. Les totaux et répartitions portent sur l’ensemble des résultats filtrés, indépendamment de la pagination. Utilisez get_youtube_videos avec channel_key pour lister les vidéos d’un créateur. Les métadonnées enregistrées sont lues ; les informations en attente ou manquantes restent à null. Les dates correspondent à des jours UTC, bornes incluses. Les nombres portent sur les citations dans les réponses d’IA suivies par Athena, et non sur les vues YouTube ou les statistiques d’abonnés. Les métadonnées sont lues dans le cache enregistré d’Athena et peuvent être indisponibles. La part d’une chaîne se calcule sur toutes les citations YouTube, y compris les liens qui ne sont pas des vidéos ; les parts par catégorie et durée se calculent sur les citations de vidéos. Le champ citation_percentage d’une vidéo est le pourcentage de réponses d’IA distinctes répondant aux filtres qui citent cette vidéo. first_seen se situe dans la plage de dates sélectionnée. La répartition complète, avec les métriques de citations et les métadonnées enregistrées, est mise en cache pendant cinq minutes au maximum. operationId: sources.youtubeCreators requestBody: required: true content: application/json: schema: type: object properties: website_id: type: string format: uuid pattern: >- ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$ filters: type: object properties: start_date: type: string format: date pattern: >- ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))$ description: Premier jour, YYYY-MM-DD, inclus (UTC). schedule_id: description: >- Une planification : "default" ou l’UUID d’une planification personnalisée ou archivée. Omettez ce champ pour utiliser Default, qui inclut tout l’historique antérieur à la transition et les exécutions ponctuelles. L’ancienne valeur "manual" est acceptée comme alias de "default". Les planifications ne peuvent pas être combinées. anyOf: - type: string enum: - default - manual - type: string format: uuid pattern: >- ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$ end_date: description: >- Dernier jour, YYYY-MM-DD, inclus (UTC). Aujourd’hui par défaut. type: string format: date pattern: >- ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))$ models: description: >- Modèles d’IA à inclure, sous forme de tableau même pour un seul modèle, par exemple ["chatgpt", "perplexity"]. Omettez ce champ pour inclure tous les modèles. type: array items: type: string enum: - chatgpt - perplexity - gemini - google_ai_overview - copilot - claude - ai_mode - grok - deepseek - meta_ai - mistral prompt_ids: description: >- UUID des prompts à sélectionner, sous forme de tableau même pour un seul id. Omettez ce champ pour inclure tous les prompts. type: array items: type: string format: uuid pattern: >- ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$ location_ids: description: >- UUID des localisations à sélectionner, sous forme de tableau même pour un seul id. La chaîne littérale "no-location" sélectionne les réponses exécutées sans localisation. Omettez ce champ pour inclure toutes les localisations. type: array items: anyOf: - type: string format: uuid pattern: >- ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$ - type: string const: no-location persona_ids: description: >- UUID des personas à sélectionner, sous forme de tableau même pour un seul id. Omettez ce champ pour inclure tous les personas. type: array items: type: string format: uuid pattern: >- ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$ target_identifiers: description: >- Chaînes d’identifiants cibles à sélectionner, sous forme de tableau même pour une seule valeur. La chaîne littérale "no-identifier" sélectionne les réponses sans identifiant cible. Omettez ce champ pour tout inclure. type: array items: anyOf: - type: string - type: string const: no-identifier variation_filter: description: >- Lignes de prompts à inclure, sous forme de tableau : "prompt" pour les prompts de base, "variation" pour les variations générées, ou les deux. Omettez ce champ pour inclure les deux. type: array items: type: string enum: - variation - prompt prompt_tags: description: >- UUID des étiquettes de prompts provenant de get_prompt_tags. type: array items: type: string format: uuid pattern: >- ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$ prompt_tags_operator: description: >- Combinaison des prompt_tags : "is_any_of" sélectionne les prompts portant au moins une des étiquettes indiquées ; "has_all_of", uniquement ceux portant toutes les étiquettes indiquées. type: string enum: - is_any_of - has_all_of prompt_status: description: >- Filtrez les prompts selon leur état de suivi : "active" ou "paused". Omettez ce champ pour inclure les deux. type: string enum: - active - paused prompt_type: description: >- Filtrez les prompts selon leur type : "branded" (mentionne la marque) ou "non_branded". Omettez ce champ pour inclure les deux. type: string enum: - branded - non_branded required: - start_date additionalProperties: false page_num: default: 0 description: Numéro de page à partir de zéro. type: integer minimum: 0 maximum: 1000000 page_size: type: integer minimum: 1 maximum: 100 default: 30 required: - website_id - filters example: website_id: 123e4567-e89b-42d3-a456-426614174000 filters: start_date: '2026-10-01' end_date: '2026-10-31' page_num: 0 page_size: 30 responses: '200': description: Réussite content: application/json: schema: type: object properties: creators: type: array items: type: object properties: channel_key: type: string description: >- Clé de groupe stable ; utilisez-la comme channel_key dans get_youtube_videos. channel_id: type: - string - 'null' name: type: - string - 'null' handle: type: - string - 'null' url: type: - string - 'null' thumbnail_url: type: - string - 'null' citations: type: number share_percent: type: number video_count: type: integer minimum: -9007199254740991 maximum: 9007199254740991 main_category_id: anyOf: - type: integer minimum: -9007199254740991 maximum: 9007199254740991 - type: 'null' avg_duration_seconds: type: - number - 'null' required: - channel_key - channel_id - name - handle - url - thumbnail_url - citations - share_percent - video_count - main_category_id - avg_duration_seconds additionalProperties: false pagination: type: object properties: page_num: type: integer minimum: -9007199254740991 maximum: 9007199254740991 page_size: type: integer minimum: -9007199254740991 maximum: 9007199254740991 total: type: integer minimum: -9007199254740991 maximum: 9007199254740991 required: - page_num - page_size - total additionalProperties: false categories: type: array items: type: object properties: category_id: anyOf: - type: integer minimum: -9007199254740991 maximum: 9007199254740991 - type: 'null' citations: type: number share_percent: type: number videos: type: integer minimum: -9007199254740991 maximum: 9007199254740991 required: - category_id - citations - share_percent - videos additionalProperties: false length_buckets: type: array items: type: object properties: id: type: string enum: - under-1 - 1-5 - 5-15 - 15-30 - 30-60 - 60-plus citations: type: number share_percent: type: number videos: type: integer minimum: -9007199254740991 maximum: 9007199254740991 required: - id - citations - share_percent - videos additionalProperties: false totals: type: object properties: citations: type: number video_citations: type: number non_video_citations: type: number videos: type: integer minimum: -9007199254740991 maximum: 9007199254740991 channels: type: integer minimum: -9007199254740991 maximum: 9007199254740991 top_ten_channel_share_percent: type: number median_duration_seconds: type: - number - 'null' pending: type: object properties: videos: type: integer minimum: -9007199254740991 maximum: 9007199254740991 citations: type: number required: - videos - citations additionalProperties: false missing: type: object properties: videos: type: integer minimum: -9007199254740991 maximum: 9007199254740991 citations: type: number required: - videos - citations additionalProperties: false required: - citations - video_citations - non_video_citations - videos - channels - top_ten_channel_share_percent - median_duration_seconds - pending - missing additionalProperties: false notice: type: string required: - creators - pagination - categories - length_buckets - totals additionalProperties: false '400': description: Requête incorrecte — échec de validation content: application/json: schema: type: object properties: error: type: string required: - error '401': description: Non authentifié content: application/json: schema: type: object properties: error: type: string required: - error '403': description: Interdit content: application/json: schema: type: object properties: error: type: string required: - error '404': description: Introuvable content: application/json: schema: type: object properties: error: type: string required: - error '409': description: Conflit content: application/json: schema: type: object properties: error: type: string required: - error '429': description: Limite de débit atteinte content: application/json: schema: type: object properties: error: type: string required: - error '500': description: Erreur interne content: application/json: schema: type: object properties: error: type: string required: - error security: - apiKey: [] components: securitySchemes: apiKey: type: apiKey in: header name: x-api-key description: >- Clé API d’authentification. Créez-en une [ici](https://app.athenahq.ai/organization?tab=api). ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.