> ## 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. # List YouTube Creators > List YouTube channels cited in AI answers for a website, ordered by citations (unknown channel last). Includes channel citation shares, category and video-length breakdowns, and metadata availability. Totals and breakdowns cover the full filtered result, independent of pagination. Use get_youtube_videos with channel_key to list a creator's videos. Reads saved metadata; pending or missing details remain null. Dates are inclusive UTC days. Counts cover citations in Athena-tracked AI answers, not YouTube views or subscriber analytics. Metadata is read from Athena’s saved cache and may be unavailable. Channel share uses all YouTube citations, including non-video links; category and length shares use video citations. Video citation_percentage is the percentage of distinct filtered AI responses citing that video. first_seen is within the selected date range. The completed breakdown, including citation metrics and saved metadata, is cached for up to five minutes. ## OpenAPI ````yaml /api-reference/openapi.json post /api/v1/sources/youtube-creators openapi: 3.1.0 info: title: AthenaHQ API description: >- AthenaHQ API provides programmatic access to manage your websites and prompts for AI-powered content optimization. version: 1.0.0 contact: email: support@athenahq.ai servers: - url: https://api.athenahq.ai description: Production server security: - apiKey: [] tags: - name: Basics description: Core API operations for managing websites and prompts - name: Metrics description: Metrics and analytics endpoints for tracking AI visibility - name: Billing description: Billing and credits endpoints for managing usage - name: Team Management description: Endpoints for managing team members and invitations - name: Groups description: Endpoints for managing groups of websites - name: Content description: >- Endpoints for accessing Content Hub data — tabs, tracked URLs, and per-URL prompt breakdowns. - name: Pitch Workspace description: >- Endpoints for accessing pitch workspace reports — org-scoped pitch runs with competitors, prompts, attributes, and aggregate metrics. - name: Knowledge Base description: >- Endpoints for reading the brand Knowledge Base — approved brand facts and the pillars that organize them. paths: /api/v1/sources/youtube-creators: post: tags: - Sources summary: List YouTube Creators description: >- List YouTube channels cited in AI answers for a website, ordered by citations (unknown channel last). Includes channel citation shares, category and video-length breakdowns, and metadata availability. Totals and breakdowns cover the full filtered result, independent of pagination. Use get_youtube_videos with channel_key to list a creator's videos. Reads saved metadata; pending or missing details remain null. Dates are inclusive UTC days. Counts cover citations in Athena-tracked AI answers, not YouTube views or subscriber analytics. Metadata is read from Athena’s saved cache and may be unavailable. Channel share uses all YouTube citations, including non-video links; category and length shares use video citations. Video citation_percentage is the percentage of distinct filtered AI responses citing that video. first_seen is within the selected date range. The completed breakdown, including citation metrics and saved metadata, is cached for up to five minutes. 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: First day, YYYY-MM-DD, inclusive (UTC). schedule_id: description: >- One schedule: "default" or a custom/archived schedule UUID. Omit for Default, which includes all pre-cutover history and ad hoc runs. The retired "manual" token is accepted as an alias of "default". Schedules cannot be combined. 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: >- Last day, YYYY-MM-DD, inclusive (UTC). Defaults to today. 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: >- AI models to include, as an array even for one model — e.g. ["chatgpt", "perplexity"]. Omit to include all models. type: array items: type: string enum: - chatgpt - perplexity - gemini - google_ai_overview - copilot - claude - ai_mode - grok - deepseek - meta_ai - mistral prompt_ids: description: >- Prompt UUIDs to filter to, as an array even for one id. Omit for all 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: >- Location UUIDs to filter to, as an array even for one id. The literal string "no-location" selects responses that ran without a location. Omit for all locations. 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: >- Persona UUIDs to filter to, as an array even for one id. Omit for all 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: >- Target identifier strings to filter to, as an array even for one value. The literal string "no-identifier" selects responses with no target identifier. Omit for all. type: array items: anyOf: - type: string - type: string const: no-identifier variation_filter: description: >- Which prompt rows to include, as an array: "prompt" for base prompts, "variation" for generated variations, or both. Omit for both. type: array items: type: string enum: - variation - prompt prompt_tags: description: Prompt tag UUIDs from 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: >- How prompt_tags combine: "is_any_of" matches prompts with any listed tag, "has_all_of" only prompts carrying every listed tag. type: string enum: - is_any_of - has_all_of prompt_status: description: >- Filter prompts by tracking status: "active" or "paused". Omit for both. type: string enum: - active - paused prompt_type: description: >- Filter prompts by type: "branded" (mentions the brand) or "non_branded". Omit for both. type: string enum: - branded - non_branded required: - start_date additionalProperties: false page_num: default: 0 description: Zero-based page number. 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: Success content: application/json: schema: type: object properties: creators: type: array items: type: object properties: channel_key: type: string description: >- Stable group key; use as channel_key in 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: Bad Request — validation failed content: application/json: schema: type: object properties: error: type: string required: - error '401': description: Unauthenticated content: application/json: schema: type: object properties: error: type: string required: - error '403': description: Forbidden content: application/json: schema: type: object properties: error: type: string required: - error '404': description: Not Found content: application/json: schema: type: object properties: error: type: string required: - error '409': description: Conflict content: application/json: schema: type: object properties: error: type: string required: - error '429': description: Rate Limited content: application/json: schema: type: object properties: error: type: string required: - error '500': description: Internal Error 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: >- API key for authentication. You can create one [here](https://app.athenahq.ai/organization?tab=api). ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.