Get a detailed YouTube topic report. The report data includes the number of channels in this topic, various metrics within one year period, and demographic data. Currently, this API call only supports YouTube channels.
{"docsConfig":{"theme":"maple","$schema":"https://mintlify.com/docs.json","name":"CreatorDB Documentation Center","description":"Documentation for CreatorDB's API, MCP server, web-based app (CreatorDB App), and Chrome extension (Creator Analytics by CreatorDB).","colors":{"primary":"#FF6117","light":"#FF7B3E","dark":"#cf6332"},"logo":{"light":"https://mintcdn.com/creatordb-589c46f5/p1h2Yy8EOiZPNCnz/logo/light.svg?fit=max\u0026auto=format\u0026n=p1h2Yy8EOiZPNCnz\u0026q=85\u0026s=4247a5684fe8a3c6f7c5ccb4e0993a4b","dark":"https://mintcdn.com/creatordb-589c46f5/p1h2Yy8EOiZPNCnz/logo/dark.svg?fit=max\u0026auto=format\u0026n=p1h2Yy8EOiZPNCnz\u0026q=85\u0026s=312daa702d126e8f4f6dd61f4433086e","href":"https://docs.creatordb.app/"},"favicon":"https://mintcdn.com/creatordb-589c46f5/p1h2Yy8EOiZPNCnz/favicon.svg?fit=max\u0026auto=format\u0026n=p1h2Yy8EOiZPNCnz\u0026q=85\u0026s=f9daacd616d0107c06a657618d9eb57e","api":{"playground":{"display":"interactive"},"examples":{"defaults":"all","languages":["bash","curl","javascript","python","php","ruby","go","java"],"prefill":true,"autogenerate":true}},"navbar":{"links":[{"icon":"mail","href":"mailto:product@creatordb.app","label":"Contact support"}]},"seo":{"metatags":{"canonical":"https://docs.creatordb.app","format-detection":"telephone=no","author":"CreatorDB","og:site_name":"CreatorDB Documentation Center","og:locale":"en_US"},"indexing":"navigable"},"fonts":{"family":"Inter"},"icons":{"library":"lucide"},"interaction":{"drilldown":true},"metadata":{"timestamp":true},"styling":{"latex":true},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"creatordb-589c46f5","hasAudioNarration":false,"actualSubdomain":"creatordb-589c46f5","customDomains":["docs.creatordb.app"],"gitSource":{"type":"github","owner":"creatordb","repo":"api-docs","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"entitlements":{"AI_CHAT":{"status":"ENABLED"},"WEB_MCP":{"status":"ENABLED"},"NARRATION":{"status":"ENABLED"}},"buildId":"6aed89972b99f1b14380af77","clientVersion":"0.0.4087","searchFilterCounts":[{"language":"default","tag":"CreatorDB API","count":112},{"language":"default","tag":"API Endpoints","count":76},{"language":"default","tag":"API Reference","count":66},{"language":"default","tag":"CreatorDB App","count":27},{"language":"default","tag":"YouTube","count":20},{"language":"default","tag":"User Guides","count":18},{"language":"default","tag":"CreatorDB User Guide","count":17},{"language":"default","tag":"Instagram","count":15},{"language":"default","tag":"TikTok","count":14},{"language":"default","tag":"Creator Analytics by CreatorDB","count":13}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableAskAiSearchBar":true,"deflection":{"enabled":true,"type":"email","email":"product@creatordb.app"}},"basePath":"","hasChatPermissions":true,"hasWebMcpPermissions":true,"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":"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":"editor-metadata","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":[{"filePath":"style.css","content":"#navbar{padding:0.3rem}.nav-logo{height:100px!important;width:auto!important}code{white-space:pre-wrap}footer{margin-top:2rem}a[href=\"mailto:product@creatordb.app\"]:not(.cdb-support-email):has(+.cdb-support-row){display:none!important}.cdb-support-row{display:flex;align-items:flex-start;cursor:default}.cdb-support-icon{display:flex;flex-shrink:0;align-items:center;height:1.25rem;height:1lh}.cdb-support-text{display:flex;flex-direction:column;flex:1 1 auto;align-items:stretch;gap:3px;min-width:0}.cdb-support-label{font-weight:500;color:rgb(17 24 39)}.dark .cdb-support-label{color:rgb(255 255 255)}.cdb-support-email-line{display:flex;align-items:center;justify-content:flex-start;min-width:0;margin:0;padding:0}.cdb-support-email{min-width:0;margin:0;padding:0;font-size:13px;font-weight:400;line-height:16px;color:#1C1549;text-decoration:none;text-underline-offset:3px;overflow-wrap:anywhere}.cdb-support-email:hover{text-decoration:underline}.dark .cdb-support-email{color:#A9A2E0}.cdb-support-copy{display:inline-flex;flex-shrink:0;align-items:center;justify-content:center;width:24px;height:24px;margin:-4px 0 -4px 2px;padding:0;border:0;border-radius:9999px;background:transparent;color:var(--cdb-icon-color, currentColor);cursor:pointer}.cdb-support-copy:hover,.cdb-support-copy:focus-visible{color:var(--cdb-text-color, currentColor);background:rgba(127, 127, 127, 0.15)}.cdb-support-copy svg{width:14px;height:14px}.cdb-support-copy[data-copied]{color:#16a34a}.cdb-support-tooltip{position:fixed;z-index:9999;padding:4px 8px;border-radius:6px;background:#111827;color:#fff;font-size:12px;line-height:1.4;white-space:nowrap;pointer-events:none}"}],"page":{"pagePath":"api-reference/topic/get-a-topic-report","slug":"/api-reference/topic/get-a-topic-report","pageMetadata":{"title":"Get a topic report","description":"Get a detailed YouTube topic report. The report data includes the number of channels in this topic, various metrics within one year period, and demographic data. Currently, this API call only supports YouTube channels.","deprecated":null,"version":null,"openapi":"/api-v2/api-v2.yaml get /topicReport","href":"/api-reference/topic/get-a-topic-report","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: \"Get a detailed YouTube topic report. The report data includes the number of channels in this topic, various metrics within one year period, and demographic data. Currently, this API call only supports YouTube channels.\"\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":"Get a topic report","description":"Get a detailed YouTube topic report. The report data includes the number of channels in this topic, various metrics within one year period, and demographic data. Currently, this API call only supports YouTube channels.","deprecated":null,"version":null,"openapi":"/api-v2/api-v2.yaml get /topicReport","href":"/api-reference/topic/get-a-topic-report","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":["/_mintlify/custom/creatordb-589c46f5/58e4965ca6560516/contact-support.js"],"openApiReferenceData":{"operation":{"tags":["Topic"],"summary":"Get a topic report","description":"Get a detailed YouTube topic report. The report data includes the number of channels in this topic, various metrics within one year period, and demographic data. Currently, this API call only supports YouTube channels.","operationId":"getTopicReport","parameters":["5af78283-7d08-4038-93d1-147c9e4cbad1","ed7ff8ab-2c28-49db-813c-b80a5a9f5ffd"],"x-codeSamples":[{"lang":"bash","label":"cURL","source":"curl --request GET \\\n --url 'https://dev.creatordb.app/v2/topicReport?topicId=id_minecraft_Gaming' \\\n --header 'Accept: application/json' \\\n --header 'apiId: LE6DPZQkR3TQShxofXoD2j8qCBu1-f0jti665m1t50dwDD12W' \n"}],"responses":{"200":"c5f7dce5-beb3-44ad-a331-f16e4ff7205b","403":"0ca45a7b-ad68-477c-91fc-9941bbae75a0"},"servers":["f97d9403-4d13-4580-a203-ccbed929c4a4"],"method":"get","type":"path","security":[],"path":"/topicReport","baseUrlOptions":["https://dev.creatordb.app/v2"],"title":"Get a topic report","codeSamples":[{"label":"cURL","lang":"bash","source":"curl --request GET \\\n --url 'https://dev.creatordb.app/v2/topicReport?topicId=id_minecraft_Gaming' \\\n --header 'Accept: application/json' \\\n --header 'apiId: LE6DPZQkR3TQShxofXoD2j8qCBu1-f0jti665m1t50dwDD12W' \n"}],"requestExampleLanguages":["bash","bash","javascript","python","php","ruby","go","java"],"requiredOnlyExamples":false,"requestExampleType":"codeSamples","responseExampleType":"generated","prefillPlaygroundWithExample":true,"prefillPlaygroundExamples":[]},"dependencies":{"parameters":{"5af78283-7d08-4038-93d1-147c9e4cbad1":{"name":"apiId","in":"header","description":"","required":true,"schema":{"type":"string","examples":["LE6DPZQkR3TQShxofXoD2j8qCBu1-f0jti665m1t50dwDD12W"],"isRequired":true,"uniqueKey":"","typeLabel":"string"}},"ed7ff8ab-2c28-49db-813c-b80a5a9f5ffd":{"name":"topicId","in":"query","description":"","required":true,"schema":{"type":"string","examples":["id_minecraft_Gaming"],"isRequired":true,"uniqueKey":"","typeLabel":"string"}}},"responses":{"c5f7dce5-beb3-44ad-a331-f16e4ff7205b":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","additionalProperties":false,"properties":{"ytDgMainCountry":{"type":"string","description":"The country where the largest share of viewers is located","isRequired":true,"uniqueKey":"data.ytDgMainCountry","typeLabel":"string"},"ytDgMainCountryRatio":{"type":"number","description":"The ratio of viewers in the country with the largest share","isRequired":true,"uniqueKey":"data.ytDgMainCountryRatio","typeLabel":"number"},"ytDgCountryBreakdown":{"type":"array","description":"Country breakdown of viewers","items":{"type":"object","additionalProperties":false,"properties":{"country":{"type":"string","description":"Countries where viewers are located.","isRequired":true,"uniqueKey":"data.ytDgCountryBreakdown.items.[INDEX].country","typeLabel":"string"},"value":{"type":"number","description":"The number of viewers from the country.","isRequired":true,"uniqueKey":"data.ytDgCountryBreakdown.items.[INDEX].value","typeLabel":"number"}},"required":["country","value"],"uniqueKey":"data.ytDgCountryBreakdown.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"data.ytDgCountryBreakdown","typeLabel":"object[]"},"ytDgGenderMaleRatio":{"type":"number","description":"The ratio of male viewers","isRequired":true,"uniqueKey":"data.ytDgGenderMaleRatio","typeLabel":"number"},"ytDgGenderFemaleRatio":{"type":"number","description":"The ratio of female viewers","isRequired":true,"uniqueKey":"data.ytDgGenderFemaleRatio","typeLabel":"number"},"ytDgAvgAge":{"type":"number","description":"The average viewer age","isRequired":true,"uniqueKey":"data.ytDgAvgAge","typeLabel":"number"},"ytDgAgeBreakdown":{"type":"array","description":"The number of viewers in each age group: [13–17], [18–24], [25–34], [35–44], [45–54], [55–64], [65+]","items":{"type":"number","uniqueKey":"data.ytDgAgeBreakdown.items.[INDEX]","typeLabel":"number"},"isRequired":true,"uniqueKey":"data.ytDgAgeBreakdown","typeLabel":"number[]"},"topicId":{"type":"string","description":"Name of the topic ID.","isRequired":true,"uniqueKey":"data.topicId","typeLabel":"string"},"topicName":{"type":"string","description":"Name of the topic.","isRequired":true,"uniqueKey":"data.topicName","typeLabel":"string"},"channelNumber":{"type":"number","description":"Total channels labeled with this topic.","isRequired":true,"uniqueKey":"data.channelNumber","typeLabel":"number"},"avgViews1Y":{"type":"number","description":"Average views for all YouTube channels with related topic content in one year.","isRequired":true,"uniqueKey":"data.avgViews1Y","typeLabel":"number"},"engageRate1Y":{"type":"number","description":"The average engagement rate of a video is based on up to 800 videos on this topic uploaded from the last year.","isRequired":true,"uniqueKey":"data.engageRate1Y","typeLabel":"number"},"avgLikes1Y":{"type":"number","description":"Average likes for all YouTube channels with related topic content in one year.","isRequired":true,"uniqueKey":"data.avgLikes1Y","typeLabel":"number"},"avgDislikes1Y":{"type":"number","description":"Deprecated.","isRequired":true,"uniqueKey":"data.avgDislikes1Y","typeLabel":"number"},"avgComments1Y":{"type":"number","description":"Average comments for all YouTube channels with related topic content in one year.","isRequired":true,"uniqueKey":"data.avgComments1Y","typeLabel":"number"},"avgRating1Y":{"type":"number","description":"Average ratings for all YouTube channels with related topic content.","isRequired":true,"uniqueKey":"data.avgRating1Y","typeLabel":"number"},"avgLength1Y":{"type":"number","description":"Average video length of all YouTube channels with related topic content in one year.","isRequired":true,"uniqueKey":"data.avgLength1Y","typeLabel":"number"},"avgViewsR20":{"type":"number","description":"Average views for the most recent 20 videos for all YouTube channels with related topic content.","isRequired":true,"uniqueKey":"data.avgViewsR20","typeLabel":"number"},"engageRateR20":{"type":"number","description":"The average engagement rate of a video is based on up to 800 videos on this topic uploaded from the last year.","isRequired":true,"uniqueKey":"data.engageRateR20","typeLabel":"number"},"avgLikesR20":{"type":"number","description":"Average likes for the most recent 20 videos for all YouTube channels with related topic content.","isRequired":true,"uniqueKey":"data.avgLikesR20","typeLabel":"number"},"avgDislikesR20":{"type":"number","description":"Deprecated.","isRequired":true,"uniqueKey":"data.avgDislikesR20","typeLabel":"number"},"avgCommentsR20":{"type":"number","description":"Average comments for the most recent 20 videos from all YouTube channels with related topic content.","isRequired":true,"uniqueKey":"data.avgCommentsR20","typeLabel":"number"},"avgRatingR20":{"type":"number","description":"Average ratings for the most recent 20 videos for all YouTube channels with related topic content.","isRequired":true,"uniqueKey":"data.avgRatingR20","typeLabel":"number"},"avgLengthR20":{"type":"number","description":"Average video length for the most recent 20 videos for all YouTube channels with related topic content.","isRequired":true,"uniqueKey":"data.avgLengthR20","typeLabel":"number"},"countryBreakdown":{"type":"array","description":"Break down of the country of origin for all YouTube creators.","items":{"type":"object","additionalProperties":false,"properties":{"country":{"type":"string","description":"Country of origin of YouTube creator channels labeled with this topic.","isRequired":true,"uniqueKey":"data.countryBreakdown.items.[INDEX].country","typeLabel":"string"},"count":{"type":"number","description":"The ratio of YouTube creators from this country.","isRequired":true,"uniqueKey":"data.countryBreakdown.items.[INDEX].count","typeLabel":"number"}},"required":["country","count"],"uniqueKey":"data.countryBreakdown.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"data.countryBreakdown","typeLabel":"object[]"},"relatedTopicBreakdown":{"type":"array","description":"Other related topics.","items":{"type":"object","additionalProperties":false,"properties":{"topicId":{"type":"string","description":"Name of the topic ID.","isRequired":true,"uniqueKey":"data.relatedTopicBreakdown.items.[INDEX].topicId","typeLabel":"string"},"count":{"type":"number","description":"The number of YouTube channels labeled in this topic.","isRequired":true,"uniqueKey":"data.relatedTopicBreakdown.items.[INDEX].count","typeLabel":"number"}},"required":["topicId","count"],"uniqueKey":"data.relatedTopicBreakdown.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"data.relatedTopicBreakdown","typeLabel":"object[]"},"relatedNicheBreakdown":{"type":"array","description":"Niches related to this topic.","items":{"type":"object","additionalProperties":false,"properties":{"nicheId":{"type":"string","description":"Name of the niche.","isRequired":true,"uniqueKey":"data.relatedNicheBreakdown.items.[INDEX].nicheId","typeLabel":"string"},"count":{"type":"number","description":"The number of YouTube channels labeled in this niche.","isRequired":true,"uniqueKey":"data.relatedNicheBreakdown.items.[INDEX].count","typeLabel":"number"}},"required":["nicheId","count"],"uniqueKey":"data.relatedNicheBreakdown.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"data.relatedNicheBreakdown","typeLabel":"object[]"},"rankInAllTopics":{"type":"object","additionalProperties":false,"properties":{"rankSubs":{"type":"number","description":"The percentile ranking of subscribers for this YouTube topic label compared to all other topics.","isRequired":true,"uniqueKey":"data.rankInAllTopics.rankSubs","typeLabel":"number"},"rankViews":{"type":"number","description":"The percentile ranking of total views for this YouTube topic label compared to all other topics.","isRequired":true,"uniqueKey":"data.rankInAllTopics.rankViews","typeLabel":"number"},"rankAvgViews":{"type":"number","description":"The percentile ranking of the average views for this YouTube topic label compared to all other topics.","isRequired":true,"uniqueKey":"data.rankInAllTopics.rankAvgViews","typeLabel":"number"},"rankEngage":{"type":"number","description":"The percentile ranking of the engagement rate for this YouTube topic label compared to all other topics.","isRequired":true,"uniqueKey":"data.rankInAllTopics.rankEngage","typeLabel":"number"}},"required":["rankSubs","rankViews","rankAvgViews","rankEngage"],"description":"Percentile ranking in all topics. These topics are defined by CreatorDB and act as a type of subcategory.","isRequired":true,"uniqueKey":"data.rankInAllTopics","typeLabel":"object"},"rankGrowthInAllTopics":{"type":"object","additionalProperties":false,"properties":{"rankSubs":{"type":"number","description":"The percentile ranking of subscribers for this YouTube topic label compared to all other topics.","isRequired":true,"uniqueKey":"data.rankGrowthInAllTopics.rankSubs","typeLabel":"number"},"rankViews":{"type":"number","description":"The percentile ranking of total views for this YouTube topic label compared to all other topics.","isRequired":true,"uniqueKey":"data.rankGrowthInAllTopics.rankViews","typeLabel":"number"},"rankAvgViews":{"type":"number","description":"The percentile ranking of the average views for this YouTube topic label compared to all other topics.","isRequired":true,"uniqueKey":"data.rankGrowthInAllTopics.rankAvgViews","typeLabel":"number"},"rankEngage":{"type":"number","description":"The percentile ranking of the engagement rate for this YouTube topic label compared to all other topics.","isRequired":true,"uniqueKey":"data.rankGrowthInAllTopics.rankEngage","typeLabel":"number"}},"required":["rankSubs","rankViews","rankAvgViews","rankEngage"],"description":"Percentile ranking of the growth rate by YouTube topics over 30 days. These topics are defined by CreatorDB and act as a type of subcategory.","isRequired":true,"uniqueKey":"data.rankGrowthInAllTopics","typeLabel":"object"},"rankByCategories":{"type":"object","additionalProperties":false,"properties":{"rankSubs":{"type":"number","description":"The percentile ranking of subscribers for this YouTube topic label compared to all other topics.","isRequired":true,"uniqueKey":"data.rankByCategories.rankSubs","typeLabel":"number"},"rankViews":{"type":"number","description":"The percentile ranking of total views for this YouTube topic label compared to all other topics.","isRequired":true,"uniqueKey":"data.rankByCategories.rankViews","typeLabel":"number"},"rankAvgViews":{"type":"number","description":"The percentile ranking of the average views for this YouTube topic label compared to all other topics.","isRequired":true,"uniqueKey":"data.rankByCategories.rankAvgViews","typeLabel":"number"},"rankEngage":{"type":"number","description":"The percentile ranking of the engagement rate for this YouTube topic label compared to all other topics.","isRequired":true,"uniqueKey":"data.rankByCategories.rankEngage","typeLabel":"number"}},"required":["rankSubs","rankViews","rankAvgViews","rankEngage"],"description":"Topic report ranking by YouTube categories.","isRequired":true,"uniqueKey":"data.rankByCategories","typeLabel":"object"},"rankGrowthByCategories":{"type":"object","additionalProperties":false,"properties":{"rankSubs":{"type":"number","description":"The percentile ranking of subscribers for this YouTube topic label compared to all other topics.","isRequired":true,"uniqueKey":"data.rankGrowthByCategories.rankSubs","typeLabel":"number"},"rankViews":{"type":"number","description":"The percentile ranking of total views for this YouTube topic label compared to all other topics.","isRequired":true,"uniqueKey":"data.rankGrowthByCategories.rankViews","typeLabel":"number"},"rankAvgViews":{"type":"number","description":"The percentile ranking of the average views for this YouTube topic label compared to all other topics.","isRequired":true,"uniqueKey":"data.rankGrowthByCategories.rankAvgViews","typeLabel":"number"},"rankEngage":{"type":"number","description":"The percentile ranking of the engagement rate for this YouTube topic label compared to all other topics.","isRequired":true,"uniqueKey":"data.rankGrowthByCategories.rankEngage","typeLabel":"number"}},"required":["rankSubs","rankViews","rankAvgViews","rankEngage"],"description":"Percentile ranking of the growth rate by YouTube categories over 30 days.","isRequired":true,"uniqueKey":"data.rankGrowthByCategories","typeLabel":"object"},"gSubscribers":{"type":"number","description":"The growth rate of subscribers for this topic over 30 days.","isRequired":true,"uniqueKey":"data.gSubscribers","typeLabel":"number"},"gTotalViews":{"type":"number","description":"The growth rate of total views for this topic over 30 days.","isRequired":true,"uniqueKey":"data.gTotalViews","typeLabel":"number"},"gAvgViewsR20":{"type":"number","description":"The growth rate of the average views for the most recent 20 videos on this topic over 30 days.","isRequired":true,"uniqueKey":"data.gAvgViewsR20","typeLabel":"number"},"gEngageRateR20":{"type":"number","description":"The growth rate of the engagement rate from the most recent 20 videos on this topic over 30 days.","isRequired":true,"uniqueKey":"data.gEngageRateR20","typeLabel":"number"}},"required":["ytDgMainCountry","ytDgMainCountryRatio","ytDgCountryBreakdown","ytDgGenderMaleRatio","ytDgGenderFemaleRatio","ytDgAvgAge","ytDgAgeBreakdown","topicId","topicName","channelNumber","avgViews1Y","engageRate1Y","avgLikes1Y","avgDislikes1Y","avgComments1Y","avgRating1Y","avgLength1Y","avgViewsR20","engageRateR20","avgLikesR20","avgDislikesR20","avgCommentsR20","avgRatingR20","avgLengthR20","countryBreakdown","relatedTopicBreakdown","relatedNicheBreakdown","rankInAllTopics","rankGrowthInAllTopics","rankByCategories","rankGrowthByCategories","gSubscribers","gTotalViews","gAvgViewsR20","gEngageRateR20"],"uniqueKey":"data","typeLabel":"object"},"quotaUsed":{"type":"number","description":"API credits that were used to make this call.","uniqueKey":"quotaUsed","typeLabel":"number"},"quotaUsedTotal":{"type":"number","description":"Total API credits used since the last billing cycle.","uniqueKey":"quotaUsedTotal","typeLabel":"number"},"remainingPlanCredit":{"type":"number","description":"The number of remaining free API credits that come with your subscription plan. These API credits are renewed every billing cycle.","uniqueKey":"remainingPlanCredit","typeLabel":"number"},"remainingPrepurchasedCredit":{"type":"number","description":"The number of remaining extra purchased API credits. These API credits do not expire until used.","uniqueKey":"remainingPrepurchasedCredit","typeLabel":"number"},"timestamp":{"type":"number","description":"Unix timestamp of the call request that the server received.","uniqueKey":"timestamp","typeLabel":"number"},"error":{"type":"string","description":"Errors that occurred during the API call.","uniqueKey":"error","typeLabel":"string"},"success":{"type":"boolean","description":"It is TRUE when the call is successful.","uniqueKey":"success","typeLabel":"boolean"}},"uniqueKey":"","typeLabel":"object"},"examples":{"default":{"title":"default","value":{"data":{"ytDgMainCountry":"USA","ytDgMainCountryRatio":0.25619661399548493,"ytDgCountryBreakdown":[{"country":"USA","value":0.25619661399548493},{"country":"DEU","value":0.07613182844243792},{"country":"FRA","value":0.05287494356659145}],"ytDgGenderMaleRatio":0.6669777319587632,"ytDgGenderFemaleRatio":0.3327748453608248,"ytDgAvgAge":31.89085082474229,"ytDgAgeBreakdown":[0.06435340206185572,0.3039703092783508,0.24169670103092772],"topicId":"id_minecraft_Gaming","topicName":"Minecraft","channelNumber":800,"avgViews1Y":308043,"engageRate1Y":0.05511483035821551,"avgLikes1Y":8782,"avgDislikes1Y":4,"avgComments1Y":602,"avgRating1Y":0.15336445215445188,"avgLength1Y":1715,"avgViewsR20":260339,"engageRateR20":0.058044981782167174,"avgLikesR20":8091,"avgDislikesR20":0,"avgCommentsR20":582,"avgRatingR20":0,"avgLengthR20":1594,"countryBreakdown":[{"country":"USA","count":291},{"country":"GBR","count":92},{"country":"ESP","count":89}],"relatedTopicBreakdown":[{"topicId":"id_minecraft_Gaming","count":800},{"topicId":"id_casualgaming_Gaming","count":765},{"topicId":"id_sandbox_Gaming","count":748}],"relatedNicheBreakdown":[{"nicheId":"id_minecraft_Gaming","count":476},{"nicheId":"id_funny_Gaming","count":133},{"nicheId":"id_roblox_Gaming","count":129}],"rankInAllTopics":{"rankSubs":89.1213389121339,"rankViews":83.89121338912133,"rankAvgViews":91.63179916317992,"rankEngage":92.25941422594143},"rankGrowthInAllTopics":{"rankSubs":17.991631799163173,"rankViews":36.82008368200837,"rankAvgViews":76.98744769874477,"rankEngage":51.04602510460251},"rankByCategories":{"rankSubs":82.8125,"rankViews":82.8125,"rankAvgViews":93.75,"rankEngage":92.1875},"rankGrowthByCategories":{"rankSubs":43.75,"rankViews":53.125,"rankAvgViews":87.5,"rankEngage":34.375},"gSubscribers":0.0029053182638998356,"gTotalViews":0.005916388772396742,"gAvgViewsR20":0.011351231659136731,"gEngageRateR20":-0.001941457284146474},"quotaUsed":25,"quotaUsedTotal":6049,"remainingPlanCredit":993951,"remainingPrepurchasedCredit":0,"timestamp":1755503514906,"error":"","success":true}}},"exampleType":"examples"}},"exampleType":"examples"},"0ca45a7b-ad68-477c-91fc-9941bbae75a0":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","additionalProperties":false,"properties":{"ytDgMainCountry":{"type":"string","description":"The country where the largest share of viewers is located","isRequired":true,"uniqueKey":"data.ytDgMainCountry","typeLabel":"string"},"ytDgMainCountryRatio":{"type":"number","description":"The ratio of viewers in the country with the largest share","isRequired":true,"uniqueKey":"data.ytDgMainCountryRatio","typeLabel":"number"},"ytDgCountryBreakdown":{"type":"array","description":"Country breakdown of viewers","items":{"type":"object","additionalProperties":false,"properties":{"country":{"type":"string","description":"Countries where viewers are located.","isRequired":true,"uniqueKey":"data.ytDgCountryBreakdown.items.[INDEX].country","typeLabel":"string"},"value":{"type":"number","description":"The number of viewers from the country.","isRequired":true,"uniqueKey":"data.ytDgCountryBreakdown.items.[INDEX].value","typeLabel":"number"}},"required":["country","value"],"uniqueKey":"data.ytDgCountryBreakdown.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"data.ytDgCountryBreakdown","typeLabel":"object[]"},"ytDgGenderMaleRatio":{"type":"number","description":"The ratio of male viewers","isRequired":true,"uniqueKey":"data.ytDgGenderMaleRatio","typeLabel":"number"},"ytDgGenderFemaleRatio":{"type":"number","description":"The ratio of female viewers","isRequired":true,"uniqueKey":"data.ytDgGenderFemaleRatio","typeLabel":"number"},"ytDgAvgAge":{"type":"number","description":"The average viewer age","isRequired":true,"uniqueKey":"data.ytDgAvgAge","typeLabel":"number"},"ytDgAgeBreakdown":{"type":"array","description":"The number of viewers in each age group: [13–17], [18–24], [25–34], [35–44], [45–54], [55–64], [65+]","items":{"type":"number","uniqueKey":"data.ytDgAgeBreakdown.items.[INDEX]","typeLabel":"number"},"isRequired":true,"uniqueKey":"data.ytDgAgeBreakdown","typeLabel":"number[]"},"topicId":{"type":"string","description":"Name of the topic ID.","isRequired":true,"uniqueKey":"data.topicId","typeLabel":"string"},"topicName":{"type":"string","description":"Name of the topic.","isRequired":true,"uniqueKey":"data.topicName","typeLabel":"string"},"channelNumber":{"type":"number","description":"Total channels labeled with this topic.","isRequired":true,"uniqueKey":"data.channelNumber","typeLabel":"number"},"avgViews1Y":{"type":"number","description":"Average views for all YouTube channels with related topic content in one year.","isRequired":true,"uniqueKey":"data.avgViews1Y","typeLabel":"number"},"engageRate1Y":{"type":"number","description":"The average engagement rate of a video is based on up to 800 videos on this topic uploaded from the last year.","isRequired":true,"uniqueKey":"data.engageRate1Y","typeLabel":"number"},"avgLikes1Y":{"type":"number","description":"Average likes for all YouTube channels with related topic content in one year.","isRequired":true,"uniqueKey":"data.avgLikes1Y","typeLabel":"number"},"avgDislikes1Y":{"type":"number","description":"Deprecated.","isRequired":true,"uniqueKey":"data.avgDislikes1Y","typeLabel":"number"},"avgComments1Y":{"type":"number","description":"Average comments for all YouTube channels with related topic content in one year.","isRequired":true,"uniqueKey":"data.avgComments1Y","typeLabel":"number"},"avgRating1Y":{"type":"number","description":"Average ratings for all YouTube channels with related topic content.","isRequired":true,"uniqueKey":"data.avgRating1Y","typeLabel":"number"},"avgLength1Y":{"type":"number","description":"Average video length of all YouTube channels with related topic content in one year.","isRequired":true,"uniqueKey":"data.avgLength1Y","typeLabel":"number"},"avgViewsR20":{"type":"number","description":"Average views for the most recent 20 videos for all YouTube channels with related topic content.","isRequired":true,"uniqueKey":"data.avgViewsR20","typeLabel":"number"},"engageRateR20":{"type":"number","description":"The average engagement rate of a video is based on up to 800 videos on this topic uploaded from the last year.","isRequired":true,"uniqueKey":"data.engageRateR20","typeLabel":"number"},"avgLikesR20":{"type":"number","description":"Average likes for the most recent 20 videos for all YouTube channels with related topic content.","isRequired":true,"uniqueKey":"data.avgLikesR20","typeLabel":"number"},"avgDislikesR20":{"type":"number","description":"Deprecated.","isRequired":true,"uniqueKey":"data.avgDislikesR20","typeLabel":"number"},"avgCommentsR20":{"type":"number","description":"Average comments for the most recent 20 videos from all YouTube channels with related topic content.","isRequired":true,"uniqueKey":"data.avgCommentsR20","typeLabel":"number"},"avgRatingR20":{"type":"number","description":"Average ratings for the most recent 20 videos for all YouTube channels with related topic content.","isRequired":true,"uniqueKey":"data.avgRatingR20","typeLabel":"number"},"avgLengthR20":{"type":"number","description":"Average video length for the most recent 20 videos for all YouTube channels with related topic content.","isRequired":true,"uniqueKey":"data.avgLengthR20","typeLabel":"number"},"countryBreakdown":{"type":"array","description":"Break down of the country of origin for all YouTube creators.","items":{"type":"object","additionalProperties":false,"properties":{"country":{"type":"string","description":"Country of origin of YouTube creator channels labeled with this topic.","isRequired":true,"uniqueKey":"data.countryBreakdown.items.[INDEX].country","typeLabel":"string"},"count":{"type":"number","description":"The ratio of YouTube creators from this country.","isRequired":true,"uniqueKey":"data.countryBreakdown.items.[INDEX].count","typeLabel":"number"}},"required":["country","count"],"uniqueKey":"data.countryBreakdown.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"data.countryBreakdown","typeLabel":"object[]"},"relatedTopicBreakdown":{"type":"array","description":"Other related topics.","items":{"type":"object","additionalProperties":false,"properties":{"topicId":{"type":"string","description":"Name of the topic ID.","isRequired":true,"uniqueKey":"data.relatedTopicBreakdown.items.[INDEX].topicId","typeLabel":"string"},"count":{"type":"number","description":"The number of YouTube channels labeled in this topic.","isRequired":true,"uniqueKey":"data.relatedTopicBreakdown.items.[INDEX].count","typeLabel":"number"}},"required":["topicId","count"],"uniqueKey":"data.relatedTopicBreakdown.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"data.relatedTopicBreakdown","typeLabel":"object[]"},"relatedNicheBreakdown":{"type":"array","description":"Niches related to this topic.","items":{"type":"object","additionalProperties":false,"properties":{"nicheId":{"type":"string","description":"Name of the niche.","isRequired":true,"uniqueKey":"data.relatedNicheBreakdown.items.[INDEX].nicheId","typeLabel":"string"},"count":{"type":"number","description":"The number of YouTube channels labeled in this niche.","isRequired":true,"uniqueKey":"data.relatedNicheBreakdown.items.[INDEX].count","typeLabel":"number"}},"required":["nicheId","count"],"uniqueKey":"data.relatedNicheBreakdown.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"data.relatedNicheBreakdown","typeLabel":"object[]"},"rankInAllTopics":{"type":"object","additionalProperties":false,"properties":{"rankSubs":{"type":"number","description":"The percentile ranking of subscribers for this YouTube topic label compared to all other topics.","isRequired":true,"uniqueKey":"data.rankInAllTopics.rankSubs","typeLabel":"number"},"rankViews":{"type":"number","description":"The percentile ranking of total views for this YouTube topic label compared to all other topics.","isRequired":true,"uniqueKey":"data.rankInAllTopics.rankViews","typeLabel":"number"},"rankAvgViews":{"type":"number","description":"The percentile ranking of the average views for this YouTube topic label compared to all other topics.","isRequired":true,"uniqueKey":"data.rankInAllTopics.rankAvgViews","typeLabel":"number"},"rankEngage":{"type":"number","description":"The percentile ranking of the engagement rate for this YouTube topic label compared to all other topics.","isRequired":true,"uniqueKey":"data.rankInAllTopics.rankEngage","typeLabel":"number"}},"required":["rankSubs","rankViews","rankAvgViews","rankEngage"],"description":"Percentile ranking in all topics. These topics are defined by CreatorDB and act as a type of subcategory.","isRequired":true,"uniqueKey":"data.rankInAllTopics","typeLabel":"object"},"rankGrowthInAllTopics":{"type":"object","additionalProperties":false,"properties":{"rankSubs":{"type":"number","description":"The percentile ranking of subscribers for this YouTube topic label compared to all other topics.","isRequired":true,"uniqueKey":"data.rankGrowthInAllTopics.rankSubs","typeLabel":"number"},"rankViews":{"type":"number","description":"The percentile ranking of total views for this YouTube topic label compared to all other topics.","isRequired":true,"uniqueKey":"data.rankGrowthInAllTopics.rankViews","typeLabel":"number"},"rankAvgViews":{"type":"number","description":"The percentile ranking of the average views for this YouTube topic label compared to all other topics.","isRequired":true,"uniqueKey":"data.rankGrowthInAllTopics.rankAvgViews","typeLabel":"number"},"rankEngage":{"type":"number","description":"The percentile ranking of the engagement rate for this YouTube topic label compared to all other topics.","isRequired":true,"uniqueKey":"data.rankGrowthInAllTopics.rankEngage","typeLabel":"number"}},"required":["rankSubs","rankViews","rankAvgViews","rankEngage"],"description":"Percentile ranking of the growth rate by YouTube topics over 30 days. These topics are defined by CreatorDB and act as a type of subcategory.","isRequired":true,"uniqueKey":"data.rankGrowthInAllTopics","typeLabel":"object"},"rankByCategories":{"type":"object","additionalProperties":false,"properties":{"rankSubs":{"type":"number","description":"The percentile ranking of subscribers for this YouTube topic label compared to all other topics.","isRequired":true,"uniqueKey":"data.rankByCategories.rankSubs","typeLabel":"number"},"rankViews":{"type":"number","description":"The percentile ranking of total views for this YouTube topic label compared to all other topics.","isRequired":true,"uniqueKey":"data.rankByCategories.rankViews","typeLabel":"number"},"rankAvgViews":{"type":"number","description":"The percentile ranking of the average views for this YouTube topic label compared to all other topics.","isRequired":true,"uniqueKey":"data.rankByCategories.rankAvgViews","typeLabel":"number"},"rankEngage":{"type":"number","description":"The percentile ranking of the engagement rate for this YouTube topic label compared to all other topics.","isRequired":true,"uniqueKey":"data.rankByCategories.rankEngage","typeLabel":"number"}},"required":["rankSubs","rankViews","rankAvgViews","rankEngage"],"description":"Topic report ranking by YouTube categories.","isRequired":true,"uniqueKey":"data.rankByCategories","typeLabel":"object"},"rankGrowthByCategories":{"type":"object","additionalProperties":false,"properties":{"rankSubs":{"type":"number","description":"The percentile ranking of subscribers for this YouTube topic label compared to all other topics.","isRequired":true,"uniqueKey":"data.rankGrowthByCategories.rankSubs","typeLabel":"number"},"rankViews":{"type":"number","description":"The percentile ranking of total views for this YouTube topic label compared to all other topics.","isRequired":true,"uniqueKey":"data.rankGrowthByCategories.rankViews","typeLabel":"number"},"rankAvgViews":{"type":"number","description":"The percentile ranking of the average views for this YouTube topic label compared to all other topics.","isRequired":true,"uniqueKey":"data.rankGrowthByCategories.rankAvgViews","typeLabel":"number"},"rankEngage":{"type":"number","description":"The percentile ranking of the engagement rate for this YouTube topic label compared to all other topics.","isRequired":true,"uniqueKey":"data.rankGrowthByCategories.rankEngage","typeLabel":"number"}},"required":["rankSubs","rankViews","rankAvgViews","rankEngage"],"description":"Percentile ranking of the growth rate by YouTube categories over 30 days.","isRequired":true,"uniqueKey":"data.rankGrowthByCategories","typeLabel":"object"},"gSubscribers":{"type":"number","description":"The growth rate of subscribers for this topic over 30 days.","isRequired":true,"uniqueKey":"data.gSubscribers","typeLabel":"number"},"gTotalViews":{"type":"number","description":"The growth rate of total views for this topic over 30 days.","isRequired":true,"uniqueKey":"data.gTotalViews","typeLabel":"number"},"gAvgViewsR20":{"type":"number","description":"The growth rate of the average views for the most recent 20 videos on this topic over 30 days.","isRequired":true,"uniqueKey":"data.gAvgViewsR20","typeLabel":"number"},"gEngageRateR20":{"type":"number","description":"The growth rate of the engagement rate from the most recent 20 videos on this topic over 30 days.","isRequired":true,"uniqueKey":"data.gEngageRateR20","typeLabel":"number"}},"required":["ytDgMainCountry","ytDgMainCountryRatio","ytDgCountryBreakdown","ytDgGenderMaleRatio","ytDgGenderFemaleRatio","ytDgAvgAge","ytDgAgeBreakdown","topicId","topicName","channelNumber","avgViews1Y","engageRate1Y","avgLikes1Y","avgDislikes1Y","avgComments1Y","avgRating1Y","avgLength1Y","avgViewsR20","engageRateR20","avgLikesR20","avgDislikesR20","avgCommentsR20","avgRatingR20","avgLengthR20","countryBreakdown","relatedTopicBreakdown","relatedNicheBreakdown","rankInAllTopics","rankGrowthInAllTopics","rankByCategories","rankGrowthByCategories","gSubscribers","gTotalViews","gAvgViewsR20","gEngageRateR20"],"uniqueKey":"data","typeLabel":"object"},"quotaUsed":{"type":"number","description":"API credits that were used to make this call.","uniqueKey":"quotaUsed","typeLabel":"number"},"quotaUsedTotal":{"type":"number","description":"Total API credits used since the last billing cycle.","uniqueKey":"quotaUsedTotal","typeLabel":"number"},"remainingPlanCredit":{"type":"number","description":"The number of remaining free API credits that come with your subscription plan. These API credits are renewed every billing cycle.","uniqueKey":"remainingPlanCredit","typeLabel":"number"},"remainingPrepurchasedCredit":{"type":"number","description":"The number of remaining extra purchased API credits. These API credits do not expire until used.","uniqueKey":"remainingPrepurchasedCredit","typeLabel":"number"},"timestamp":{"type":"number","description":"Unix timestamp of the call request that the server received.","uniqueKey":"timestamp","typeLabel":"number"},"error":{"type":"string","description":"Errors that occurred during the API call.","uniqueKey":"error","typeLabel":"string"},"success":{"type":"boolean","description":"It is TRUE when the call is successful.","uniqueKey":"success","typeLabel":"boolean"}},"uniqueKey":"","typeLabel":"object"},"examples":{"default":{"title":"default","value":{"data":null,"quotaUsed":0,"quotaUsedTotal":0,"remainingPlanCredit":0,"remainingPrepurchasedCredit":0,"timestamp":1755503514055,"error":"APIKeyOnlyForTesting","success":false}}},"exampleType":"examples"}},"exampleType":"examples"}},"security":{},"servers":{"f97d9403-4d13-4580-a203-ccbed929c4a4":{"url":"https://dev.creatordb.app/v2","description":"CreatorDB API Endpoint - prod version"}}},"originalFileLocation":"api-v2/api-v2.yaml"},"subdomain":"creatordb-589c46f5","siteName":"CreatorDB Documentation Center","title":"Get a topic report - CreatorDB Documentation Center","navMaps":{"firstHrefInVersion":{"3.0":{"href":"/api-reference/general-operations/get-api-usage","matchLevel":2},"2.0":{"href":"/api-reference/topic/get-a-topic-report","matchLevel":0}},"firstHrefInLanguage":{}},"originalFileLocation":"api-reference/topic/get-a-topic-report.mdx"},"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=\"Get a detailed YouTube topic report. The report data includes the number of channels in this topic, various metrics within one year period, and demographic data. Currently, this API call only supports YouTube channels.\">\u003cmeta data-mint-head name=\"application-name\" content=\"CreatorDB Documentation Center\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/creatordb-589c46f5/MCBADQ1JRpces4eF/_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/creatordb-589c46f5/MCBADQ1JRpces4eF/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/creatordb-589c46f5/MCBADQ1JRpces4eF/_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/creatordb-589c46f5/MCBADQ1JRpces4eF/_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/creatordb-589c46f5/MCBADQ1JRpces4eF/_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/creatordb-589c46f5/MCBADQ1JRpces4eF/_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/creatordb-589c46f5/MCBADQ1JRpces4eF/_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/creatordb-589c46f5/MCBADQ1JRpces4eF/_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/creatordb-589c46f5/MCBADQ1JRpces4eF/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Get a topic report - CreatorDB Documentation Center\">\u003cmeta data-mint-head property=\"og:description\" content=\"Get a detailed YouTube topic report. The report data includes the number of channels in this topic, various metrics within one year period, and demographic data. Currently, this API call only supports YouTube channels.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"CreatorDB Documentation Center\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.creatordb.app/api-reference/topic/get-a-topic-report\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://creatordb-589c46f5.mintlify.site/_mintlify/api/og/v2?division=Topic\u0026amp;title=Get+a+topic+report\u0026amp;description=Get+a+detailed+YouTube+topic+report.+The+report+data+includes+the+number+of+channels+in+this+topic%2C+various+metrics+within+one+year+period%2C+and+demographic+data\u0026amp;theme=4f6f7d6d515d76d22bdf1025\u0026amp;signature=c660f9c55015e46629764ced832af0fae55dd63d1a1ffa66e666dca4144f2c69\">\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=\"Get a topic report - CreatorDB Documentation Center\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Get a detailed YouTube topic report. The report data includes the number of channels in this topic, various metrics within one year period, and demographic data. Currently, this API call only supports YouTube channels.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://creatordb-589c46f5.mintlify.site/_mintlify/api/og/v2?division=Topic\u0026amp;title=Get+a+topic+report\u0026amp;description=Get+a+detailed+YouTube+topic+report.+The+report+data+includes+the+number+of+channels+in+this+topic%2C+various+metrics+within+one+year+period%2C+and+demographic+data\u0026amp;theme=4f6f7d6d515d76d22bdf1025\u0026amp;signature=c660f9c55015e46629764ced832af0fae55dd63d1a1ffa66e666dca4144f2c69\">\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/creatordb-589c46f5/MCBADQ1JRpces4eF/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"CreatorDB Documentation Center\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#FF6117\">\u003cmeta data-mint-head name=\"og:locale\" content=\"en_US\">\u003cmeta data-mint-head name=\"format-detection\" content=\"telephone=no\">\u003cmeta data-mint-head name=\"author\" content=\"CreatorDB\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.creatordb.app/api-reference/topic/get-a-topic-report\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/topic/get-a-topic-report.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.creatordb.app/#organization\",\"name\":\"CreatorDB Documentation Center\",\"url\":\"https://docs.creatordb.app\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/creatordb-589c46f5/p1h2Yy8EOiZPNCnz/logo/light.svg?fit=max\u0026auto=format\u0026n=p1h2Yy8EOiZPNCnz\u0026q=85\u0026s=4247a5684fe8a3c6f7c5ccb4e0993a4b\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.creatordb.app#website\",\"name\":\"CreatorDB Documentation Center\",\"url\":\"https://docs.creatordb.app\",\"publisher\":{\"@id\":\"https://docs.creatordb.app/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.creatordb.app/api-reference/topic/get-a-topic-report#webpage\",\"url\":\"https://docs.creatordb.app/api-reference/topic/get-a-topic-report\",\"name\":\"Get a topic report\",\"description\":\"Get a detailed YouTube topic report. The report data includes the number of channels in this topic, various metrics within one year period, and demographic data. Currently, this API call only supports YouTube channels.\",\"isPartOf\":{\"@id\":\"https://docs.creatordb.app#website\"},\"breadcrumb\":{\"@id\":\"https://docs.creatordb.app/api-reference/topic/get-a-topic-report#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.creatordb.app/api-reference/topic/get-a-topic-report#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"API Endpoints\",\"item\":\"https://docs.creatordb.app/api-reference/general-operations/get-api-credit-status\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Topic\",\"item\":\"https://docs.creatordb.app/api-reference/topic/get-the-topic-table\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"Get a topic report\",\"item\":\"https://docs.creatordb.app/api-reference/topic/get-a-topic-report\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.creatordb.app/api-reference/topic/get-a-topic-report#apireference\",\"headline\":\"Get a topic report\",\"name\":\"Get a topic report\",\"description\":\"Get a detailed YouTube topic report. The report data includes the number of channels in this topic, various metrics within one year period, and demographic data. Currently, this API call only supports YouTube channels.\",\"url\":\"https://docs.creatordb.app/api-reference/topic/get-a-topic-report\",\"mainEntityOfPage\":{\"@id\":\"https://docs.creatordb.app/api-reference/topic/get-a-topic-report#webpage\"},\"publisher\":{\"@id\":\"https://docs.creatordb.app/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.creatordb.app#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"CreatorDB Documentation Center\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"CreatorDB Documentation Center","nav":{"global":null,"products":[{"product":"CreatorDB API","icon":"webhook","description":"Documentation for the CreatorDB API","versions":[{"version":"3.0","pages":[{"title":"3.0","href":"/api-reference/general-operations/get-api-usage"}]},{"version":"2.0","groups":[{"group":"Getting Started","icon":"Rocket","pages":[{"title":"Introduction","mode":"wide","href":"/api-v2/introduction"},{"title":"Key Terms","mode":"wide","href":"/api-v2/key-terms"},{"title":"Fundamentals","mode":"wide","href":"/api-v2/the-basics"},{"title":"Methods and Parameters","mode":"wide","href":"/api-v2/methods-and-parameters"},{"title":"Authentication","mode":"wide","href":"/api-v2/authentication"},{"title":"Quickstart","mode":"wide","href":"/api-v2/quickstart"}]},{"group":"User Guides","icon":"Notebook","pages":[{"title":"Creator Advanced Search Filters","mode":"wide","href":"/api-v2/creator-advanced-search-filters"},{"title":"Configuring Advanced Search Filters and Examples","mode":"wide","href":"/api-v2/configuring_advanced_search_filters"},{"title":"API Credit Usage","mode":"wide","href":"/api-v2/api-credit-usage"}]},{"group":"API Endpoints","icon":"ServerCog","pages":[{"group":"General Operations","pages":[{"title":"Get API credit status","deprecated":null,"version":null,"openapi":"/api-v2/api-v2.yaml get /apiStatus","href":"/api-reference/general-operations/get-api-credit-status"},{"title":"Submit creators","deprecated":null,"version":null,"openapi":"/api-v2/api-v2.yaml post /submitCreators","href":"/api-reference/general-operations/submit-creators"},{"title":"Get content info by ID","deprecated":null,"version":null,"openapi":"/api-v2/api-v2.yaml get /getPostById","href":"/api-reference/general-operations/get-content-info-by-id"},{"title":"Get content info by link","deprecated":null,"version":null,"openapi":"/api-v2/api-v2.yaml get /getPostByLink","href":"/api-reference/general-operations/get-content-info-by-link"}]},{"group":"YouTube","pages":[{"title":"Get basic YouTube metrics","deprecated":null,"version":null,"openapi":"/api-v2/api-v2.yaml get /youtubeBasic","href":"/api-reference/youtube/get-basic-youtube-metrics"},{"title":"Get YouTube historical data","deprecated":null,"version":null,"openapi":"/api-v2/api-v2.yaml get /youtubeHistory","href":"/api-reference/youtube/get-youtube-historical-data"},{"title":"Get detailed YouTube data","deprecated":null,"version":null,"openapi":"/api-v2/api-v2.yaml get /youtubeDetail","href":"/api-reference/youtube/get-detailed-youtube-data"},{"title":"Add filters to YouTube advanced search","deprecated":null,"version":null,"openapi":"/api-v2/api-v2.yaml post /youtubeAdvancedSearch","href":"/api-reference/youtube/add-filters-to-youtube-advanced-search"},{"title":"Get contact information","deprecated":null,"version":null,"openapi":"/api-v2/api-v2.yaml get /contactInformation","href":"/api-reference/youtube/get-contact-information"},{"title":"Get the creator's YouTube contact","deprecated":null,"version":null,"openapi":"/api-v2/api-v2.yaml get /youtubeEmail","href":"/api-reference/youtube/get-the-creators-youtube-contact"}]},{"group":"Instagram","pages":[{"title":"Get basic Instagram metrics","deprecated":null,"version":null,"openapi":"/api-v2/api-v2.yaml get /instagramBasic","href":"/api-reference/instagram/get-basic-instagram-metrics"},{"title":"Get Instagram historical data","deprecated":null,"version":null,"openapi":"/api-v2/api-v2.yaml get /instagramHistory","href":"/api-reference/instagram/get-instagram-historical-data"},{"title":"Add filters to Instagram advanced search","deprecated":null,"version":null,"openapi":"/api-v2/api-v2.yaml post /instagramAdvancedSearch","href":"/api-reference/instagram/add-filters-to-instagram-advanced-search"}]},{"group":"TikTok","pages":[{"title":"Get basic TikTok data metrics","deprecated":null,"version":null,"openapi":"/api-v2/api-v2.yaml get /tiktokBasic","href":"/api-reference/tiktok/get-basic-tiktok-data-metrics"},{"title":"Get TikTok historical data","deprecated":null,"version":null,"openapi":"/api-v2/api-v2.yaml get /tiktokHistory","href":"/api-reference/tiktok/get-tiktok-historical-data"},{"title":"Add filters to TikTok advanced search","deprecated":null,"version":null,"openapi":"/api-v2/api-v2.yaml post /tiktokAdvancedSearch","href":"/api-reference/tiktok/add-filters-to-tiktok-advanced-search"}]},{"group":"Threads","pages":[{"title":"Get basic Threads metrics","deprecated":null,"version":null,"openapi":"/api-v2/api-v2.yaml get /threadsBasic","href":"/api-reference/threads/get-basic-threads-metrics"},{"title":"Get Threads historical data","deprecated":null,"version":null,"openapi":"/api-v2/api-v2.yaml get /threadsHistory","href":"/api-reference/threads/get-threads-historical-data"},{"title":"Add filters to Threads advanced search","deprecated":null,"version":null,"openapi":"/api-v2/api-v2.yaml post /threadsAdvancedSearch","href":"/api-reference/threads/add-filters-to-threads-advanced-search"}]},{"group":"Facebook","pages":[{"title":"Get basic Facebook metrics","deprecated":null,"version":null,"openapi":"/api-v2/api-v2.yaml get /facebookBasic","href":"/api-reference/facebook/get-basic-facebook-metrics"},{"title":"Get Facebook historical data","deprecated":null,"version":null,"openapi":"/api-v2/api-v2.yaml get /facebookHistory","href":"/api-reference/facebook/get-facebook-historical-data"},{"title":"Add filters to Facebook advanced search","deprecated":null,"version":null,"openapi":"/api-v2/api-v2.yaml post /facebookAdvancedSearch","href":"/api-reference/facebook/add-filters-to-facebook-advanced-search"}]},{"group":"Brand","pages":[{"title":"Get the brand table","deprecated":null,"version":null,"openapi":"/api-v2/api-v2.yaml get /brandTable","href":"/api-reference/brand/get-the-brand-table"},{"title":"Get Instagram and YouTube brand report","deprecated":null,"version":null,"openapi":"/api-v2/api-v2.yaml get /brandReportV2","href":"/api-reference/brand/get-instagram-and-youtube-brand-report"},{"title":"Add filters to Instagram and YouTube brand advanced search","deprecated":null,"version":null,"openapi":"/api-v2/api-v2.yaml post /brandAdvancedSearchV2","href":"/api-reference/brand/add-filters-to-instagram-and-youtube-brand-advanced-search"},{"title":"Add brand sponsor search details","deprecated":null,"version":null,"openapi":"/api-v2/api-v2.yaml post /brandSponsorSearch","href":"/api-reference/brand/add-brand-sponsor-search-details"}]},{"group":"Topic","pages":[{"title":"Get the topic table","description":"Get the table of YouTube topic IDs. The topic IDs are defined by CreatorDB.","deprecated":null,"version":null,"openapi":"/api-v2/api-v2.yaml get /topicTable","href":"/api-reference/topic/get-the-topic-table"},{"title":"Get a topic report","deprecated":null,"version":null,"openapi":"/api-v2/api-v2.yaml get /topicReport","href":"/api-reference/topic/get-a-topic-report"}]},{"group":"Niches","pages":[{"title":"Add filters to related niches search","description":"Add filters from a predefined list to your related niches search.","deprecated":null,"version":null,"openapi":"/api-v2/api-v2.yaml post /getRelatedNiches","href":"/api-reference/niches/add-filters-to-related-niches-search"}]}]},{"group":"Filter Value References","icon":"book-user","pages":[{"title":"YouTube Channel Categories","mode":"wide","href":"/api-v2/youtube-categories"},{"title":"Instagram Categories","mode":"default","href":"/api-v2/instagram-categories"},{"title":"Country Codes","mode":"wide","href":"/api-v2/country-code"},{"title":"Language Codes","mode":"wide","href":"/api-v2/language-code"},{"title":"Industry List","mode":"default","href":"/api-v2/industry-list"}]},{"group":"Troubleshooting and FAQs","icon":"hammer","pages":[{"title":"General FAQs","href":"/api-v2/generalFAQs"},{"title":"Error Codes","mode":"wide","href":"/api-v2/error-code"}]}]}]},{"product":"CreatorDB MCP Server","icon":"server","description":"Documentation about CreatorDB's MCP server and services","pages":[{"title":"CreatorDB MCP Server","href":"/mcp-server/setting-up-the-creatordb-mcp-connector"}]},{"product":"CreatorDB App","icon":"app-window","description":"Documentation for the CreatorDB web platform","pages":[{"title":"CreatorDB App","href":"/creatordb_app/getting_started/getting_started"}]},{"product":"Creator Analytics by CreatorDB","icon":"square-mouse-pointer","description":"Documentation for the CreatorDB Chrome Extension","pages":[{"title":"Creator Analytics by CreatorDB","href":"/creatordb_app/extension/about"}]}]},"basePath":"","title":"Get a topic report - CreatorDB Documentation Center","buildId":"dpl_FWZhTb2vab28gFGFH4ojka6qEznQ","deploymentId":"dpl_FWZhTb2vab28gFGFH4ojka6qEznQ","dynamics":["c2aa737661","b0f84f53ff","a9bb46feb3","2b790eda92"],"chunks":["OpenApiReferenceProvider-CBsVopKK.js","utils-DZAk68jJ.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-D32AYZrP.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-D_A5_cny.js","snippetPresets-xNRfS9th.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","conditional-requirements-CFM0id0Q.js","Page-Dr40SSJq.js","ApiExamples-BIB25-tq.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-CydJ4w4j.js","shallow-CYPBeQSG.js","getApiPlaygroundDisplay-A5xJVBOu.js","CodeSnippet-BVRTgi3m.js","CodeSnippets-DjD6BSlt.js","getPastedJson-D4V4JyrR.js","icon-uhcnG22T.js","MethodPill-CM-ZQdGH.js","DuplicateIcon-B_WnOiNf.js","createIcon-CJsb8utt.js","DynamicMarkdown-D-2HDKEp.js","SectionHeading-KP5xmMgQ.js","axios-vUo_bRtp.js","Markdown-D_k0dg6k.js","clsx-DK3K4Z1S.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-DE3EVdvd.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-fN9H9n9g.js"]}