List YouTube videos cited in AI answers for a website, ordered by citation count. Returns saved titles, channel details, categories, durations, publication dates, citation counts, distinct-response citation percentages and linked timestamps. Watch, Shorts and short-link variants of one video are combined. Filter by channel_key or video_id. Metadata may be pending or missing; no live YouTube fetch is performed. 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. The moments array contains seconds from the top 100 cited URL variants per video; it is not an exhaustive timestamp list or a transcript. channel_key and video_id narrow returned videos without changing the response denominator.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"AthenaHQ","colors":{"primary":"#4f39f6","light":"#7c86ff","dark":"#4f39f6"},"logo":{"light":"https://mintcdn.com/athenahq/L9mnbtCFYX94d6KY/logo/ahq_logo.svg?fit=max\u0026auto=format\u0026n=L9mnbtCFYX94d6KY\u0026q=85\u0026s=e929a8fbe48ea55a88a26164326a1b68","dark":"https://mintcdn.com/athenahq/L9mnbtCFYX94d6KY/logo/ahq_logo.svg?fit=max\u0026auto=format\u0026n=L9mnbtCFYX94d6KY\u0026q=85\u0026s=e929a8fbe48ea55a88a26164326a1b68"},"favicon":"https://mintcdn.com/athenahq/l-RALGQGlLg9vCM3/favicon.ico?fit=max\u0026auto=format\u0026n=l-RALGQGlLg9vCM3\u0026q=85\u0026s=902f75ca9d61dedcf06910b630c2349b","navbar":{"links":[{"href":"mailto:support@athenahq.ai","label":"Support"}],"primary":{"type":"button","label":"Dashboard","href":"https://app.athenahq.ai/settings/api"}},"footer":{"socials":{"website":"https://athenahq.ai","linkedin":"https://linkedin.com/company/athena-hq"}},"contextual":{"options":["copy","chatgpt","claude","perplexity"],"display":"header"},"styling":{"latex":false},"navigation":{"languages":[{"language":"en","default":true,"href":"getting-started/setup"},{"language":"es","default":false,"navbar":{"links":[{"href":"mailto:support@athenahq.ai","label":"Soporte"}],"primary":{"type":"button","label":"Panel","href":"https://app.athenahq.ai/settings/api"}},"href":"es/getting-started/setup"},{"language":"fr","default":false,"navbar":{"links":[{"href":"mailto:support@athenahq.ai","label":"Assistance"}],"primary":{"type":"button","label":"Tableau de bord","href":"https://app.athenahq.ai/settings/api"}},"href":"fr/getting-started/setup"}]}},"deployment":{"deploymentMetadataValue":{"subdomain":"athenahq","hasAudioNarration":false,"actualSubdomain":"athenahq","customDomains":["docs.athenahq.ai"],"gitSource":{"type":"github","owner":"ay-ay-ay-ay","repo":"athenahq","deployBranch":"main","contentDirectory":"docs-api","isPrivate":true,"mountPath":"","label":""},"chroma":{"liveDeploymentHistoryId":"6aecc7d69039348ead066fb2","collectionId":"79feed97-62a5-453b-8105-831ce6683497","schemaVersion":"v3","latestBuiltDeploymentHistoryId":"6aecc7d69039348ead066fb2"},"feedback":{"thumbs":true},"entitlements":{},"buildId":"6aed801cb562a03cbf6b988b","clientVersion":"0.0.4074","searchFilterCounts":[{"language":"en","tag":"API Reference","count":134},{"language":"es","tag":"Referencia de la API","count":134},{"language":"fr","tag":"Référence de l’API","count":134},{"language":"en","tag":"Documentation","count":57},{"language":"es","tag":"Documentación","count":57},{"language":"fr","tag":"Documentation","count":57},{"language":"en","tag":"Page Reference","count":49},{"language":"es","tag":"Referencia de páginas","count":49},{"language":"fr","tag":"Référence des pages","count":49},{"language":"en","tag":"Content \u0026 Knowledge","count":43},{"language":"es","tag":"Contenido y conocimiento","count":43},{"language":"fr","tag":"Contenu et connaissances","count":43},{"language":"en","tag":"Core Resources","count":34},{"language":"es","tag":"Recursos principales","count":34},{"language":"fr","tag":"Ressources principales","count":34},{"language":"en","tag":"Administration","count":32},{"language":"es","tag":"Administración","count":32},{"language":"fr","tag":"Administration","count":32},{"language":"en","tag":"Content Hub","count":19},{"language":"es","tag":"Centro de contenido","count":19},{"language":"fr","tag":"Content Hub","count":19},{"language":"en","tag":"Analytics","count":16},{"language":"es","tag":"Analítica","count":16},{"language":"fr","tag":"Analyses","count":16},{"language":"en","tag":"Knowledge Base","count":15},{"language":"es","tag":"Base de conocimientos","count":15},{"language":"fr","tag":"Base de connaissances","count":15},{"language":"en","tag":"Members","count":12},{"language":"es","tag":"Miembros","count":12},{"language":"fr","tag":"Membres","count":12}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"vite-origin","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"comment-mode","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"api-reference/sources/list-youtube-videos","slug":"/api-reference/sources/list-youtube-videos","pageMetadata":{"title":"List YouTube Videos","description":"List YouTube videos cited in AI answers for a website, ordered by citation count. Returns saved titles, channel details, categories, durations, publication dates, citation counts, distinct-response citation percentages and linked timestamps. Watch, Shorts and short-link variants of one video are combined. Filter by channel_key or video_id. Metadata may be pending or missing; no live YouTube fetch is performed. 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. The moments array contains seconds from the top 100 cited URL variants per video; it is not an exhaustive timestamp list or a transcript. channel_key and video_id narrow returned videos without changing the response denominator.","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /api/v1/sources/youtube-videos","href":"/api-reference/sources/list-youtube-videos","autogeneratedByOpenApi":true},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"List YouTube videos cited in AI answers for a website, ordered by citation count. Returns saved titles, channel details, categories, durations, publication dates, citation counts, distinct-response citation percentages and linked timestamps. Watch, Shorts and short-link variants of one video are combined. Filter by channel_key or video_id. Metadata may be pending or missing; no live YouTube fetch is performed. 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. The moments array contains seconds from the top 100 cited URL variants per video; it is not an exhaustive timestamp list or a transcript. channel_key and video_id narrow returned videos without changing the response denominator.\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){return _jsx(_Fragment,{})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"List YouTube Videos","description":"List YouTube videos cited in AI answers for a website, ordered by citation count. Returns saved titles, channel details, categories, durations, publication dates, citation counts, distinct-response citation percentages and linked timestamps. Watch, Shorts and short-link variants of one video are combined. Filter by channel_key or video_id. Metadata may be pending or missing; no live YouTube fetch is performed. 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. The moments array contains seconds from the top 100 cited URL variants per video; it is not an exhaustive timestamp list or a transcript. channel_key and video_id narrow returned videos without changing the response denominator.","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /api/v1/sources/youtube-videos","href":"/api-reference/sources/list-youtube-videos","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"operationId":"sources.youtubeVideos","summary":"List YouTube Videos","description":"List YouTube videos cited in AI answers for a website, ordered by citation count. Returns saved titles, channel details, categories, durations, publication dates, citation counts, distinct-response citation percentages and linked timestamps. Watch, Shorts and short-link variants of one video are combined. Filter by channel_key or video_id. Metadata may be pending or missing; no live YouTube fetch is performed. 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. The moments array contains seconds from the top 100 cited URL variants per video; it is not an exhaustive timestamp list or a transcript. channel_key and video_id narrow returned videos without changing the response denominator.","responses":{"200":"eeff0646-7548-41cd-a142-4ddc93f195c1","400":"a5e09155-37c2-4e16-8a93-49e403acc447","401":"5e6b6280-e2ff-4dfe-9088-e7bb263e3acc","403":"cc11bcef-801b-44e6-8ff5-c4ecc6edaf83","404":"559a319c-9de6-46d0-aea8-f1fc1c6fe72e","409":"91aab4e3-e693-49e2-8e59-1ffb24131cc1","429":"42d29823-067f-4c02-8d6b-5c55ad642595","500":"6e73bc48-a649-45e1-878e-66848fac49ab"},"requestBody":"42d41d6b-2ba3-4e32-9684-992d4dd47c17","tags":["Sources"],"security":["ab31c7b7-0595-432c-b6a3-71b625650e95"],"method":"post","type":"path","servers":["90885314-6248-4e0c-9577-887220ce4051"],"path":"/api/v1/sources/youtube-videos","baseUrlOptions":["https://api.athenahq.ai"],"title":"List YouTube Videos","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{},"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)$","isRequired":true,"uniqueKey":"website_id","typeLabel":"string\u003cuuid>"},"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).","isRequired":true,"uniqueKey":"filters.start_date","typeLabel":"string\u003cdate>"},"schedule_id":{"oneOf":[{"type":"string","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.","enum":["default","manual"],"uniqueKey":"filters.schedule_id.oneOf.0","typeLabel":"enum\u003cstring>"},{"type":"string","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.","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)$","uniqueKey":"filters.schedule_id.oneOf.1","typeLabel":"string\u003cuuid>"}],"uniqueKey":"filters.schedule_id","typeLabel":"enum\u003cstring> | string\u003cuuid>"},"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])))$","uniqueKey":"filters.end_date","typeLabel":"string\u003cdate>"},"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"],"uniqueKey":"filters.models.items.[INDEX]","typeLabel":"enum\u003cstring>"},"uniqueKey":"filters.models","typeLabel":"enum\u003cstring>[]"},"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)$","uniqueKey":"filters.prompt_ids.items.[INDEX]","typeLabel":"string\u003cuuid>"},"uniqueKey":"filters.prompt_ids","typeLabel":"string\u003cuuid>[]"},"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":{"oneOf":[{"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)$","uniqueKey":"filters.location_ids.items.[INDEX].oneOf.0","typeLabel":"string\u003cuuid>"},{"type":"string","const":"no-location","uniqueKey":"filters.location_ids.items.[INDEX].oneOf.1","typeLabel":"string"}],"uniqueKey":"filters.location_ids.items.[INDEX]","typeLabel":"string\u003cuuid> | string"},"uniqueKey":"filters.location_ids","typeLabel":"(string\u003cuuid> | string)[]"},"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)$","uniqueKey":"filters.persona_ids.items.[INDEX]","typeLabel":"string\u003cuuid>"},"uniqueKey":"filters.persona_ids","typeLabel":"string\u003cuuid>[]"},"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":{"oneOf":[{"type":"string","uniqueKey":"filters.target_identifiers.items.[INDEX].oneOf.0","typeLabel":"string"},{"type":"string","const":"no-identifier","uniqueKey":"filters.target_identifiers.items.[INDEX].oneOf.1","typeLabel":"string"}],"uniqueKey":"filters.target_identifiers.items.[INDEX]","typeLabel":"string"},"uniqueKey":"filters.target_identifiers","typeLabel":"string[]"},"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"],"uniqueKey":"filters.variation_filter.items.[INDEX]","typeLabel":"enum\u003cstring>"},"uniqueKey":"filters.variation_filter","typeLabel":"enum\u003cstring>[]"},"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)$","uniqueKey":"filters.prompt_tags.items.[INDEX]","typeLabel":"string\u003cuuid>"},"uniqueKey":"filters.prompt_tags","typeLabel":"string\u003cuuid>[]"},"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"],"uniqueKey":"filters.prompt_tags_operator","typeLabel":"enum\u003cstring>"},"prompt_status":{"description":"Filter prompts by tracking status: \"active\" or \"paused\". Omit for both.","type":"string","enum":["active","paused"],"uniqueKey":"filters.prompt_status","typeLabel":"enum\u003cstring>"},"prompt_type":{"description":"Filter prompts by type: \"branded\" (mentions the brand) or \"non_branded\". Omit for both.","type":"string","enum":["branded","non_branded"],"uniqueKey":"filters.prompt_type","typeLabel":"enum\u003cstring>"}},"required":["start_date"],"additionalProperties":false,"isRequired":true,"uniqueKey":"filters","typeLabel":"object"},"page_num":{"default":0,"description":"Zero-based page number.","type":"integer","minimum":0,"maximum":1000000,"uniqueKey":"page_num","typeLabel":"integer"},"page_size":{"type":"integer","minimum":1,"maximum":100,"default":30,"uniqueKey":"page_size","typeLabel":"integer"},"channel_key":{"description":"Channel group key from get_youtube_creators; omit for all creators.","type":"string","minLength":1,"maxLength":500,"uniqueKey":"channel_key","typeLabel":"string"},"video_id":{"description":"YouTube video ID; omit for all videos.","type":"string","pattern":"^[A-Za-z0-9_-]{11}$","uniqueKey":"video_id","typeLabel":"string"}},"required":["website_id","filters"],"uniqueKey":"","typeLabel":"object"},"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},"examples":{"Example":{"title":"Example","value":{"website_id":"123e4567-e89b-42d3-a456-426614174000","filters":{"start_date":"2026-10-01","end_date":"2026-10-31"},"page_num":0,"page_size":30}}},"exampleType":"examples"}},"exampleType":"examples"},"responses":{"eeff0646-7548-41cd-a142-4ddc93f195c1":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"videos":{"type":"array","items":{"type":"object","properties":{"video_id":{"type":"string","isRequired":true,"uniqueKey":"videos.items.[INDEX].video_id","typeLabel":"string"},"url":{"type":"string","isRequired":true,"uniqueKey":"videos.items.[INDEX].url","typeLabel":"string"},"title":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"videos.items.[INDEX].title.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"videos.items.[INDEX].title.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"videos.items.[INDEX].title","typeLabel":"string | null"},"channel":{"type":"object","properties":{"channel_key":{"type":"string","description":"Stable group key; use as channel_key in get_youtube_videos.","isRequired":true,"uniqueKey":"videos.items.[INDEX].channel.channel_key","typeLabel":"string"},"channel_id":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"videos.items.[INDEX].channel.channel_id.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"videos.items.[INDEX].channel.channel_id.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"videos.items.[INDEX].channel.channel_id","typeLabel":"string | null"},"name":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"videos.items.[INDEX].channel.name.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"videos.items.[INDEX].channel.name.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"videos.items.[INDEX].channel.name","typeLabel":"string | null"},"handle":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"videos.items.[INDEX].channel.handle.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"videos.items.[INDEX].channel.handle.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"videos.items.[INDEX].channel.handle","typeLabel":"string | null"},"url":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"videos.items.[INDEX].channel.url.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"videos.items.[INDEX].channel.url.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"videos.items.[INDEX].channel.url","typeLabel":"string | null"},"thumbnail_url":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"videos.items.[INDEX].channel.thumbnail_url.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"videos.items.[INDEX].channel.thumbnail_url.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"videos.items.[INDEX].channel.thumbnail_url","typeLabel":"string | null"}},"required":["channel_key","channel_id","name","handle","url","thumbnail_url"],"additionalProperties":false,"isRequired":true,"uniqueKey":"videos.items.[INDEX].channel","typeLabel":"object"},"category_id":{"oneOf":[{"type":"integer","maximum":9007199254740991,"minimum":-9007199254740991,"isRequired":true,"uniqueKey":"videos.items.[INDEX].category_id.oneOf.0","typeLabel":"integer"},{"type":"null","isRequired":true,"uniqueKey":"videos.items.[INDEX].category_id.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"videos.items.[INDEX].category_id","typeLabel":"integer | null"},"duration_seconds":{"oneOf":[{"type":"integer","maximum":9007199254740991,"minimum":-9007199254740991,"isRequired":true,"uniqueKey":"videos.items.[INDEX].duration_seconds.oneOf.0","typeLabel":"integer"},{"type":"null","isRequired":true,"uniqueKey":"videos.items.[INDEX].duration_seconds.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"videos.items.[INDEX].duration_seconds","typeLabel":"integer | null"},"published_at":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"videos.items.[INDEX].published_at.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"videos.items.[INDEX].published_at.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"videos.items.[INDEX].published_at","typeLabel":"string | null"},"first_seen":{"type":"string","isRequired":true,"uniqueKey":"videos.items.[INDEX].first_seen","typeLabel":"string"},"citations":{"type":"number","isRequired":true,"uniqueKey":"videos.items.[INDEX].citations","typeLabel":"number"},"citation_percentage":{"type":"number","isRequired":true,"uniqueKey":"videos.items.[INDEX].citation_percentage","typeLabel":"number"},"details_status":{"type":"string","enum":["found","pending","missing"],"isRequired":true,"uniqueKey":"videos.items.[INDEX].details_status","typeLabel":"enum\u003cstring>"},"moments":{"type":"array","items":{"type":"integer","minimum":0,"maximum":9007199254740991,"uniqueKey":"videos.items.[INDEX].moments.items.[INDEX]","typeLabel":"integer"},"description":"Distinct linked timestamps in seconds, from the top 100 cited URL variants. This is a bounded list, not every timestamp or transcript.","isRequired":true,"uniqueKey":"videos.items.[INDEX].moments","typeLabel":"integer[]"}},"required":["video_id","url","title","channel","category_id","duration_seconds","published_at","first_seen","citations","citation_percentage","details_status","moments"],"additionalProperties":false,"uniqueKey":"videos.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"videos","typeLabel":"object[]"},"pagination":{"type":"object","properties":{"page_num":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991,"isRequired":true,"uniqueKey":"pagination.page_num","typeLabel":"integer"},"page_size":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991,"isRequired":true,"uniqueKey":"pagination.page_size","typeLabel":"integer"},"total":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991,"isRequired":true,"uniqueKey":"pagination.total","typeLabel":"integer"}},"required":["page_num","page_size","total"],"additionalProperties":false,"isRequired":true,"uniqueKey":"pagination","typeLabel":"object"},"notice":{"type":"string","uniqueKey":"notice","typeLabel":"string"}},"required":["videos","pagination"],"additionalProperties":false,"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"videos":[{"video_id":"\u003cstring>","url":"\u003cstring>","title":"\u003cstring>","channel":{"channel_key":"\u003cstring>","channel_id":"\u003cstring>","name":"\u003cstring>","handle":"\u003cstring>","url":"\u003cstring>","thumbnail_url":"\u003cstring>"},"category_id":0,"duration_seconds":0,"published_at":"\u003cstring>","first_seen":"\u003cstring>","citations":123,"citation_percentage":123,"details_status":"found","moments":[4503599627370495]}],"pagination":{"page_num":0,"page_size":0,"total":0},"notice":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"},"a5e09155-37c2-4e16-8a93-49e403acc447":{"description":"Bad Request — validation failed","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string","isRequired":true,"uniqueKey":"error","typeLabel":"string"}},"required":["error"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"},"5e6b6280-e2ff-4dfe-9088-e7bb263e3acc":{"description":"Unauthenticated","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string","isRequired":true,"uniqueKey":"error","typeLabel":"string"}},"required":["error"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"},"cc11bcef-801b-44e6-8ff5-c4ecc6edaf83":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string","isRequired":true,"uniqueKey":"error","typeLabel":"string"}},"required":["error"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"},"559a319c-9de6-46d0-aea8-f1fc1c6fe72e":{"description":"Not Found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string","isRequired":true,"uniqueKey":"error","typeLabel":"string"}},"required":["error"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"},"91aab4e3-e693-49e2-8e59-1ffb24131cc1":{"description":"Conflict","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string","isRequired":true,"uniqueKey":"error","typeLabel":"string"}},"required":["error"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"},"42d29823-067f-4c02-8d6b-5c55ad642595":{"description":"Rate Limited","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string","isRequired":true,"uniqueKey":"error","typeLabel":"string"}},"required":["error"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"},"6e73bc48-a649-45e1-878e-66848fac49ab":{"description":"Internal Error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string","isRequired":true,"uniqueKey":"error","typeLabel":"string"}},"required":["error"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"}},"security":{"ab31c7b7-0595-432c-b6a3-71b625650e95":{"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).","scopes":[],"schemeName":"apiKey"}}},"servers":{"90885314-6248-4e0c-9577-887220ce4051":{"url":"https://api.athenahq.ai","description":"Production server"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"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).","scopes":[],"schemeName":"apiKey"},"schema":{"title":"x-api-key","type":"string","description":"API key for authentication. You can create one [here](https://app.athenahq.ai/organization?tab=api).","isRequired":true,"typeLabel":"string","deprecated":false},"schemeName":"apiKey","name":"x-api-key"}],"title":"apiKey"}]},"originalFileLocation":"api-reference/openapi.json"},"subdomain":"athenahq","siteName":"AthenaHQ","title":"List YouTube Videos - AthenaHQ","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{"en":{"href":"/api-reference/sources/list-youtube-videos","matchLevel":0},"es":{"href":"/es/api-reference/sources/list-youtube-videos","matchLevel":1},"fr":{"href":"/fr/api-reference/sources/list-youtube-videos","matchLevel":1}}},"lastModified":"2026-11-06T07:22:17.905Z","originalFileLocation":"api-reference/sources/list-youtube-videos.mdx","locale":"en"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"List YouTube videos cited in AI answers for a website, ordered by citation count. Returns saved titles, channel details, categories, durations, publication dates, citation counts, distinct-response citation percentages and linked timestamps. Watch, Shorts and short-link variants of one video are combined. Filter by channel_key or video_id. Metadata may be pending or missing; no live YouTube fetch is performed. 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. The moments array contains seconds from the top 100 cited URL variants per video; it is not an exhaustive timestamp list or a transcript. channel_key and video_id narrow returned videos without changing the response denominator.\">\u003cmeta data-mint-head name=\"application-name\" content=\"AthenaHQ\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/athenahq/CgBKLUlhcFuNVwLc/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/athenahq/CgBKLUlhcFuNVwLc/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/athenahq/CgBKLUlhcFuNVwLc/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/athenahq/CgBKLUlhcFuNVwLc/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/athenahq/CgBKLUlhcFuNVwLc/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/athenahq/CgBKLUlhcFuNVwLc/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/athenahq/CgBKLUlhcFuNVwLc/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/athenahq/CgBKLUlhcFuNVwLc/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/athenahq/CgBKLUlhcFuNVwLc/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"List YouTube Videos - AthenaHQ\">\u003cmeta data-mint-head property=\"og:description\" content=\"List YouTube videos cited in AI answers for a website, ordered by citation count. Returns saved titles, channel details, categories, durations, publication dates, citation counts, distinct-response citation percentages and linked timestamps. Watch, Shorts and short-link variants of one video are combined. Filter by channel_key or video_id. Metadata may be pending or missing; no live YouTube fetch is performed. 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. The moments array contains seconds from the top 100 cited URL variants per video; it is not an exhaustive timestamp list or a transcript. channel_key and video_id narrow returned videos without changing the response denominator.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"AthenaHQ\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.athenahq.ai/api-reference/sources/list-youtube-videos\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://athenahq.mintlify.site/_mintlify/api/og/v2?division=Sources\u0026amp;title=List+YouTube+Videos\u0026amp;description=List+YouTube+videos+cited+in+AI+answers+for+a+website%2C+ordered+by+citation+count.+Returns+saved+titles%2C+channel+details%2C+categories%2C+durations%2C+publication+date\u0026amp;theme=0b3a918be6754723090d9161\u0026amp;signature=cca0a350ca9840ecac203aeaedea3efd2669e85615979de8e2696d7e83214452\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"List YouTube Videos - AthenaHQ\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"List YouTube videos cited in AI answers for a website, ordered by citation count. Returns saved titles, channel details, categories, durations, publication dates, citation counts, distinct-response citation percentages and linked timestamps. Watch, Shorts and short-link variants of one video are combined. Filter by channel_key or video_id. Metadata may be pending or missing; no live YouTube fetch is performed. 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. The moments array contains seconds from the top 100 cited URL variants per video; it is not an exhaustive timestamp list or a transcript. channel_key and video_id narrow returned videos without changing the response denominator.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://athenahq.mintlify.site/_mintlify/api/og/v2?division=Sources\u0026amp;title=List+YouTube+Videos\u0026amp;description=List+YouTube+videos+cited+in+AI+answers+for+a+website%2C+ordered+by+citation+count.+Returns+saved+titles%2C+channel+details%2C+categories%2C+durations%2C+publication+date\u0026amp;theme=0b3a918be6754723090d9161\u0026amp;signature=cca0a350ca9840ecac203aeaedea3efd2669e85615979de8e2696d7e83214452\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/athenahq/CgBKLUlhcFuNVwLc/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"AthenaHQ\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#4f39f6\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.athenahq.ai/api-reference/sources/list-youtube-videos\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/sources/list-youtube-videos.md\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"en\" href=\"https://docs.athenahq.ai/api-reference/sources/list-youtube-videos\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"es\" href=\"https://docs.athenahq.ai/es/api-reference/sources/list-youtube-videos\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"fr\" href=\"https://docs.athenahq.ai/fr/api-reference/sources/list-youtube-videos\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"x-default\" href=\"https://docs.athenahq.ai/api-reference/sources/list-youtube-videos\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.athenahq.ai/#organization\",\"name\":\"AthenaHQ\",\"url\":\"https://docs.athenahq.ai\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/athenahq/L9mnbtCFYX94d6KY/logo/ahq_logo.svg?fit=max\u0026auto=format\u0026n=L9mnbtCFYX94d6KY\u0026q=85\u0026s=e929a8fbe48ea55a88a26164326a1b68\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.athenahq.ai#website\",\"name\":\"AthenaHQ\",\"url\":\"https://docs.athenahq.ai\",\"publisher\":{\"@id\":\"https://docs.athenahq.ai/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.athenahq.ai/api-reference/sources/list-youtube-videos#webpage\",\"url\":\"https://docs.athenahq.ai/api-reference/sources/list-youtube-videos\",\"name\":\"List YouTube Videos\",\"description\":\"List YouTube videos cited in AI answers for a website, ordered by citation count. Returns saved titles, channel details, categories, durations, publication dates, citation counts, distinct-response citation percentages and linked timestamps. Watch, Shorts and short-link variants of one video are combined. Filter by channel_key or video_id. Metadata may be pending or missing; no live YouTube fetch is performed. 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. The moments array contains seconds from the top 100 cited URL variants per video; it is not an exhaustive timestamp list or a transcript. channel_key and video_id narrow returned videos without changing the response denominator.\",\"dateModified\":\"2026-11-06T07:22:17.905Z\",\"isPartOf\":{\"@id\":\"https://docs.athenahq.ai#website\"},\"breadcrumb\":{\"@id\":\"https://docs.athenahq.ai/api-reference/sources/list-youtube-videos#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.athenahq.ai/api-reference/sources/list-youtube-videos#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Content \u0026 Knowledge\",\"item\":\"https://docs.athenahq.ai/api-reference/content/list-content-hub-sheets\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Sources\",\"item\":\"https://docs.athenahq.ai/api-reference/sources/list-sources-by-root-domain\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"List YouTube Videos\",\"item\":\"https://docs.athenahq.ai/api-reference/sources/list-youtube-videos\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.athenahq.ai/api-reference/sources/list-youtube-videos#apireference\",\"headline\":\"List YouTube Videos\",\"name\":\"List YouTube Videos\",\"description\":\"List YouTube videos cited in AI answers for a website, ordered by citation count. Returns saved titles, channel details, categories, durations, publication dates, citation counts, distinct-response citation percentages and linked timestamps. Watch, Shorts and short-link variants of one video are combined. Filter by channel_key or video_id. Metadata may be pending or missing; no live YouTube fetch is performed. 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. The moments array contains seconds from the top 100 cited URL variants per video; it is not an exhaustive timestamp list or a transcript. channel_key and video_id narrow returned videos without changing the response denominator.\",\"url\":\"https://docs.athenahq.ai/api-reference/sources/list-youtube-videos\",\"mainEntityOfPage\":{\"@id\":\"https://docs.athenahq.ai/api-reference/sources/list-youtube-videos#webpage\"},\"dateModified\":\"2026-11-06T07:22:17.905Z\",\"publisher\":{\"@id\":\"https://docs.athenahq.ai/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.athenahq.ai#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"AthenaHQ\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"AthenaHQ","nav":{"global":null,"languages":[{"language":"en","default":true,"tabs":[{"tab":"Documentation","icon":"book-open","pages":[{"title":"Documentation","href":"/getting-started/setup"}]},{"tab":"API Reference","icon":"code","groups":[{"group":"Overview","pages":[{"title":"Introduction","icon":"book","href":"/api-reference/introduction"},{"title":"Authentication","icon":"key","href":"/api-reference/authentication"},{"title":"Single Sign-On (SSO)","icon":"lock","href":"/api-reference/sso"},{"title":"Rate Limits","icon":"gauge","href":"/api-reference/rate-limits"},{"title":"Changelog","icon":"clock-rotate-left","href":"/api-reference/changelog"}]},{"group":"Integrations","pages":[{"title":"MCP Server","icon":"plug","href":"/api-reference/mcp"},{"title":"Looker Studio","icon":"chart-line","href":"/api-reference/looker-studio"},{"title":"Power BI \u0026 Microsoft Fabric","icon":"chart-column","href":"/api-reference/powerbi-fabric"},{"title":"Saved view exports","icon":"file-export","href":"/api-reference/saved-view-exports"}]},{"group":"Core Resources","pages":[{"group":"Utilities","pages":[{"title":"Validate API Key","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/validate-api-key","href":"/api-reference/basics/validate-api-key"},{"title":"Get Date Range","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/v1/date-range","href":"/api-reference/basics/get-date-range"},{"title":"Query Looker Studio report data","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /api/v1/looker-studio/data","href":"/api-reference/analytics/query-looker-studio-report-data"}]},{"group":"Websites","pages":[{"title":"Get Websites","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/v1/websites","href":"/api-reference/basics/get-websites"},{"title":"Create Website","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /api/v1/websites","href":"/api-reference/basics/create-website"},{"title":"Provision Website","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /api/v1/websites/provision","href":"/api-reference/basics/provision-website"},{"title":"Update Website","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json patch /api/v1/websites/{website_id}","href":"/api-reference/basics/update-website"},{"title":"Delete Website","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /api/v1/websites/{website_id}/delete","href":"/api-reference/basics/delete-website"},{"title":"Restore Website","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /api/v1/websites/{website_id}/restore","href":"/api-reference/basics/restore-website"}]},{"group":"Prompts","pages":[{"title":"Get Prompts","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/v1/prompts","href":"/api-reference/basics/get-prompts"},{"title":"Create Prompts","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /api/v1/prompts","href":"/api-reference/basics/create-prompts"},{"title":"Update Prompt","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json patch /api/v1/prompts/{prompt_id}","href":"/api-reference/basics/update-prompt"},{"title":"Pause or Unpause Prompts","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json patch /api/v1/prompts/status","href":"/api-reference/basics/pause-or-unpause-prompts"},{"title":"Delete Prompt","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json delete /api/v1/prompts/{prompt_id}","href":"/api-reference/basics/delete-prompt"},{"title":"Get Prompt Tags","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/v1/prompt-tags","href":"/api-reference/basics/get-prompt-tags"},{"title":"List prompt schedules","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/v1/prompt-schedules","href":"/api-reference/basics/list-prompt-schedules"}]},{"group":"API Keys","pages":[{"title":"List API Keys","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/v1/api-keys","href":"/api-reference/basics/list-api-keys"}]},{"group":"Activity","pages":[{"title":"List Activity","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/v1/activity","href":"/api-reference/basics/list-activity"}]},{"group":"Topics","pages":[{"title":"Get Topics","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/v1/topics","href":"/api-reference/basics/get-topics"},{"title":"Create Topic","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /api/v1/topics","href":"/api-reference/basics/create-topic"},{"title":"Update Topic","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json patch /api/v1/topics/{topic_id}","href":"/api-reference/basics/update-topic"},{"title":"Delete Topic","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json delete /api/v1/topics/{topic_id}","href":"/api-reference/basics/delete-topic"}]},{"group":"Personas \u0026 Competitors","pages":[{"title":"Get Personas","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/v1/personas","href":"/api-reference/basics/get-personas"},{"title":"Get Competitors","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/v1/competitors","href":"/api-reference/basics/get-competitors"},{"title":"Get Identifiers","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/v1/identifiers","href":"/api-reference/basics/get-identifiers"}]},{"group":"Locations","pages":[{"title":"Get Locations","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/v1/locations","href":"/api-reference/basics/get-locations"},{"title":"Create Location","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /api/v1/locations","href":"/api-reference/basics/create-location"},{"title":"Update Location","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json patch /api/v1/locations/{location_id}","href":"/api-reference/basics/update-location"},{"title":"Delete Location","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json delete /api/v1/locations/{location_id}","href":"/api-reference/basics/delete-location"}]},{"group":"Responses","pages":[{"title":"Query Responses","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /api/v1/responses","href":"/api-reference/basics/query-responses"},{"title":"Start Response Streaming","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /api/v1/response-streaming/start","href":"/api-reference/basics/start-response-streaming"},{"title":"Get Response Streaming Status","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/v1/response-streaming/status","href":"/api-reference/basics/get-response-streaming-status"}]},{"group":"Saved Views","pages":[{"title":"Get Saved Views","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/v1/saved-views","href":"/api-reference/basics/get-saved-views"},{"title":"Get Group Saved Views","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/v1/group-saved-views","href":"/api-reference/basics/get-group-saved-views"}]}]},{"group":"Analytics","pages":[{"group":"Attributes","pages":[{"title":"List Attributes","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/v1/attributes","href":"/api-reference/attributes/list-attributes"},{"title":"Cumulative Attribute Metrics","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /api/v1/attributes/cumulative","href":"/api-reference/attributes/cumulative-attribute-metrics"},{"title":"Competitor Attribute Metrics","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /api/v1/attributes/competitors","href":"/api-reference/attributes/competitor-attribute-metrics"},{"title":"Attribute Time Series","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /api/v1/attributes/time-series","href":"/api-reference/attributes/attribute-time-series"},{"title":"Attribute Observations","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /api/v1/attributes/observations","href":"/api-reference/attributes/attribute-observations"}]},{"group":"Share of Voice","pages":[{"title":"Cumulative Share of Voice","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /api/v1/metrics/share-of-voice/cumulative","href":"/api-reference/metrics/cumulative-share-of-voice"},{"title":"Share of Voice Over Time","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /api/v1/metrics/share-of-voice/time-series","href":"/api-reference/metrics/share-of-voice-over-time"}]},{"group":"Mention Rate","pages":[{"title":"Cumulative Mention Rate","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /api/v1/metrics/mention-rate/cumulative","href":"/api-reference/metrics/cumulative-mention-rate"},{"title":"Mention Rate Over Time","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /api/v1/metrics/mention-rate/time-series","href":"/api-reference/metrics/mention-rate-over-time"}]},{"group":"Citation Rate","pages":[{"title":"Cumulative Citation Rate","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /api/v1/metrics/citation-rate/cumulative","href":"/api-reference/metrics/cumulative-citation-rate"},{"title":"Citation Rate Over Time","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /api/v1/metrics/citation-rate/time-series","href":"/api-reference/metrics/citation-rate-over-time"}]},{"group":"Position","pages":[{"title":"Cumulative Position","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /api/v1/metrics/position/cumulative","href":"/api-reference/metrics/cumulative-position"},{"title":"Position Over Time","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /api/v1/metrics/position/time-series","href":"/api-reference/metrics/position-over-time"}]},{"group":"Shopping","pages":[{"title":"Shopping Metrics","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /api/v1/metrics/shopping","href":"/api-reference/metrics/shopping-metrics"}]},{"group":"AI Search Value","pages":[{"title":"AI Search Value","icon":"money-bill-trend-up","href":"/api-reference/ai-search-value"},{"title":"Get AI Search Value","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/v1/ai-search-value","href":"/api-reference/ai-search-value/get-ai-search-value"}]}]},{"group":"Content \u0026 Knowledge","pages":[{"group":"Content Hub","pages":[{"title":"List Content Hub Sheets","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/v1/content/sheets","href":"/api-reference/content/list-content-hub-sheets"},{"title":"List Tracked Content","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /api/v1/content","href":"/api-reference/content/list-tracked-content"},{"title":"List Content Items","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/v1/content/items","href":"/api-reference/content/list-content-items"},{"title":"Get Content Detail","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/v1/content/{content_id}","href":"/api-reference/content/get-content-detail"},{"title":"Per-Content Prompt Citation Breakdown","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /api/v1/content/prompts","href":"/api-reference/content/per-content-prompt-citation-breakdown"},{"title":"Start Content Pipeline","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /api/v1/content/generate","href":"/api-reference/content/start-content-pipeline"},{"title":"Get Content Pipeline Status","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/v1/content/{content_id}/status","href":"/api-reference/content/get-content-pipeline-status"},{"title":"Get Content Draft","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/v1/content/{content_id}/draft","href":"/api-reference/content/get-content-draft"},{"title":"Revise Content Brief","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /api/v1/content/{content_id}/brief/revise","href":"/api-reference/content/revise-content-brief"},{"title":"Approve Content Brief","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /api/v1/content/{content_id}/brief/approve","href":"/api-reference/content/approve-content-brief"},{"title":"Revise Content Draft","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /api/v1/content/{content_id}/revise","href":"/api-reference/content/revise-content-draft"},{"title":"Edit Content Draft","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /api/v1/content/{content_id}/edit","href":"/api-reference/content/edit-content-draft"},{"title":"List Content Versions","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /api/v1/content/{content_id}/versions","href":"/api-reference/content/list-content-versions"},{"title":"Get Content Version","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/v1/content/{content_id}/versions/{version_id}","href":"/api-reference/content/get-content-version"},{"title":"Restore Content Version","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /api/v1/content/{content_id}/versions/{version_id}/restore","href":"/api-reference/content/restore-content-version"},{"title":"Mark Content as Published","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /api/v1/content/{content_id}/publish","href":"/api-reference/content/mark-content-as-published"},{"title":"Track External URLs","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /api/v1/content/track","href":"/api-reference/content/track-external-urls"},{"title":"Rename Content","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json patch /api/v1/content/{content_id}","href":"/api-reference/content/rename-content"},{"title":"Delete Content","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json delete /api/v1/content/{content_id}","href":"/api-reference/content/delete-content"}]},{"group":"SEO Recommendations","pages":[{"title":"Submit SEO recommendations","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /api/v1/seo/recommendations","href":"/api-reference/seo-recommendations/submit-seo-recommendations"},{"title":"Get SEO recommendation job","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/v1/seo/recommendations/{job_id}","href":"/api-reference/seo-recommendations/get-seo-recommendation-job"}]},{"group":"Site Health","pages":[{"title":"List Site Health issues","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /api/v1/seo/issues","href":"/api-reference/site-health/list-site-health-issues"},{"title":"List the pages a Site Health issue affects","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /api/v1/seo/issues/pages","href":"/api-reference/site-health/list-the-pages-a-site-health-issue-affects"},{"title":"Get Site Health analytics","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/v1/seo/analytics","href":"/api-reference/site-health/get-site-health-analytics"}]},{"group":"Knowledge Base","pages":[{"title":"Search Brand Facts","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/v1/knowledge-base/facts/search","href":"/api-reference/knowledge-base/search-brand-facts"},{"title":"Get Brand Facts","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/v1/knowledge-base/facts","href":"/api-reference/knowledge-base/get-brand-facts"},{"title":"Get Pillars","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/v1/knowledge-base/pillars","href":"/api-reference/knowledge-base/get-pillars"},{"title":"Get Pillar Document","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/v1/knowledge-base/pillars/{pillar_id}/document","href":"/api-reference/knowledge-base/get-pillar-document"},{"title":"Add Brand Facts","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /api/v1/knowledge-base/facts","href":"/api-reference/knowledge-base/add-brand-facts"},{"title":"Update Brand Fact","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json patch /api/v1/knowledge-base/facts/{fact_id}","href":"/api-reference/knowledge-base/update-brand-fact"},{"title":"Delete Brand Facts","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /api/v1/knowledge-base/facts/delete","href":"/api-reference/knowledge-base/delete-brand-facts"},{"title":"Move Brand Facts","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /api/v1/knowledge-base/facts/move","href":"/api-reference/knowledge-base/move-brand-facts"},{"title":"Create Pillar","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /api/v1/knowledge-base/pillars","href":"/api-reference/knowledge-base/create-pillar"},{"title":"Update Pillar","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json patch /api/v1/knowledge-base/pillars/{pillar_id}","href":"/api-reference/knowledge-base/update-pillar"},{"title":"Delete Pillars","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /api/v1/knowledge-base/pillars/delete","href":"/api-reference/knowledge-base/delete-pillars"},{"title":"Merge Pillars","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /api/v1/knowledge-base/pillars/merge","href":"/api-reference/knowledge-base/merge-pillars"}]},{"group":"Pitch Workspace","pages":[{"title":"Create a pitch report","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /api/v1/pitches","href":"/api-reference/pitch-workspace/create-a-pitch-report"},{"title":"List Pitches","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/v1/pitches","href":"/api-reference/pitch-workspace/list-pitches"},{"title":"Get Pitch Report","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/v1/pitches/{pitch_id}","href":"/api-reference/pitch-workspace/get-pitch-report"}]},{"group":"Sources","pages":[{"title":"List Sources (by root domain)","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /api/v1/sources","href":"/api-reference/sources/list-sources-by-root-domain"},{"title":"List Source Pages (per URL)","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /api/v1/source-pages","href":"/api-reference/sources/list-source-pages-per-url"},{"title":"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.","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /api/v1/sources/youtube-creators","href":"/api-reference/sources/list-youtube-creators"},{"title":"List YouTube Videos","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /api/v1/sources/youtube-videos","href":"/api-reference/sources/list-youtube-videos"}]}]},{"group":"Administration","pages":[{"group":"Groups","pages":[{"title":"List Groups","description":"Returns all groups for your organization, including associated websites. Requires a global API key. **Partner integrations** may pass `external_id` as a query parameter to find the Athena group mapped to a partner-supplied identifier. Partner responses additionally include `externalId` on each group and on every website object inside `websites` (`null` when no mapping exists), so sites can be matched by your own identifier instead of by URL.","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/v1/groups","href":"/api-reference/groups/list-groups"},{"title":"Create Group","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /api/v1/groups","href":"/api-reference/groups/create-group"},{"title":"Get Group","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/v1/groups/{group_id}","href":"/api-reference/groups/get-group"},{"title":"Update Group","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json patch /api/v1/groups/{group_id}","href":"/api-reference/groups/update-group"}]},{"group":"Invites","pages":[{"title":"Create Invite","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /api/v1/invites","href":"/api-reference/team-management/create-invite"},{"title":"Bulk Invite to Websites or Groups","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /api/v1/invites/bulk","href":"/api-reference/team-management/bulk-invite-to-websites-or-groups"},{"title":"Revoke Organization Invite","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json delete /api/v1/invites/org/{invite_id}","href":"/api-reference/team-management/revoke-organization-invite"},{"title":"Revoke Website Invite","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json delete /api/v1/invites/website/{invite_id}","href":"/api-reference/team-management/revoke-website-invite"}]},{"group":"Members","pages":[{"title":"List Organization Members","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/v1/organizations/members","href":"/api-reference/team-management/list-organization-members"},{"title":"List Website Members","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/v1/websites/{website_id}/members","href":"/api-reference/team-management/list-website-members"},{"title":"List Group Members","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/v1/groups/{group_id}/members","href":"/api-reference/team-management/list-group-members"},{"title":"Look Up User By Email","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /api/v1/users/by-email","href":"/api-reference/team-management/look-up-user-by-email"},{"title":"List User Websites","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/v1/users/{user_id}/websites","href":"/api-reference/team-management/list-user-websites"},{"title":"Remove User From Websites","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json delete /api/v1/users/{user_id}/websites","href":"/api-reference/team-management/remove-user-from-websites"},{"title":"Update Organization Member Role","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json patch /api/v1/organizations/members/{user_id}","href":"/api-reference/team-management/update-organization-member-role"},{"title":"Update Website Member Role","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json patch /api/v1/websites/{website_id}/members/{user_id}","href":"/api-reference/team-management/update-website-member-role"},{"title":"Update Group Member Role","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json patch /api/v1/groups/{group_id}/members/{user_id}","href":"/api-reference/team-management/update-group-member-role"},{"title":"Remove Group Member Access","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json delete /api/v1/groups/{group_id}/members/{user_id}","href":"/api-reference/team-management/remove-group-member-access"},{"title":"Remove Organization Member","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json delete /api/v1/organizations/members/{user_id}","href":"/api-reference/team-management/remove-organization-member"},{"title":"Remove Website Member","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json delete /api/v1/websites/{website_id}/members/{user_id}","href":"/api-reference/team-management/remove-website-member"}]},{"group":"Roles","pages":[{"title":"List Roles","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/v1/roles","href":"/api-reference/team-management/list-roles"},{"title":"Create Custom Role","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /api/v1/roles","href":"/api-reference/team-management/create-custom-role"},{"title":"Get Role","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/v1/roles/{role_id}","href":"/api-reference/team-management/get-role"},{"title":"Update Custom Role","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json patch /api/v1/roles/{role_id}","href":"/api-reference/team-management/update-custom-role"},{"title":"Delete Custom Role","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json delete /api/v1/roles/{role_id}","href":"/api-reference/team-management/delete-custom-role"}]},{"group":"Billing","pages":[{"title":"Get Website Credits","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/v1/credits/website","href":"/api-reference/billing/get-website-credits"},{"title":"Get Organization Credits","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/v1/credits/organization","href":"/api-reference/billing/get-organization-credits"},{"title":"Get Group Credits","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/v1/credits/group","href":"/api-reference/billing/get-group-credits"},{"title":"Get Website Subscription","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/v1/subscriptions/website","href":"/api-reference/billing/get-website-subscription"},{"title":"Cancel Subscription","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /api/v1/subscriptions/cancel","href":"/api-reference/billing/cancel-subscription"}]},{"group":"AI Access","pages":[{"title":"AI Access","icon":"robot","href":"/api-reference/ai-access"},{"title":"Check AI accessibility for a domain","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /api/v1/ai-access/check","href":"/api-reference/ai-access/check-ai-accessibility-for-a-domain"}]}]}]}]},{"language":"es","default":false,"navbar":{"links":[{"href":"mailto:support@athenahq.ai","label":"Soporte"}],"primary":{"type":"button","label":"Panel","href":"https://app.athenahq.ai/settings/api"}},"pages":[{"title":"es","href":"/es/api-reference/sources/list-youtube-videos"}]},{"language":"fr","default":false,"navbar":{"links":[{"href":"mailto:support@athenahq.ai","label":"Assistance"}],"primary":{"type":"button","label":"Tableau de bord","href":"https://app.athenahq.ai/settings/api"}},"pages":[{"title":"fr","href":"/fr/api-reference/sources/list-youtube-videos"}]}]},"basePath":"","title":"List YouTube Videos - AthenaHQ","buildId":"dpl_BLQvU86QFwq3AhPofSTw6q8dGWKm","deploymentId":"dpl_BLQvU86QFwq3AhPofSTw6q8dGWKm","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-Myd8dsju.js","utils-C2HkQgW0.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-8rSppmTv.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-B6MjiCFm.js","snippetPresets-DwrSAONL.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","ApiExamples-1-a5UQKQ.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-C541m7wZ.js","shallow-CWELCZ77.js","getApiPlaygroundDisplay-CTo5Zn03.js","CodeSnippet-D--dzvnl.js","CodeSnippets-DM3cXEDh.js","Page-CxAy5y67.js","getPastedJson-C-VECgcL.js","icon-BPq2-Mg3.js","MethodPill-D9J5cUHd.js","DuplicateIcon-BqHaxUnD.js","createIcon-CIbcZHp9.js","DynamicMarkdown-BKiHAm_d.js","SectionHeading-DstQXt3H.js","axios-vUo_bRtp.js","Markdown-CpxgzsKA.js","clsx-C5EfhVm0.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-CJ9Oly2E.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-Mk6P3qvh.js"]}