{"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/youtube/get-youtube-historical-data","slug":"/api-reference/youtube/get-youtube-historical-data","pageMetadata":{"title":"Get YouTube historical data","description":"Get the basic metrics and historical data of a creator's YouTube account.","deprecated":null,"version":null,"openapi":"/api-v2/api-v2.yaml get /youtubeHistory","href":"/api-reference/youtube/get-youtube-historical-data","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 the basic metrics and historical data of a creator’s YouTube account.\"\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 YouTube historical data","description":"Get the basic metrics and historical data of a creator's YouTube account.","deprecated":null,"version":null,"openapi":"/api-v2/api-v2.yaml get /youtubeHistory","href":"/api-reference/youtube/get-youtube-historical-data","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":["/_mintlify/custom/creatordb-589c46f5/58e4965ca6560516/contact-support.js"],"openApiReferenceData":{"operation":{"tags":["YouTube"],"summary":"Get YouTube historical data","description":"Get the basic metrics and historical data of a creator's YouTube account.","operationId":"getYoutubeHistory","parameters":["e9c5e7fb-e01f-4752-ac4e-ea65969bf188","ca36eb38-d2d9-46a9-8bda-357ca044f3b5"],"x-codeSamples":[{"lang":"bash","label":"cURL","source":"curl --request GET \\\n --url 'https://dev.creatordb.app/v2/youtubeHistory?youtubeId=UCm-X6o81nRsXQTmqpyArkBQ' \\\n --header 'Accept: application/json' \\\n --header 'apiId: LE6DPZQkR3TQShxofXoD2j8qCBu1-f0jti665m1t50dwDD12W' \n"}],"responses":{"200":"09419dda-ec02-4eec-a4e1-25b53ee2ce2d","403":"c69b6b0e-49fe-49c8-a058-1ea11024b24a"},"servers":["d5996677-d55e-415e-a795-080585fec070"],"method":"get","type":"path","security":[],"path":"/youtubeHistory","baseUrlOptions":["https://dev.creatordb.app/v2"],"title":"Get YouTube historical data","codeSamples":[{"label":"cURL","lang":"bash","source":"curl --request GET \\\n --url 'https://dev.creatordb.app/v2/youtubeHistory?youtubeId=UCm-X6o81nRsXQTmqpyArkBQ' \\\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":{"e9c5e7fb-e01f-4752-ac4e-ea65969bf188":{"name":"apiId","in":"header","description":"","required":true,"schema":{"type":"string","examples":["LE6DPZQkR3TQShxofXoD2j8qCBu1-f0jti665m1t50dwDD12W"],"isRequired":true,"uniqueKey":"","typeLabel":"string"}},"ca36eb38-d2d9-46a9-8bda-357ca044f3b5":{"name":"youtubeId","in":"query","description":"","required":true,"schema":{"type":"string","examples":["UCm-X6o81nRsXQTmqpyArkBQ"],"isRequired":true,"uniqueKey":"","typeLabel":"string"}}},"responses":{"09419dda-ec02-4eec-a4e1-25b53ee2ce2d":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","additionalProperties":false,"properties":{"basicYoutube":{"type":"object","additionalProperties":false,"properties":{"youtubeId":{"type":"string","description":"Unique ID of the YouTube channel.","isRequired":true,"uniqueKey":"data.basicYoutube.youtubeId","typeLabel":"string"},"youtubeName":{"type":"string","description":"The YouTube channel name.","isRequired":true,"uniqueKey":"data.basicYoutube.youtubeName","typeLabel":"string"},"displayId":{"type":"string","description":"The YouTube creator's handle.","isRequired":true,"uniqueKey":"data.basicYoutube.displayId","typeLabel":"string"},"instagramId":{"type":"string","description":"Instagram account ID of this YouTube creator.","isRequired":true,"uniqueKey":"data.basicYoutube.instagramId","typeLabel":"string"},"tiktokId":{"type":"string","description":"The TikTok ID of the YouTube creator. Otherwise, this field is blank.","isRequired":true,"uniqueKey":"data.basicYoutube.tiktokId","typeLabel":"string"},"avatar":{"type":"string","description":"URL to the profile picture of the YouTube creator's account.","isRequired":true,"uniqueKey":"data.basicYoutube.avatar","typeLabel":"string"},"hasEmail":{"type":"boolean","description":"It is TRUE when the CreatorDB database has this YouTube creator's email contact.","isRequired":true,"uniqueKey":"data.basicYoutube.hasEmail","typeLabel":"boolean"},"subscribers":{"type":"number","description":"The current number of subscribers to this YouTube channel.","isRequired":true,"uniqueKey":"data.basicYoutube.subscribers","typeLabel":"number"},"views":{"type":"number","description":"Total views of this YouTube channel.","isRequired":true,"uniqueKey":"data.basicYoutube.views","typeLabel":"number"},"country":{"type":"string","description":"The YouTube creator's country of origin.","isRequired":true,"uniqueKey":"data.basicYoutube.country","typeLabel":"string"},"lang":{"type":"string","description":"The YouTube creator's preferred language.","isRequired":true,"uniqueKey":"data.basicYoutube.lang","typeLabel":"string"},"createDate":{"type":"number","description":"Unix timestamp of the date that the YouTube account was created.","isRequired":true,"uniqueKey":"data.basicYoutube.createDate","typeLabel":"number"},"lastUploadTime":{"type":"number","description":"Unix timestamp of the latest uploaded post by the YouTube creator.","isRequired":true,"uniqueKey":"data.basicYoutube.lastUploadTime","typeLabel":"number"},"links":{"type":"array","items":{"type":"object","additionalProperties":false,"properties":{"title":{"type":"string","description":"The name of a connected link from the About page of the YouTube channel.","isRequired":true,"uniqueKey":"data.basicYoutube.links.items.[INDEX].title","typeLabel":"string"},"url":{"type":"string","description":"URL of the link on the About page of the YouTube channel.","isRequired":true,"uniqueKey":"data.basicYoutube.links.items.[INDEX].url","typeLabel":"string"}},"required":["title","url"],"uniqueKey":"data.basicYoutube.links.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"data.basicYoutube.links","typeLabel":"object[]"},"hashtags":{"type":"array","description":"Collection of hashtags that are included in all YouTube videos.","items":{"type":"string","uniqueKey":"data.basicYoutube.hashtags.items.[INDEX]","typeLabel":"string"},"isRequired":true,"uniqueKey":"data.basicYoutube.hashtags","typeLabel":"string[]"},"mainCategory":{"type":"string","description":"The most common YouTube category selected by the creator from a list of default categories.","isRequired":true,"uniqueKey":"data.basicYoutube.mainCategory","typeLabel":"string"},"topicIds":{"type":"array","description":"Subcategories assigned to the default YouTube parent categories by CreatorDB's system.","items":{"type":"string","uniqueKey":"data.basicYoutube.topicIds.items.[INDEX]","typeLabel":"string"},"isRequired":true,"uniqueKey":"data.basicYoutube.topicIds","typeLabel":"string[]"},"nicheIds":{"type":"array","description":"Niches assigned by CreatorDB's system to improve the content category keywords.","items":{"type":"string","uniqueKey":"data.basicYoutube.nicheIds.items.[INDEX]","typeLabel":"string"},"isRequired":true,"uniqueKey":"data.basicYoutube.nicheIds","typeLabel":"string[]"},"avgLength1Y":{"type":"number","description":"Average video length in seconds for up to 800 YouTube videos uploaded in one year.","isRequired":true,"uniqueKey":"data.basicYoutube.avgLength1Y","typeLabel":"number"},"avgLikes1Y":{"type":"number","description":"Average likes per video for up to 800 YouTube videos uploaded in one year.","isRequired":true,"uniqueKey":"data.basicYoutube.avgLikes1Y","typeLabel":"number"},"avgComments1Y":{"type":"number","description":"Average comments per video for up to 800 YouTube videos uploaded in one year.","isRequired":true,"uniqueKey":"data.basicYoutube.avgComments1Y","typeLabel":"number"},"avgSelfCommentRatio1Y":{"type":"number","description":"The YouTube creator's self-comment ratio per video in one year.","isRequired":true,"uniqueKey":"data.basicYoutube.avgSelfCommentRatio1Y","typeLabel":"number"},"avgCommentLikeRatio1Y":{"type":"number","description":"Average comments to likes ratio per YouTube video in one year.","isRequired":true,"uniqueKey":"data.basicYoutube.avgCommentLikeRatio1Y","typeLabel":"number"},"avgCommentReplyRatio1Y":{"type":"number","description":"Average comments to replies ratio per YouTube video in one year.","isRequired":true,"uniqueKey":"data.basicYoutube.avgCommentReplyRatio1Y","typeLabel":"number"},"avgViews1Y":{"type":"number","description":"Average views per YouTube video for up to 800 videos uploaded in one year.","isRequired":true,"uniqueKey":"data.basicYoutube.avgViews1Y","typeLabel":"number"},"engageRate1Y":{"type":"number","description":"The average engagement rate for up to 800 YouTube videos uploaded in one year. The YouTube engagement rate is calculated by adding likes and comments and then dividing by views.","isRequired":true,"uniqueKey":"data.basicYoutube.engageRate1Y","typeLabel":"number"},"avgLengthR20":{"type":"number","description":"Average video length in seconds for the YouTube creator's most recent 20 YouTube videos uploaded.","isRequired":true,"uniqueKey":"data.basicYoutube.avgLengthR20","typeLabel":"number"},"avgLikesR20":{"type":"number","description":"Average likes per video for the YouTube creator's latest 20 uploaded videos.","isRequired":true,"uniqueKey":"data.basicYoutube.avgLikesR20","typeLabel":"number"},"avgCommentsR20":{"type":"number","description":"Average comments per video for this YouTube creator's latest 20 uploaded videos.","isRequired":true,"uniqueKey":"data.basicYoutube.avgCommentsR20","typeLabel":"number"},"avgSelfCommentRatioR20":{"type":"number","description":"The YouTube creator's self-comment ratio per video among the most recent 20 comments.","isRequired":true,"uniqueKey":"data.basicYoutube.avgSelfCommentRatioR20","typeLabel":"number"},"avgCommentLikeRatioR20":{"type":"number","description":"The ratio of the creator's self-likes divided by the top 20 comments is averaged from the most recent 20 videos to find the creator's engagement rate.","isRequired":true,"uniqueKey":"data.basicYoutube.avgCommentLikeRatioR20","typeLabel":"number"},"avgCommentReplyRatioR20":{"type":"number","description":"Average comments to replies ratio for the latest 20 comments per YouTube video.","isRequired":true,"uniqueKey":"data.basicYoutube.avgCommentReplyRatioR20","typeLabel":"number"},"avgViewsR20":{"type":"number","description":"Average views per YouTube video for the latest 20 uploaded pieces of content.","isRequired":true,"uniqueKey":"data.basicYoutube.avgViewsR20","typeLabel":"number"},"engageRateR20":{"type":"number","description":"Average engagement rate of the YouTube creator's latest 20 uploaded pieces of content.","isRequired":true,"uniqueKey":"data.basicYoutube.engageRateR20","typeLabel":"number"},"gRateSubscribers":{"type":"number","description":"The growth rate of the YouTube channel subscribers over 30 days.","isRequired":true,"uniqueKey":"data.basicYoutube.gRateSubscribers","typeLabel":"number"},"gRateViews":{"type":"number","description":"The growth rate of the YouTube creator's total video views over 30 days.","isRequired":true,"uniqueKey":"data.basicYoutube.gRateViews","typeLabel":"number"},"gRateAvgViewsR20":{"type":"number","description":"The growth rate for average views of the YouTube creator's most recent 20 posts over 30 days.","isRequired":true,"uniqueKey":"data.basicYoutube.gRateAvgViewsR20","typeLabel":"number"},"gRateEngageRateR20":{"type":"number","description":"The growth rate for engagement rate of the YouTube creator's most recent 20 posts over 30 days.","isRequired":true,"uniqueKey":"data.basicYoutube.gRateEngageRateR20","typeLabel":"number"},"recentVideos":{"type":"array","items":{"type":"object","additionalProperties":false,"properties":{"uploadDate":{"type":"number","description":"Unix timestamp of the YouTube video upload time.","isRequired":true,"uniqueKey":"data.basicYoutube.recentVideos.items.[INDEX].uploadDate","typeLabel":"number"},"videoId":{"type":"string","description":"Unique ID of the video that is auto-generated.","isRequired":true,"uniqueKey":"data.basicYoutube.recentVideos.items.[INDEX].videoId","typeLabel":"string"},"length":{"type":"number","description":"Length of the YouTube video in seconds.","isRequired":true,"uniqueKey":"data.basicYoutube.recentVideos.items.[INDEX].length","typeLabel":"number"},"title":{"type":"string","description":"The title of the YouTube video.","isRequired":true,"uniqueKey":"data.basicYoutube.recentVideos.items.[INDEX].title","typeLabel":"string"},"likes":{"type":"number","description":"The number of likes the YouTube video received.","isRequired":true,"uniqueKey":"data.basicYoutube.recentVideos.items.[INDEX].likes","typeLabel":"number"},"comments":{"type":"number","description":"The number of comments on this YouTube video.","isRequired":true,"uniqueKey":"data.basicYoutube.recentVideos.items.[INDEX].comments","typeLabel":"number"},"selfCommentRatio":{"type":"number","description":"The ratio of the YouTube creator's self-comments to recent 20 comments.","isRequired":true,"uniqueKey":"data.basicYoutube.recentVideos.items.[INDEX].selfCommentRatio","typeLabel":"number"},"commentLikeRatio":{"type":"number","description":"The ratio of comments to likes for this YouTube video.","isRequired":true,"uniqueKey":"data.basicYoutube.recentVideos.items.[INDEX].commentLikeRatio","typeLabel":"number"},"commentReplyRatio":{"type":"number","description":"The ratio of comments to the YouTube creator replies for this video.","isRequired":true,"uniqueKey":"data.basicYoutube.recentVideos.items.[INDEX].commentReplyRatio","typeLabel":"number"},"views":{"type":"number","description":"The number of views for the YouTube video.","isRequired":true,"uniqueKey":"data.basicYoutube.recentVideos.items.[INDEX].views","typeLabel":"number"},"engageRate":{"type":"number","description":"The engagement rate of this YouTube video. The engagement rate is calculated by adding the likes and comments and then dividing by the number of video views.","isRequired":true,"uniqueKey":"data.basicYoutube.recentVideos.items.[INDEX].engageRate","typeLabel":"number"},"category":{"type":"string","description":"The video category assigned by the YouTube creator from a default category list.","isRequired":true,"uniqueKey":"data.basicYoutube.recentVideos.items.[INDEX].category","typeLabel":"string"},"lang":{"type":"string","description":"Language of the YouTube video.","isRequired":true,"uniqueKey":"data.basicYoutube.recentVideos.items.[INDEX].lang","typeLabel":"string"},"isPaidPromote":{"type":"boolean","description":"It is TRUE when the YouTube creator flags the video as containing an advertisement.","isRequired":true,"uniqueKey":"data.basicYoutube.recentVideos.items.[INDEX].isPaidPromote","typeLabel":"boolean"},"isStreaming":{"type":"boolean","description":"It is TRUE when the YouTube video is a live stream.","isRequired":true,"uniqueKey":"data.basicYoutube.recentVideos.items.[INDEX].isStreaming","typeLabel":"boolean"},"isShorts":{"type":"boolean","description":"It is TRUE when the video is a YouTube short.","isRequired":true,"uniqueKey":"data.basicYoutube.recentVideos.items.[INDEX].isShorts","typeLabel":"boolean"},"hashtags":{"type":"array","description":"Hashtags that are included in this YouTube video.","items":{"type":"string","uniqueKey":"data.basicYoutube.recentVideos.items.[INDEX].hashtags.items.[INDEX]","typeLabel":"string"},"isRequired":true,"uniqueKey":"data.basicYoutube.recentVideos.items.[INDEX].hashtags","typeLabel":"string[]"}},"required":["uploadDate","videoId","length","title","likes","comments","selfCommentRatio","commentLikeRatio","commentReplyRatio","views","engageRate","category","lang","isPaidPromote","isStreaming","isShorts","hashtags"],"uniqueKey":"data.basicYoutube.recentVideos.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"data.basicYoutube.recentVideos","typeLabel":"object[]"}},"required":["youtubeId","youtubeName","displayId","instagramId","tiktokId","avatar","hasEmail","subscribers","views","country","lang","createDate","lastUploadTime","links","hashtags","mainCategory","topicIds","nicheIds","avgLength1Y","avgLikes1Y","avgComments1Y","avgSelfCommentRatio1Y","avgCommentLikeRatio1Y","avgCommentReplyRatio1Y","avgViews1Y","engageRate1Y","avgLengthR20","avgLikesR20","avgCommentsR20","avgSelfCommentRatioR20","avgCommentLikeRatioR20","avgCommentReplyRatioR20","avgViewsR20","engageRateR20","gRateSubscribers","gRateViews","gRateAvgViewsR20","gRateEngageRateR20","recentVideos"],"isRequired":true,"uniqueKey":"data.basicYoutube","typeLabel":"object"},"histories":{"type":"array","items":{"type":"object","additionalProperties":false,"properties":{"timestamp":{"type":"number","description":"Unix timestamp of when the YouTube data snapshot was collected.","isRequired":true,"uniqueKey":"data.histories.items.[INDEX].timestamp","typeLabel":"number"},"subscribers":{"type":"number","description":"Total subscribers of this YouTube channel.","isRequired":true,"uniqueKey":"data.histories.items.[INDEX].subscribers","typeLabel":"number"},"likes":{"type":"number","description":"Total likes of this YouTube channel.","isRequired":true,"uniqueKey":"data.histories.items.[INDEX].likes","typeLabel":"number"},"comments":{"type":"number","description":"Total number of comments on a YouTube creator's channel.","isRequired":true,"uniqueKey":"data.histories.items.[INDEX].comments","typeLabel":"number"},"views":{"type":"number","description":"Total views of this YouTube channel.","isRequired":true,"uniqueKey":"data.histories.items.[INDEX].views","typeLabel":"number"},"avgLength1Y":{"type":"number","description":"The average video length in seconds for up to 800 videos uploaded last year.","isRequired":true,"uniqueKey":"data.histories.items.[INDEX].avgLength1Y","typeLabel":"number"},"avgLikes1Y":{"type":"number","description":"The average likes per video for up to 800 videos uploaded last year.","isRequired":true,"uniqueKey":"data.histories.items.[INDEX].avgLikes1Y","typeLabel":"number"},"avgComments1Y":{"type":"number","description":"The average comments per video for up to 800 videos uploaded last year.","isRequired":true,"uniqueKey":"data.histories.items.[INDEX].avgComments1Y","typeLabel":"number"},"avgSelfCommentRatio1Y":{"type":"number","description":"The ratio of the YouTube creator's self-comments per video to total comments on a specified date in one year.","isRequired":true,"uniqueKey":"data.histories.items.[INDEX].avgSelfCommentRatio1Y","typeLabel":"number"},"avgCommentLikeRatio1Y":{"type":"number","description":"The ratio of average comments per video to likes on a specified date in one year.","isRequired":true,"uniqueKey":"data.histories.items.[INDEX].avgCommentLikeRatio1Y","typeLabel":"number"},"avgCommentReplyRatio1Y":{"type":"number","description":"The ratio of average comments per video to replies on a specified date in one year.","isRequired":true,"uniqueKey":"data.histories.items.[INDEX].avgCommentReplyRatio1Y","typeLabel":"number"},"avgViews1Y":{"type":"number","description":"The average number of views per video for up to 800 videos uploaded last year.","isRequired":true,"uniqueKey":"data.histories.items.[INDEX].avgViews1Y","typeLabel":"number"},"engageRate1Y":{"type":"number","description":"The average engagement rate for a YouTube video is based on up to 800 videos uploaded last year.","isRequired":true,"uniqueKey":"data.histories.items.[INDEX].engageRate1Y","typeLabel":"number"},"avgLengthR20":{"type":"number","description":"The average video length in seconds for the YouTube creator's recent 20 uploads.","isRequired":true,"uniqueKey":"data.histories.items.[INDEX].avgLengthR20","typeLabel":"number"},"avgLikesR20":{"type":"number","description":"The average likes per video for the YouTube creator's recent 20 uploads.","isRequired":true,"uniqueKey":"data.histories.items.[INDEX].avgLikesR20","typeLabel":"number"},"avgCommentsR20":{"type":"number","description":"The average comments per video for the YouTube creator's recent 20 uploads.","isRequired":true,"uniqueKey":"data.histories.items.[INDEX].avgCommentsR20","typeLabel":"number"},"avgSelfCommentRatioR20":{"type":"number","description":"The ratio of the YouTube creator's self-comments per video to the top 20 comments on a specified date in one year.","isRequired":true,"uniqueKey":"data.histories.items.[INDEX].avgSelfCommentRatioR20","typeLabel":"number"},"avgCommentLikeRatioR20":{"type":"number","description":"The ratio of average top 20 comments per video to likes for a specified date in one year.","isRequired":true,"uniqueKey":"data.histories.items.[INDEX].avgCommentLikeRatioR20","typeLabel":"number"},"avgCommentReplyRatioR20":{"type":"number","description":"The ratio of average top 20 comments per video to replies for a specific date in one year.","isRequired":true,"uniqueKey":"data.histories.items.[INDEX].avgCommentReplyRatioR20","typeLabel":"number"},"avgViewsR20":{"type":"number","description":"The average number of views per video for the YouTube creator's recent 20 uploads.","isRequired":true,"uniqueKey":"data.histories.items.[INDEX].avgViewsR20","typeLabel":"number"},"engageRateR20":{"type":"number","description":"The average engagement rate for a video is based on the YouTube creator's recent 20 videos.","isRequired":true,"uniqueKey":"data.histories.items.[INDEX].engageRateR20","typeLabel":"number"}},"required":["timestamp","subscribers","likes","comments","views","avgLength1Y","avgLikes1Y","avgComments1Y","avgSelfCommentRatio1Y","avgCommentLikeRatio1Y","avgCommentReplyRatio1Y","avgViews1Y","engageRate1Y","avgLengthR20","avgLikesR20","avgCommentsR20","avgSelfCommentRatioR20","avgCommentLikeRatioR20","avgCommentReplyRatioR20","avgViewsR20","engageRateR20"],"uniqueKey":"data.histories.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"data.histories","typeLabel":"object[]"}},"required":["basicYoutube","histories"],"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":{"basicYoutube":{"youtubeId":"UCm-X6o81nRsXQTmqpyArkBQ","youtubeName":"Flamingo","displayId":"@flamingo","instagramId":"albertsstuff","tiktokId":"","avatar":"https://yt3.googleusercontent.com/7cF22TRiceqQr2Cro_X4uhRVnwCdOa2HXiwdBGPnUEqJDuCyr2CykDfDw2rCWjbjaHEdTMUC=s900-c-k-c0x00ffffff-no-rj","hasEmail":true,"subscribers":13900000,"views":12002736149,"country":"USA","lang":"eng","createDate":1499184000000,"lastUploadTime":1755142212000,"links":[{"title":"Instagram","url":"https://www.instagram.com/albertsstuff/"},{"title":"The Shop","url":"http://flimflam.shop/"},{"title":"Business email","url":"flamingo@ellify.com"}],"hashtags":["#starrailsimulator","#honkaistarrail","#sponsored"],"mainCategory":"Gaming","topicIds":["id_freegames_Gaming","id_rpg_Gaming","id_roblox_Gaming"],"nicheIds":["id_roblox_Gaming","id_funny_Gaming","id_poppyplaytime_Gaming"],"avgLength1Y":612,"avgLikes1Y":80970,"avgComments1Y":6611,"avgSelfCommentRatio1Y":0.02129629629629627,"avgCommentLikeRatio1Y":0.0012345679012345679,"avgCommentReplyRatio1Y":0.0021604938271604936,"avgViews1Y":2332262,"engageRate1Y":0.03755141478648009,"avgLengthR20":801.5,"avgLikesR20":79945,"avgCommentsR20":7517,"avgSelfCommentRatioR20":0.02222222222222222,"avgCommentLikeRatioR20":0,"avgCommentReplyRatioR20":0.005555555555555556,"avgViewsR20":2297082,"engageRateR20":0.038074757313463874,"gRateSubscribers":0.022058823529411766,"gRateViews":0.008608394749283115,"gRateAvgViewsR20":0.5715348397137289,"gRateEngageRateR20":-0.24690527845279533,"recentVideos":[{"uploadDate":1755142212000,"videoId":"FbCF_H4ZD64","length":873,"title":"I hosted an ADMIN ABUSE on GROW A GARDEN","likes":153000,"comments":15182,"selfCommentRatio":0,"commentLikeRatio":0,"commentReplyRatio":0,"views":5009695,"engageRate":0.03357130523914131,"category":"Gaming","lang":"eng","isPaidPromote":false,"isStreaming":false,"isShorts":false,"hashtags":[]},{"uploadDate":1754966320000,"videoId":"rqKF4lzzMT0","length":551,"title":"Roblox won’t stop BANNING me.","likes":89000,"comments":9190,"selfCommentRatio":0.05,"commentLikeRatio":0,"commentReplyRatio":0,"views":1898329,"engageRate":0.05172443765016496,"category":"Gaming","lang":"jav","isPaidPromote":false,"isStreaming":false,"isShorts":false,"hashtags":[]},{"uploadDate":1754797869000,"videoId":"eHnzGYHEdO0","length":572,"title":"ROBLOX OP ADMIN IN STEAL A BRAINROT","likes":66000,"comments":8527,"selfCommentRatio":0.05,"commentLikeRatio":0,"commentReplyRatio":0,"views":2034093,"engageRate":0.03663893440467078,"category":"Gaming","lang":"nld","isPaidPromote":false,"isStreaming":false,"isShorts":false,"hashtags":[]}]},"histories":[{"timestamp":1755360000000,"subscribers":13900000,"likes":13117000,"comments":1070915,"views":12002736149,"avgLength1Y":612,"avgLikes1Y":80970,"avgComments1Y":6611,"avgSelfCommentRatio1Y":0.02129629629629627,"avgCommentLikeRatio1Y":0.0012345679012345679,"avgCommentReplyRatio1Y":0.0021604938271604936,"avgViews1Y":2332262,"engageRate1Y":0.03755141478648009,"avgLengthR20":801.5,"avgLikesR20":79945,"avgCommentsR20":7517,"avgSelfCommentRatioR20":0.02222222222222222,"avgCommentLikeRatioR20":0,"avgCommentReplyRatioR20":0.005555555555555556,"avgViewsR20":2297082,"engageRateR20":0.038074757313463874},{"timestamp":1755187200000,"subscribers":13900000,"likes":13050000,"comments":1069620,"views":11994640894,"avgLength1Y":612,"avgLikes1Y":80556,"avgComments1Y":6603,"avgSelfCommentRatio1Y":0.02129629629629627,"avgCommentLikeRatio1Y":0.0012345679012345679,"avgCommentReplyRatio1Y":0.0021604938271604936,"avgViews1Y":2308133,"engageRate1Y":0.03776133314230006,"avgLengthR20":779.7777777777778,"avgLikesR20":79834,"avgCommentsR20":7760,"avgSelfCommentRatioR20":0.02222222222222222,"avgCommentLikeRatioR20":0,"avgCommentReplyRatioR20":0.005555555555555556,"avgViewsR20":2215847,"engageRateR20":0.03953008681908395},{"timestamp":1755014400000,"subscribers":13800000,"likes":12895000,"comments":1058110,"views":11985928604,"avgLength1Y":611,"avgLikes1Y":80094,"avgComments1Y":6573,"avgSelfCommentRatio1Y":0.0214285714285714,"avgCommentLikeRatio1Y":0.0012422360248447205,"avgCommentReplyRatio1Y":0.002173913043478261,"avgViews1Y":2287655,"engageRate1Y":0.03788389841176463,"avgLengthR20":815.0555555555555,"avgLikesR20":75723,"avgCommentsR20":7257,"avgSelfCommentRatioR20":0.024999999999999998,"avgCommentLikeRatioR20":0,"avgCommentReplyRatioR20":0.005555555555555556,"avgViewsR20":2063091,"engageRateR20":0.04022061181340748}]},"quotaUsed":3,"quotaUsedTotal":6027,"remainingPlanCredit":993973,"remainingPrepurchasedCredit":0,"timestamp":1755503517606,"error":"","success":true}}},"exampleType":"examples"}},"exampleType":"examples"},"c69b6b0e-49fe-49c8-a058-1ea11024b24a":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","additionalProperties":false,"properties":{"basicYoutube":{"type":"object","additionalProperties":false,"properties":{"youtubeId":{"type":"string","description":"Unique ID of the YouTube channel.","isRequired":true,"uniqueKey":"data.basicYoutube.youtubeId","typeLabel":"string"},"youtubeName":{"type":"string","description":"The YouTube channel name.","isRequired":true,"uniqueKey":"data.basicYoutube.youtubeName","typeLabel":"string"},"displayId":{"type":"string","description":"The YouTube creator's handle.","isRequired":true,"uniqueKey":"data.basicYoutube.displayId","typeLabel":"string"},"instagramId":{"type":"string","description":"Instagram account ID of this YouTube creator.","isRequired":true,"uniqueKey":"data.basicYoutube.instagramId","typeLabel":"string"},"tiktokId":{"type":"string","description":"The TikTok ID of the YouTube creator. Otherwise, this field is blank.","isRequired":true,"uniqueKey":"data.basicYoutube.tiktokId","typeLabel":"string"},"avatar":{"type":"string","description":"URL to the profile picture of the YouTube creator's account.","isRequired":true,"uniqueKey":"data.basicYoutube.avatar","typeLabel":"string"},"hasEmail":{"type":"boolean","description":"It is TRUE when the CreatorDB database has this YouTube creator's email contact.","isRequired":true,"uniqueKey":"data.basicYoutube.hasEmail","typeLabel":"boolean"},"subscribers":{"type":"number","description":"The current number of subscribers to this YouTube channel.","isRequired":true,"uniqueKey":"data.basicYoutube.subscribers","typeLabel":"number"},"views":{"type":"number","description":"Total views of this YouTube channel.","isRequired":true,"uniqueKey":"data.basicYoutube.views","typeLabel":"number"},"country":{"type":"string","description":"The YouTube creator's country of origin.","isRequired":true,"uniqueKey":"data.basicYoutube.country","typeLabel":"string"},"lang":{"type":"string","description":"The YouTube creator's preferred language.","isRequired":true,"uniqueKey":"data.basicYoutube.lang","typeLabel":"string"},"createDate":{"type":"number","description":"Unix timestamp of the date that the YouTube account was created.","isRequired":true,"uniqueKey":"data.basicYoutube.createDate","typeLabel":"number"},"lastUploadTime":{"type":"number","description":"Unix timestamp of the latest uploaded post by the YouTube creator.","isRequired":true,"uniqueKey":"data.basicYoutube.lastUploadTime","typeLabel":"number"},"links":{"type":"array","items":{"type":"object","additionalProperties":false,"properties":{"title":{"type":"string","description":"The name of a connected link from the About page of the YouTube channel.","isRequired":true,"uniqueKey":"data.basicYoutube.links.items.[INDEX].title","typeLabel":"string"},"url":{"type":"string","description":"URL of the link on the About page of the YouTube channel.","isRequired":true,"uniqueKey":"data.basicYoutube.links.items.[INDEX].url","typeLabel":"string"}},"required":["title","url"],"uniqueKey":"data.basicYoutube.links.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"data.basicYoutube.links","typeLabel":"object[]"},"hashtags":{"type":"array","description":"Collection of hashtags that are included in all YouTube videos.","items":{"type":"string","uniqueKey":"data.basicYoutube.hashtags.items.[INDEX]","typeLabel":"string"},"isRequired":true,"uniqueKey":"data.basicYoutube.hashtags","typeLabel":"string[]"},"mainCategory":{"type":"string","description":"The most common YouTube category selected by the creator from a list of default categories.","isRequired":true,"uniqueKey":"data.basicYoutube.mainCategory","typeLabel":"string"},"topicIds":{"type":"array","description":"Subcategories assigned to the default YouTube parent categories by CreatorDB's system.","items":{"type":"string","uniqueKey":"data.basicYoutube.topicIds.items.[INDEX]","typeLabel":"string"},"isRequired":true,"uniqueKey":"data.basicYoutube.topicIds","typeLabel":"string[]"},"nicheIds":{"type":"array","description":"Niches assigned by CreatorDB's system to improve the content category keywords.","items":{"type":"string","uniqueKey":"data.basicYoutube.nicheIds.items.[INDEX]","typeLabel":"string"},"isRequired":true,"uniqueKey":"data.basicYoutube.nicheIds","typeLabel":"string[]"},"avgLength1Y":{"type":"number","description":"Average video length in seconds for up to 800 YouTube videos uploaded in one year.","isRequired":true,"uniqueKey":"data.basicYoutube.avgLength1Y","typeLabel":"number"},"avgLikes1Y":{"type":"number","description":"Average likes per video for up to 800 YouTube videos uploaded in one year.","isRequired":true,"uniqueKey":"data.basicYoutube.avgLikes1Y","typeLabel":"number"},"avgComments1Y":{"type":"number","description":"Average comments per video for up to 800 YouTube videos uploaded in one year.","isRequired":true,"uniqueKey":"data.basicYoutube.avgComments1Y","typeLabel":"number"},"avgSelfCommentRatio1Y":{"type":"number","description":"The YouTube creator's self-comment ratio per video in one year.","isRequired":true,"uniqueKey":"data.basicYoutube.avgSelfCommentRatio1Y","typeLabel":"number"},"avgCommentLikeRatio1Y":{"type":"number","description":"Average comments to likes ratio per YouTube video in one year.","isRequired":true,"uniqueKey":"data.basicYoutube.avgCommentLikeRatio1Y","typeLabel":"number"},"avgCommentReplyRatio1Y":{"type":"number","description":"Average comments to replies ratio per YouTube video in one year.","isRequired":true,"uniqueKey":"data.basicYoutube.avgCommentReplyRatio1Y","typeLabel":"number"},"avgViews1Y":{"type":"number","description":"Average views per YouTube video for up to 800 videos uploaded in one year.","isRequired":true,"uniqueKey":"data.basicYoutube.avgViews1Y","typeLabel":"number"},"engageRate1Y":{"type":"number","description":"The average engagement rate for up to 800 YouTube videos uploaded in one year. The YouTube engagement rate is calculated by adding likes and comments and then dividing by views.","isRequired":true,"uniqueKey":"data.basicYoutube.engageRate1Y","typeLabel":"number"},"avgLengthR20":{"type":"number","description":"Average video length in seconds for the YouTube creator's most recent 20 YouTube videos uploaded.","isRequired":true,"uniqueKey":"data.basicYoutube.avgLengthR20","typeLabel":"number"},"avgLikesR20":{"type":"number","description":"Average likes per video for the YouTube creator's latest 20 uploaded videos.","isRequired":true,"uniqueKey":"data.basicYoutube.avgLikesR20","typeLabel":"number"},"avgCommentsR20":{"type":"number","description":"Average comments per video for this YouTube creator's latest 20 uploaded videos.","isRequired":true,"uniqueKey":"data.basicYoutube.avgCommentsR20","typeLabel":"number"},"avgSelfCommentRatioR20":{"type":"number","description":"The YouTube creator's self-comment ratio per video among the most recent 20 comments.","isRequired":true,"uniqueKey":"data.basicYoutube.avgSelfCommentRatioR20","typeLabel":"number"},"avgCommentLikeRatioR20":{"type":"number","description":"The ratio of the creator's self-likes divided by the top 20 comments is averaged from the most recent 20 videos to find the creator's engagement rate.","isRequired":true,"uniqueKey":"data.basicYoutube.avgCommentLikeRatioR20","typeLabel":"number"},"avgCommentReplyRatioR20":{"type":"number","description":"Average comments to replies ratio for the latest 20 comments per YouTube video.","isRequired":true,"uniqueKey":"data.basicYoutube.avgCommentReplyRatioR20","typeLabel":"number"},"avgViewsR20":{"type":"number","description":"Average views per YouTube video for the latest 20 uploaded pieces of content.","isRequired":true,"uniqueKey":"data.basicYoutube.avgViewsR20","typeLabel":"number"},"engageRateR20":{"type":"number","description":"Average engagement rate of the YouTube creator's latest 20 uploaded pieces of content.","isRequired":true,"uniqueKey":"data.basicYoutube.engageRateR20","typeLabel":"number"},"gRateSubscribers":{"type":"number","description":"The growth rate of the YouTube channel subscribers over 30 days.","isRequired":true,"uniqueKey":"data.basicYoutube.gRateSubscribers","typeLabel":"number"},"gRateViews":{"type":"number","description":"The growth rate of the YouTube creator's total video views over 30 days.","isRequired":true,"uniqueKey":"data.basicYoutube.gRateViews","typeLabel":"number"},"gRateAvgViewsR20":{"type":"number","description":"The growth rate for average views of the YouTube creator's most recent 20 posts over 30 days.","isRequired":true,"uniqueKey":"data.basicYoutube.gRateAvgViewsR20","typeLabel":"number"},"gRateEngageRateR20":{"type":"number","description":"The growth rate for engagement rate of the YouTube creator's most recent 20 posts over 30 days.","isRequired":true,"uniqueKey":"data.basicYoutube.gRateEngageRateR20","typeLabel":"number"},"recentVideos":{"type":"array","items":{"type":"object","additionalProperties":false,"properties":{"uploadDate":{"type":"number","description":"Unix timestamp of the YouTube video upload time.","isRequired":true,"uniqueKey":"data.basicYoutube.recentVideos.items.[INDEX].uploadDate","typeLabel":"number"},"videoId":{"type":"string","description":"Unique ID of the video that is auto-generated.","isRequired":true,"uniqueKey":"data.basicYoutube.recentVideos.items.[INDEX].videoId","typeLabel":"string"},"length":{"type":"number","description":"Length of the YouTube video in seconds.","isRequired":true,"uniqueKey":"data.basicYoutube.recentVideos.items.[INDEX].length","typeLabel":"number"},"title":{"type":"string","description":"The title of the YouTube video.","isRequired":true,"uniqueKey":"data.basicYoutube.recentVideos.items.[INDEX].title","typeLabel":"string"},"likes":{"type":"number","description":"The number of likes the YouTube video received.","isRequired":true,"uniqueKey":"data.basicYoutube.recentVideos.items.[INDEX].likes","typeLabel":"number"},"comments":{"type":"number","description":"The number of comments on this YouTube video.","isRequired":true,"uniqueKey":"data.basicYoutube.recentVideos.items.[INDEX].comments","typeLabel":"number"},"selfCommentRatio":{"type":"number","description":"The ratio of the YouTube creator's self-comments to recent 20 comments.","isRequired":true,"uniqueKey":"data.basicYoutube.recentVideos.items.[INDEX].selfCommentRatio","typeLabel":"number"},"commentLikeRatio":{"type":"number","description":"The ratio of comments to likes for this YouTube video.","isRequired":true,"uniqueKey":"data.basicYoutube.recentVideos.items.[INDEX].commentLikeRatio","typeLabel":"number"},"commentReplyRatio":{"type":"number","description":"The ratio of comments to the YouTube creator replies for this video.","isRequired":true,"uniqueKey":"data.basicYoutube.recentVideos.items.[INDEX].commentReplyRatio","typeLabel":"number"},"views":{"type":"number","description":"The number of views for the YouTube video.","isRequired":true,"uniqueKey":"data.basicYoutube.recentVideos.items.[INDEX].views","typeLabel":"number"},"engageRate":{"type":"number","description":"The engagement rate of this YouTube video. The engagement rate is calculated by adding the likes and comments and then dividing by the number of video views.","isRequired":true,"uniqueKey":"data.basicYoutube.recentVideos.items.[INDEX].engageRate","typeLabel":"number"},"category":{"type":"string","description":"The video category assigned by the YouTube creator from a default category list.","isRequired":true,"uniqueKey":"data.basicYoutube.recentVideos.items.[INDEX].category","typeLabel":"string"},"lang":{"type":"string","description":"Language of the YouTube video.","isRequired":true,"uniqueKey":"data.basicYoutube.recentVideos.items.[INDEX].lang","typeLabel":"string"},"isPaidPromote":{"type":"boolean","description":"It is TRUE when the YouTube creator flags the video as containing an advertisement.","isRequired":true,"uniqueKey":"data.basicYoutube.recentVideos.items.[INDEX].isPaidPromote","typeLabel":"boolean"},"isStreaming":{"type":"boolean","description":"It is TRUE when the YouTube video is a live stream.","isRequired":true,"uniqueKey":"data.basicYoutube.recentVideos.items.[INDEX].isStreaming","typeLabel":"boolean"},"isShorts":{"type":"boolean","description":"It is TRUE when the video is a YouTube short.","isRequired":true,"uniqueKey":"data.basicYoutube.recentVideos.items.[INDEX].isShorts","typeLabel":"boolean"},"hashtags":{"type":"array","description":"Hashtags that are included in this YouTube video.","items":{"type":"string","uniqueKey":"data.basicYoutube.recentVideos.items.[INDEX].hashtags.items.[INDEX]","typeLabel":"string"},"isRequired":true,"uniqueKey":"data.basicYoutube.recentVideos.items.[INDEX].hashtags","typeLabel":"string[]"}},"required":["uploadDate","videoId","length","title","likes","comments","selfCommentRatio","commentLikeRatio","commentReplyRatio","views","engageRate","category","lang","isPaidPromote","isStreaming","isShorts","hashtags"],"uniqueKey":"data.basicYoutube.recentVideos.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"data.basicYoutube.recentVideos","typeLabel":"object[]"}},"required":["youtubeId","youtubeName","displayId","instagramId","tiktokId","avatar","hasEmail","subscribers","views","country","lang","createDate","lastUploadTime","links","hashtags","mainCategory","topicIds","nicheIds","avgLength1Y","avgLikes1Y","avgComments1Y","avgSelfCommentRatio1Y","avgCommentLikeRatio1Y","avgCommentReplyRatio1Y","avgViews1Y","engageRate1Y","avgLengthR20","avgLikesR20","avgCommentsR20","avgSelfCommentRatioR20","avgCommentLikeRatioR20","avgCommentReplyRatioR20","avgViewsR20","engageRateR20","gRateSubscribers","gRateViews","gRateAvgViewsR20","gRateEngageRateR20","recentVideos"],"isRequired":true,"uniqueKey":"data.basicYoutube","typeLabel":"object"},"histories":{"type":"array","items":{"type":"object","additionalProperties":false,"properties":{"timestamp":{"type":"number","description":"Unix timestamp of when the YouTube data snapshot was collected.","isRequired":true,"uniqueKey":"data.histories.items.[INDEX].timestamp","typeLabel":"number"},"subscribers":{"type":"number","description":"Total subscribers of this YouTube channel.","isRequired":true,"uniqueKey":"data.histories.items.[INDEX].subscribers","typeLabel":"number"},"likes":{"type":"number","description":"Total likes of this YouTube channel.","isRequired":true,"uniqueKey":"data.histories.items.[INDEX].likes","typeLabel":"number"},"comments":{"type":"number","description":"Total number of comments on a YouTube creator's channel.","isRequired":true,"uniqueKey":"data.histories.items.[INDEX].comments","typeLabel":"number"},"views":{"type":"number","description":"Total views of this YouTube channel.","isRequired":true,"uniqueKey":"data.histories.items.[INDEX].views","typeLabel":"number"},"avgLength1Y":{"type":"number","description":"The average video length in seconds for up to 800 videos uploaded last year.","isRequired":true,"uniqueKey":"data.histories.items.[INDEX].avgLength1Y","typeLabel":"number"},"avgLikes1Y":{"type":"number","description":"The average likes per video for up to 800 videos uploaded last year.","isRequired":true,"uniqueKey":"data.histories.items.[INDEX].avgLikes1Y","typeLabel":"number"},"avgComments1Y":{"type":"number","description":"The average comments per video for up to 800 videos uploaded last year.","isRequired":true,"uniqueKey":"data.histories.items.[INDEX].avgComments1Y","typeLabel":"number"},"avgSelfCommentRatio1Y":{"type":"number","description":"The ratio of the YouTube creator's self-comments per video to total comments on a specified date in one year.","isRequired":true,"uniqueKey":"data.histories.items.[INDEX].avgSelfCommentRatio1Y","typeLabel":"number"},"avgCommentLikeRatio1Y":{"type":"number","description":"The ratio of average comments per video to likes on a specified date in one year.","isRequired":true,"uniqueKey":"data.histories.items.[INDEX].avgCommentLikeRatio1Y","typeLabel":"number"},"avgCommentReplyRatio1Y":{"type":"number","description":"The ratio of average comments per video to replies on a specified date in one year.","isRequired":true,"uniqueKey":"data.histories.items.[INDEX].avgCommentReplyRatio1Y","typeLabel":"number"},"avgViews1Y":{"type":"number","description":"The average number of views per video for up to 800 videos uploaded last year.","isRequired":true,"uniqueKey":"data.histories.items.[INDEX].avgViews1Y","typeLabel":"number"},"engageRate1Y":{"type":"number","description":"The average engagement rate for a YouTube video is based on up to 800 videos uploaded last year.","isRequired":true,"uniqueKey":"data.histories.items.[INDEX].engageRate1Y","typeLabel":"number"},"avgLengthR20":{"type":"number","description":"The average video length in seconds for the YouTube creator's recent 20 uploads.","isRequired":true,"uniqueKey":"data.histories.items.[INDEX].avgLengthR20","typeLabel":"number"},"avgLikesR20":{"type":"number","description":"The average likes per video for the YouTube creator's recent 20 uploads.","isRequired":true,"uniqueKey":"data.histories.items.[INDEX].avgLikesR20","typeLabel":"number"},"avgCommentsR20":{"type":"number","description":"The average comments per video for the YouTube creator's recent 20 uploads.","isRequired":true,"uniqueKey":"data.histories.items.[INDEX].avgCommentsR20","typeLabel":"number"},"avgSelfCommentRatioR20":{"type":"number","description":"The ratio of the YouTube creator's self-comments per video to the top 20 comments on a specified date in one year.","isRequired":true,"uniqueKey":"data.histories.items.[INDEX].avgSelfCommentRatioR20","typeLabel":"number"},"avgCommentLikeRatioR20":{"type":"number","description":"The ratio of average top 20 comments per video to likes for a specified date in one year.","isRequired":true,"uniqueKey":"data.histories.items.[INDEX].avgCommentLikeRatioR20","typeLabel":"number"},"avgCommentReplyRatioR20":{"type":"number","description":"The ratio of average top 20 comments per video to replies for a specific date in one year.","isRequired":true,"uniqueKey":"data.histories.items.[INDEX].avgCommentReplyRatioR20","typeLabel":"number"},"avgViewsR20":{"type":"number","description":"The average number of views per video for the YouTube creator's recent 20 uploads.","isRequired":true,"uniqueKey":"data.histories.items.[INDEX].avgViewsR20","typeLabel":"number"},"engageRateR20":{"type":"number","description":"The average engagement rate for a video is based on the YouTube creator's recent 20 videos.","isRequired":true,"uniqueKey":"data.histories.items.[INDEX].engageRateR20","typeLabel":"number"}},"required":["timestamp","subscribers","likes","comments","views","avgLength1Y","avgLikes1Y","avgComments1Y","avgSelfCommentRatio1Y","avgCommentLikeRatio1Y","avgCommentReplyRatio1Y","avgViews1Y","engageRate1Y","avgLengthR20","avgLikesR20","avgCommentsR20","avgSelfCommentRatioR20","avgCommentLikeRatioR20","avgCommentReplyRatioR20","avgViewsR20","engageRateR20"],"uniqueKey":"data.histories.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"data.histories","typeLabel":"object[]"}},"required":["basicYoutube","histories"],"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":1755503514817,"error":"APIKeyOnlyForTesting","success":false}}},"exampleType":"examples"}},"exampleType":"examples"}},"security":{},"servers":{"d5996677-d55e-415e-a795-080585fec070":{"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 YouTube historical data - CreatorDB Documentation Center","navMaps":{"firstHrefInVersion":{"3.0":{"href":"/api-reference/general-operations/get-api-usage","matchLevel":2},"2.0":{"href":"/api-reference/youtube/get-youtube-historical-data","matchLevel":0}},"firstHrefInLanguage":{}},"originalFileLocation":"api-reference/youtube/get-youtube-historical-data.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 the basic metrics and historical data of a creator\u0026#x27;s YouTube account.\">\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 YouTube historical data - CreatorDB Documentation Center\">\u003cmeta data-mint-head property=\"og:description\" content=\"Get the basic metrics and historical data of a creator\u0026#x27;s YouTube account.\">\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/youtube/get-youtube-historical-data\">\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=YouTube\u0026amp;title=Get+YouTube+historical+data\u0026amp;description=Get+the+basic+metrics+and+historical+data+of+a+creator%27s+YouTube+account.\u0026amp;theme=4f6f7d6d515d76d22bdf1025\u0026amp;signature=6d9c9c7e7f509c43383d3ee5ee19195418be9715b68a9f11718ee29cce0e3156\">\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 YouTube historical data - CreatorDB Documentation Center\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Get the basic metrics and historical data of a creator\u0026#x27;s YouTube account.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://creatordb-589c46f5.mintlify.site/_mintlify/api/og/v2?division=YouTube\u0026amp;title=Get+YouTube+historical+data\u0026amp;description=Get+the+basic+metrics+and+historical+data+of+a+creator%27s+YouTube+account.\u0026amp;theme=4f6f7d6d515d76d22bdf1025\u0026amp;signature=6d9c9c7e7f509c43383d3ee5ee19195418be9715b68a9f11718ee29cce0e3156\">\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/youtube/get-youtube-historical-data\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/youtube/get-youtube-historical-data.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/youtube/get-youtube-historical-data#webpage\",\"url\":\"https://docs.creatordb.app/api-reference/youtube/get-youtube-historical-data\",\"name\":\"Get YouTube historical data\",\"description\":\"Get the basic metrics and historical data of a creator's YouTube account.\",\"isPartOf\":{\"@id\":\"https://docs.creatordb.app#website\"},\"breadcrumb\":{\"@id\":\"https://docs.creatordb.app/api-reference/youtube/get-youtube-historical-data#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.creatordb.app/api-reference/youtube/get-youtube-historical-data#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\":\"YouTube\",\"item\":\"https://docs.creatordb.app/api-reference/youtube/get-basic-youtube-metrics\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"Get YouTube historical data\",\"item\":\"https://docs.creatordb.app/api-reference/youtube/get-youtube-historical-data\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.creatordb.app/api-reference/youtube/get-youtube-historical-data#apireference\",\"headline\":\"Get YouTube historical data\",\"name\":\"Get YouTube historical data\",\"description\":\"Get the basic metrics and historical data of a creator's YouTube account.\",\"url\":\"https://docs.creatordb.app/api-reference/youtube/get-youtube-historical-data\",\"mainEntityOfPage\":{\"@id\":\"https://docs.creatordb.app/api-reference/youtube/get-youtube-historical-data#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","description":"Get the basic metrics data of a creator's YouTube account.","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","description":"Get detailed data on a creator's YouTube account, such as channel categories, channel rankings, audience demographics, and more.","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","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","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 YouTube historical data - 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"]}