Retrieve daily performance snapshots for a specified TikTok creator within a specific period, including upload activity, follower growth, engagement metrics, and video performance. Dates are returned as Unix timestamps in milliseconds.
{"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}},"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":""},"chroma":{"liveDeploymentHistoryId":"6ade9a9f8dc007203f185c3c","collectionId":"6e031f37-6190-4caf-9db0-1a4b0fc66bd1","schemaVersion":"v3","latestBuiltDeploymentHistoryId":"6ade9a9f8dc007203f185c3c"},"entitlements":{"AI_CHAT":{"status":"ENABLED"},"WEB_MCP":{"status":"ENABLED"},"NARRATION":{"status":"ENABLED"}},"buildId":"6ade9a9f8dc007203f185c3c","clientVersion":"0.0.3971","searchFilterCounts":[{"language":"default","tag":"CreatorDB API","count":106},{"language":"default","tag":"API Endpoints","count":71},{"language":"default","tag":"API Reference","count":60},{"language":"default","tag":"CreatorDB App","count":26},{"language":"default","tag":"YouTube","count":19},{"language":"default","tag":"User Guides","count":17},{"language":"default","tag":"CreatorDB User Guide","count":16},{"language":"default","tag":"Creator Analytics by CreatorDB","count":13},{"language":"default","tag":"Creator Analytics by CreatorDB User Guide","count":13},{"language":"default","tag":"Instagram","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":"editor-v7-file-tree","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":"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":"pause-universal-search-reconcile","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":"per-site-search-delta","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":"editor-private-page-search","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":"editor-nav-generations","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":"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":"byok-sep-25","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"vite-origin","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-agent-model-picker","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-updated-9-15","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":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"isAtlas":false,"googleFontsInlined":false},"customCss":[{"filePath":"style.css","content":"#navbar{padding:.3rem}.nav-logo{height:100px!important;width:auto!important}code{white-space:pre-wrap}footer{margin-top:2rem}"}],"page":{"pagePath":"api-reference/tiktok/get-performance-history","slug":"/api-reference/tiktok/get-performance-history","pageMetadata":{"title":"Get Performance History","description":"Retrieve daily performance snapshots for a specified TikTok creator within a specific period, including upload activity, follower growth, engagement metrics, and video performance. Dates are returned as Unix timestamps in milliseconds.","deprecated":null,"version":null,"openapi":"/api-v3/api-v3.yaml get /tiktok/performance-history","href":"/api-reference/tiktok/get-performance-history","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: \"Retrieve daily performance snapshots for a specified TikTok creator within a specific period, including upload activity, follower growth, engagement metrics, and video performance. Dates are returned as Unix timestamps in milliseconds.\"\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 Performance History","description":"Retrieve daily performance snapshots for a specified TikTok creator within a specific period, including upload activity, follower growth, engagement metrics, and video performance. Dates are returned as Unix timestamps in milliseconds.","deprecated":null,"version":null,"openapi":"/api-v3/api-v3.yaml get /tiktok/performance-history","href":"/api-reference/tiktok/get-performance-history","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"tags":["TikTok"],"summary":"Get Performance History","description":"Retrieve daily performance snapshots for a specified TikTok creator within a specific period, including upload activity, follower growth, engagement metrics, and video performance. Dates are returned as Unix timestamps in milliseconds.","operationId":"getTiktokPerformanceHistory","parameters":["318aac9e-7ec2-4094-8c7f-a7b4b81ece09","63c8ae25-0ed7-4fa8-b83e-29d781e161c6"],"x-codeSamples":[{"lang":"bash","label":"cURL","source":"curl -X GET \"https://apiv3.creatordb.app/tiktok/performance-history?uniqueId=charlidamelio\u0026pastDayRange=30\" \\\n -H \"Content-Type: application/json\" \\\n -H \"api-key: \u003cYOUR_API_KEY_HERE>\"\n"}],"responses":{"200":"3f64ffa9-ae3f-4b48-b9d7-2f994ad72ab5","400":"076836e4-3180-4e36-a8ff-b971af276d6f","429":"4c2152fd-951d-4916-aec9-7a8f94d58b33"},"security":["240c7ac2-977e-4d68-bb73-fa5e341620c0"],"servers":["1b35eb6a-9129-44a5-85d4-a36fe76cd77e"],"method":"get","type":"path","path":"/tiktok/performance-history","baseUrlOptions":["https://apiv3.creatordb.app"],"title":"Get Performance History","codeSamples":[{"label":"cURL","lang":"bash","source":"curl -X GET \"https://apiv3.creatordb.app/tiktok/performance-history?uniqueId=charlidamelio\u0026pastDayRange=30\" \\\n -H \"Content-Type: application/json\" \\\n -H \"api-key: \u003cYOUR_API_KEY_HERE>\"\n"}],"requestExampleLanguages":["bash","bash","javascript","python","php","ruby","go","java"],"requiredOnlyExamples":false,"requestExampleType":"codeSamples","responseExampleType":"generated","prefillPlaygroundWithExample":true,"prefillPlaygroundExamples":[]},"dependencies":{"parameters":{"318aac9e-7ec2-4094-8c7f-a7b4b81ece09":{"name":"uniqueId","in":"query","description":"TikTok account ID. Accepts `tiktok` or `@tiktok` (@ is stripped automatically).","required":true,"schema":{"type":"string","pattern":"^@?[a-zA-Z0-9._-]{1,24}$","minLength":1,"maxLength":25,"examples":["tiktok"],"isRequired":true,"description":"TikTok account ID. Accepts `tiktok` or `@tiktok` (@ is stripped automatically).","uniqueKey":"","typeLabel":"string"}},"63c8ae25-0ed7-4fa8-b83e-29d781e161c6":{"name":"pastDayRange","in":"query","description":"Returns one data point per day over the requested range. For example, `30` returns the past 30 days of daily snapshots. Valid range: `1`-`365`.","required":true,"schema":{"type":"string","pattern":"^[1-9]\\d*$","examples":["30"],"isRequired":true,"description":"Returns one data point per day over the requested range. For example, `30` returns the past 30 days of daily snapshots. Valid range: `1`-`365`.","uniqueKey":"","typeLabel":"string"}}},"responses":{"3f64ffa9-ae3f-4b48-b9d7-2f994ad72ab5":{"description":"TikTok performance historical data returned successfully.","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","description":"The historical performance metrics of the specified TikTok account.","properties":{"histories":{"type":"array","description":"Historical performance snapshots, each containing metrics, and a corresponding Unix timestamp in milliseconds.","items":{"type":"object","description":"A snapshot of the performance metrics on the specified date.","properties":{"timestamp":{"type":"integer","description":"The performance snapshot date, represented as a Unix timestamp in milliseconds.","exclusiveMinimum":0,"examples":[1755273600000],"isRequired":true,"uniqueKey":"data.histories.items.[INDEX].timestamp","typeLabel":"integer"},"totalFollowers":{"type":"integer","description":"Total number of followers.","minimum":0,"examples":[38100],"isRequired":true,"uniqueKey":"data.histories.items.[INDEX].totalFollowers","typeLabel":"integer"},"totalFollowing":{"type":"integer","description":"Total number of accounts followed.","minimum":0,"examples":[4757],"isRequired":true,"uniqueKey":"data.histories.items.[INDEX].totalFollowing","typeLabel":"integer"},"totalContents":{"type":"integer","description":"Total number of videos.","minimum":0,"examples":[305],"isRequired":true,"uniqueKey":"data.histories.items.[INDEX].totalContents","typeLabel":"integer"},"videosPerformanceRecent":{"type":"object","description":"Performance metrics of the most recent TikTok videos.","properties":{"likes":{"type":"object","properties":{"all":{"type":"integer","description":"Total number of likes.","minimum":0,"examples":[2944445],"isRequired":true,"uniqueKey":"data.histories.items.[INDEX].videosPerformanceRecent.likes.all","typeLabel":"integer"},"avg":{"type":"integer","description":"Average likes per video, rounded to an integer.","minimum":0,"examples":[100],"isRequired":true,"uniqueKey":"data.histories.items.[INDEX].videosPerformanceRecent.likes.avg","typeLabel":"integer"},"median":{"type":"integer","description":"Median number of likes.","minimum":0,"examples":[48],"isRequired":true,"uniqueKey":"data.histories.items.[INDEX].videosPerformanceRecent.likes.median","typeLabel":"integer"},"min":{"type":"integer","description":"Minimum number of likes.","minimum":0,"examples":[20],"isRequired":true,"uniqueKey":"data.histories.items.[INDEX].videosPerformanceRecent.likes.min","typeLabel":"integer"},"max":{"type":"integer","description":"Maximum number of likes.","minimum":0,"examples":[149],"isRequired":true,"uniqueKey":"data.histories.items.[INDEX].videosPerformanceRecent.likes.max","typeLabel":"integer"}},"required":["all","avg","median","min","max"],"isRequired":true,"uniqueKey":"data.histories.items.[INDEX].videosPerformanceRecent.likes","typeLabel":"object"},"comments":{"type":"object","properties":{"all":{"type":"integer","description":"Total number of comments.","minimum":0,"examples":[222344],"isRequired":true,"uniqueKey":"data.histories.items.[INDEX].videosPerformanceRecent.comments.all","typeLabel":"integer"},"avg":{"type":"integer","description":"Average comments per video, rounded to an integer.","minimum":0,"examples":[100],"isRequired":true,"uniqueKey":"data.histories.items.[INDEX].videosPerformanceRecent.comments.avg","typeLabel":"integer"},"median":{"type":"integer","description":"Median number of comments.","minimum":0,"examples":[48],"isRequired":true,"uniqueKey":"data.histories.items.[INDEX].videosPerformanceRecent.comments.median","typeLabel":"integer"},"min":{"type":"integer","description":"Minimum number of comments.","minimum":0,"examples":[20],"isRequired":true,"uniqueKey":"data.histories.items.[INDEX].videosPerformanceRecent.comments.min","typeLabel":"integer"},"max":{"type":"integer","description":"Maximum number of comments.","minimum":0,"examples":[149],"isRequired":true,"uniqueKey":"data.histories.items.[INDEX].videosPerformanceRecent.comments.max","typeLabel":"integer"}},"required":["all","avg","median","min","max"],"isRequired":true,"uniqueKey":"data.histories.items.[INDEX].videosPerformanceRecent.comments","typeLabel":"object"},"views":{"type":"object","properties":{"all":{"type":"integer","description":"Total number of views.","minimum":0,"examples":[3599],"isRequired":true,"uniqueKey":"data.histories.items.[INDEX].videosPerformanceRecent.views.all","typeLabel":"integer"},"avg":{"type":"integer","description":"Average views per video, rounded to an integer.","minimum":0,"examples":[100],"isRequired":true,"uniqueKey":"data.histories.items.[INDEX].videosPerformanceRecent.views.avg","typeLabel":"integer"},"median":{"type":"integer","description":"Median number of views.","minimum":0,"examples":[48],"isRequired":true,"uniqueKey":"data.histories.items.[INDEX].videosPerformanceRecent.views.median","typeLabel":"integer"},"min":{"type":"integer","description":"Minimum number of views.","minimum":0,"examples":[20],"isRequired":true,"uniqueKey":"data.histories.items.[INDEX].videosPerformanceRecent.views.min","typeLabel":"integer"},"max":{"type":"integer","description":"Maximum number of views.","minimum":0,"examples":[149],"isRequired":true,"uniqueKey":"data.histories.items.[INDEX].videosPerformanceRecent.views.max","typeLabel":"integer"}},"required":["all","avg","median","min","max"],"isRequired":true,"uniqueKey":"data.histories.items.[INDEX].videosPerformanceRecent.views","typeLabel":"object"},"shares":{"type":"object","properties":{"all":{"type":"integer","description":"Total number of shares.","minimum":0,"examples":[3599],"isRequired":true,"uniqueKey":"data.histories.items.[INDEX].videosPerformanceRecent.shares.all","typeLabel":"integer"},"avg":{"type":"integer","description":"Average shares per video, rounded to an integer.","minimum":0,"examples":[100],"isRequired":true,"uniqueKey":"data.histories.items.[INDEX].videosPerformanceRecent.shares.avg","typeLabel":"integer"},"median":{"type":"integer","description":"Median number of shares.","minimum":0,"examples":[48],"isRequired":true,"uniqueKey":"data.histories.items.[INDEX].videosPerformanceRecent.shares.median","typeLabel":"integer"},"min":{"type":"integer","description":"Minimum number of shares.","minimum":0,"examples":[20],"isRequired":true,"uniqueKey":"data.histories.items.[INDEX].videosPerformanceRecent.shares.min","typeLabel":"integer"},"max":{"type":"integer","description":"Maximum number of shares.","minimum":0,"examples":[149],"isRequired":true,"uniqueKey":"data.histories.items.[INDEX].videosPerformanceRecent.shares.max","typeLabel":"integer"}},"required":["all","avg","median","min","max"],"isRequired":true,"uniqueKey":"data.histories.items.[INDEX].videosPerformanceRecent.shares","typeLabel":"object"},"engagement":{"type":"object","description":"Engagement performance metrics including rates, per-follower statistics, and consistency analysis.","properties":{"avgEngagementRate":{"type":"number","description":"Average engagement rate per video, rounded to 4th decimal place. \u003cbr />\n - *Engagement Rate \u0026#61; (Likes + Comments + Shares)/ Views*","minimum":0,"examples":[0.5201],"isRequired":true,"uniqueKey":"data.histories.items.[INDEX].videosPerformanceRecent.engagement.avgEngagementRate","typeLabel":"number"},"likesPerFollower":{"type":"number","description":"Average likes per follower, rounded to 4th decimal place.","minimum":0,"examples":[0.1111],"isRequired":true,"uniqueKey":"data.histories.items.[INDEX].videosPerformanceRecent.engagement.likesPerFollower","typeLabel":"number"},"commentsPerFollower":{"type":"number","description":"Average comments per follower, rounded to 4th decimal place.","minimum":0,"examples":[0.1111],"isRequired":true,"uniqueKey":"data.histories.items.[INDEX].videosPerformanceRecent.engagement.commentsPerFollower","typeLabel":"number"},"viewsPerFollower":{"type":"number","description":"Average views per follower, rounded to 4th decimal place.","minimum":0,"examples":[0.1111],"isRequired":true,"uniqueKey":"data.histories.items.[INDEX].videosPerformanceRecent.engagement.viewsPerFollower","typeLabel":"number"},"engagementConsistency":{"type":"object","description":"Consistency of engagement performance.","properties":{"cv":{"type":"number","description":"*cv \u0026#61; Standard Deviation of Engagement Rate/ Mean Engagement Rate* \u003cbr />\n- The value is rounded to 4th decimal place. \u003cbr />\n- Lower values indicate more consistent performance. \u003cbr />\n- *A value of `0` indicates insufficient data.*","minimum":0,"examples":[0.1201],"isRequired":true,"uniqueKey":"data.histories.items.[INDEX].videosPerformanceRecent.engagement.engagementConsistency.cv","typeLabel":"number"},"medianVsMean":{"type":"number","description":"*medianVsMean \u0026#61; Median Engagement Rate/ Mean Engagement Rate* \u003cbr />\n- The value is rounded to 4th decimal place. \u003cbr />\n- Values closer to `1` indicate more consistent performance. \u003cbr />\n- *A value of `0` indicates insufficient data.*","minimum":0,"examples":[0.9001],"isRequired":true,"uniqueKey":"data.histories.items.[INDEX].videosPerformanceRecent.engagement.engagementConsistency.medianVsMean","typeLabel":"number"},"topBottomRatio":{"type":"number","description":"*topBottomRatio \u0026#61; avg(Top 3 Engagement)/avg(Bottom 3 Engagement)* \u003cbr />\n- The value is rounded to 4th decimal place. \u003cbr />\n- Lower ratios indicate more consistent performance. \u003cbr />\n- *A value of `0` indicates insufficient data.*","minimum":0,"examples":[1.2001],"isRequired":true,"uniqueKey":"data.histories.items.[INDEX].videosPerformanceRecent.engagement.engagementConsistency.topBottomRatio","typeLabel":"number"},"consistencyScore":{"oneOf":[{"type":"integer","description":"*consistencyScore \u0026#61; 100 - [(cvScore*weight_cv) + (topBottomScore*weight_topBottom) + (medianVsMeanScore*weight_medianVsMean)]* \u003cbr />\n- The score is rounded to an integer. \u003cbr />\n- A higher score indicates more stable and consistent performance. \u003cbr />\n- If any of the three indicators is `0`, the `consistencyScore` will be `null`.","minimum":0,"maximum":100,"examples":[63],"isRequired":true,"uniqueKey":"data.histories.items.[INDEX].videosPerformanceRecent.engagement.engagementConsistency.consistencyScore.oneOf.0","typeLabel":"integer"},{"type":"null","description":"*consistencyScore \u0026#61; 100 - [(cvScore*weight_cv) + (topBottomScore*weight_topBottom) + (medianVsMeanScore*weight_medianVsMean)]* \u003cbr />\n- The score is rounded to an integer. \u003cbr />\n- A higher score indicates more stable and consistent performance. \u003cbr />\n- If any of the three indicators is `0`, the `consistencyScore` will be `null`.","minimum":0,"maximum":100,"examples":[63],"isRequired":true,"uniqueKey":"data.histories.items.[INDEX].videosPerformanceRecent.engagement.engagementConsistency.consistencyScore.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.histories.items.[INDEX].videosPerformanceRecent.engagement.engagementConsistency.consistencyScore","typeLabel":"integer | null"},"consistencyLevel":{"oneOf":[{"type":"string","enum":["high","moderate","low",null],"description":"A qualitative label based on the `consistencyScore`: \u003cbr />\n- high: 81 - 100 \u003cbr />\n- moderate: 51 - 80 \u003cbr />\n- low: 0 - 50 \u003cbr />\n- Returns `null` when `consistencyScore` is `null`.","examples":["moderate"],"isRequired":true,"uniqueKey":"data.histories.items.[INDEX].videosPerformanceRecent.engagement.engagementConsistency.consistencyLevel.oneOf.0","typeLabel":"enum\u003cstring>"},{"type":"null","enum":["high","moderate","low",null],"description":"A qualitative label based on the `consistencyScore`: \u003cbr />\n- high: 81 - 100 \u003cbr />\n- moderate: 51 - 80 \u003cbr />\n- low: 0 - 50 \u003cbr />\n- Returns `null` when `consistencyScore` is `null`.","examples":["moderate"],"isRequired":true,"uniqueKey":"data.histories.items.[INDEX].videosPerformanceRecent.engagement.engagementConsistency.consistencyLevel.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.histories.items.[INDEX].videosPerformanceRecent.engagement.engagementConsistency.consistencyLevel","typeLabel":"enum\u003cstring> | null"}},"required":["cv","medianVsMean","topBottomRatio","consistencyScore","consistencyLevel"],"isRequired":true,"uniqueKey":"data.histories.items.[INDEX].videosPerformanceRecent.engagement.engagementConsistency","typeLabel":"object"}},"required":["avgEngagementRate","likesPerFollower","commentsPerFollower","viewsPerFollower","engagementConsistency"],"isRequired":true,"uniqueKey":"data.histories.items.[INDEX].videosPerformanceRecent.engagement","typeLabel":"object"}},"required":["likes","comments","views","shares","engagement"],"isRequired":true,"uniqueKey":"data.histories.items.[INDEX].videosPerformanceRecent","typeLabel":"object"}},"required":["timestamp","totalFollowers","totalFollowing","totalContents","videosPerformanceRecent"],"uniqueKey":"data.histories.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"data.histories","typeLabel":"object[]"}},"required":["histories"],"isRequired":true,"uniqueKey":"data","typeLabel":"object"},"creditsUsed":{"type":"number","description":"Number of API credits consumed by this request.","examples":[1],"isRequired":true,"uniqueKey":"creditsUsed","typeLabel":"number"},"creditsAvailable":{"type":"number","description":"Number of API credits remaining. Equals planCreditsAvailable plus purchasedCreditsAvailable.","examples":[-1],"isRequired":true,"uniqueKey":"creditsAvailable","typeLabel":"number"},"planCreditsAvailable":{"type":"number","description":"Remaining plan credits after this request, in credits.","examples":[900],"isRequired":true,"uniqueKey":"planCreditsAvailable","typeLabel":"number"},"purchasedCreditsAvailable":{"type":"number","description":"Remaining purchased-bucket credits after this request, in display units.","examples":[75],"isRequired":true,"uniqueKey":"purchasedCreditsAvailable","typeLabel":"number"},"traceId":{"type":"string","description":"Unique trace ID for each request.","examples":["f8e4a3b2c1d0e9f8a7b6c5d4e3f2a1b0"],"isRequired":true,"uniqueKey":"traceId","typeLabel":"string"},"timestamp":{"type":"integer","description":"Time the response was generated, represented as a Unix timestamp in milliseconds.","examples":[1750732453635],"isRequired":true,"uniqueKey":"timestamp","typeLabel":"integer"},"errorCode":{"type":"string","description":"Error code returned if the request fails. Empty if the request is successful.","examples":[""],"isRequired":true,"uniqueKey":"errorCode","typeLabel":"string"},"errorDescription":{"type":"string","description":"Description of the error. Empty if the request is successful.","examples":[""],"isRequired":true,"uniqueKey":"errorDescription","typeLabel":"string"},"success":{"type":"boolean","description":"`true` if the request is successful.","examples":[true],"isRequired":true,"uniqueKey":"success","typeLabel":"boolean"},"keyCreditsAvailable":{"type":"number","description":"Remaining credits this API key can spend after this request, before reaching its spend limit. Present only when the key has a spend limit.","examples":[4975],"uniqueKey":"keyCreditsAvailable","typeLabel":"number"}},"required":["data","traceId","timestamp","errorCode","errorDescription","success","creditsUsed","creditsAvailable","planCreditsAvailable","purchasedCreditsAvailable"],"uniqueKey":"","typeLabel":"object"},"examples":{"default":{"title":"default","value":{"data":{"histories":[{"timestamp":1767852641724,"totalFollowers":155900000,"totalFollowing":1289,"totalContents":2893,"videosPerformanceRecent":{"likes":{"all":11215700,"avg":560785,"median":226700,"min":0,"max":0},"comments":{"all":49820,"avg":2491,"median":0,"min":0,"max":0},"views":{"all":202000000,"avg":10100000,"median":7750000,"min":5000000,"max":27800000},"shares":{"all":121440,"avg":6072,"median":0,"min":0,"max":0},"engagement":{"avgEngagementRate":0.0442,"likesPerFollower":0.0036,"commentsPerFollower":0,"viewsPerFollower":0.0648,"engagementConsistency":{"cv":0.7354,"medianVsMean":0.748,"topBottomRatio":0,"consistencyScore":null,"consistencyLevel":null}}}},{"timestamp":1767766241724,"totalFollowers":156000000,"totalFollowing":1287,"totalContents":2892,"videosPerformanceRecent":{"likes":{"all":11204200,"avg":560210,"median":226500,"min":0,"max":0},"comments":{"all":49660,"avg":2483,"median":0,"min":0,"max":0},"views":{"all":201200000,"avg":10060000,"median":7650000,"min":5000000,"max":27700000},"shares":{"all":121260,"avg":6063,"median":0,"min":0,"max":0},"engagement":{"avgEngagementRate":0.0442,"likesPerFollower":0.0036,"commentsPerFollower":0,"viewsPerFollower":0.0645,"engagementConsistency":{"cv":0.7352,"medianVsMean":0.7495,"topBottomRatio":0,"consistencyScore":null,"consistencyLevel":null}}}},{"timestamp":1767679841724,"totalFollowers":156000000,"totalFollowing":1287,"totalContents":2892,"videosPerformanceRecent":{"likes":{"all":11984300,"avg":599215,"median":235450,"min":0,"max":0},"comments":{"all":50980,"avg":2549,"median":0,"min":0,"max":0},"views":{"all":203500000,"avg":10175000,"median":7600000,"min":4900000,"max":27500000},"shares":{"all":105240,"avg":5262,"median":0,"min":0,"max":0},"engagement":{"avgEngagementRate":0.0474,"likesPerFollower":0.0038,"commentsPerFollower":0,"viewsPerFollower":0.0652,"engagementConsistency":{"cv":0.6964,"medianVsMean":0.7637,"topBottomRatio":0,"consistencyScore":null,"consistencyLevel":null}}}},{"timestamp":1767593441724,"totalFollowers":156000000,"totalFollowing":1285,"totalContents":2892,"videosPerformanceRecent":{"likes":{"all":11064300,"avg":553215,"median":225950,"min":0,"max":0},"comments":{"all":49040,"avg":2452,"median":0,"min":0,"max":0},"views":{"all":197500000,"avg":9875000,"median":7550000,"min":4900000,"max":27300000},"shares":{"all":120280,"avg":6014,"median":0,"min":0,"max":0},"engagement":{"avgEngagementRate":0.0443,"likesPerFollower":0.0035,"commentsPerFollower":0,"viewsPerFollower":0.0633,"engagementConsistency":{"cv":0.7317,"medianVsMean":0.752,"topBottomRatio":0,"consistencyScore":null,"consistencyLevel":null}}}},{"timestamp":1767507041724,"totalFollowers":155900000,"totalFollowing":1290,"totalContents":2892,"videosPerformanceRecent":{"likes":{"all":11040000,"avg":552000,"median":225250,"min":0,"max":0},"comments":{"all":48640,"avg":2432,"median":0,"min":0,"max":0},"views":{"all":195200000,"avg":9760000,"median":7500000,"min":4800000,"max":27100000},"shares":{"all":119460,"avg":5973,"median":0,"min":0,"max":0},"engagement":{"avgEngagementRate":0.0445,"likesPerFollower":0.0035,"commentsPerFollower":0,"viewsPerFollower":0.0626,"engagementConsistency":{"cv":0.7338,"medianVsMean":0.7553,"topBottomRatio":0,"consistencyScore":null,"consistencyLevel":null}}}},{"timestamp":1767334241724,"totalFollowers":156000000,"totalFollowing":1290,"totalContents":2892,"videosPerformanceRecent":{"likes":{"all":11014300,"avg":550715,"median":224100,"min":0,"max":0},"comments":{"all":48120,"avg":2406,"median":0,"min":0,"max":0},"views":{"all":193100000,"avg":9655000,"median":7450000,"min":4800000,"max":26900000},"shares":{"all":118800,"avg":5940,"median":0,"min":0,"max":0},"engagement":{"avgEngagementRate":0.0447,"likesPerFollower":0.0035,"commentsPerFollower":0,"viewsPerFollower":0.0619,"engagementConsistency":{"cv":0.7335,"medianVsMean":0.7513,"topBottomRatio":0,"consistencyScore":null,"consistencyLevel":null}}}},{"timestamp":1767161441724,"totalFollowers":156000000,"totalFollowing":1290,"totalContents":2892,"videosPerformanceRecent":{"likes":{"all":10885000,"avg":544250,"median":222650,"min":0,"max":0},"comments":{"all":47520,"avg":2376,"median":0,"min":0,"max":0},"views":{"all":190700000,"avg":9535000,"median":7400000,"min":4700000,"max":26700000},"shares":{"all":117860,"avg":5893,"median":0,"min":0,"max":0},"engagement":{"avgEngagementRate":0.0448,"likesPerFollower":0.0035,"commentsPerFollower":0,"viewsPerFollower":0.0611,"engagementConsistency":{"cv":0.7311,"medianVsMean":0.7571,"topBottomRatio":0,"consistencyScore":null,"consistencyLevel":null}}}},{"timestamp":1767075041724,"totalFollowers":156000000,"totalFollowing":1290,"totalContents":2892,"videosPerformanceRecent":{"likes":{"all":11769800,"avg":588490,"median":231050,"min":0,"max":0},"comments":{"all":48800,"avg":2440,"median":0,"min":0,"max":0},"views":{"all":193300000,"avg":9665000,"median":7350000,"min":4700000,"max":26500000},"shares":{"all":101960,"avg":5098,"median":0,"min":0,"max":0},"engagement":{"avgEngagementRate":0.0482,"likesPerFollower":0.0038,"commentsPerFollower":0,"viewsPerFollower":0.062,"engagementConsistency":{"cv":0.6949,"medianVsMean":0.7591,"topBottomRatio":0,"consistencyScore":null,"consistencyLevel":null}}}},{"timestamp":1766988641724,"totalFollowers":156000000,"totalFollowing":1290,"totalContents":2891,"videosPerformanceRecent":{"likes":{"all":11638900,"avg":581945,"median":229400,"min":0,"max":0},"comments":{"all":48240,"avg":2412,"median":0,"min":0,"max":0},"views":{"all":190500000,"avg":9525000,"median":7250000,"min":4600000,"max":26200000},"shares":{"all":100900,"avg":5045,"median":0,"min":0,"max":0},"engagement":{"avgEngagementRate":0.0482,"likesPerFollower":0.0037,"commentsPerFollower":0,"viewsPerFollower":0.0611,"engagementConsistency":{"cv":0.6905,"medianVsMean":0.7632,"topBottomRatio":0,"consistencyScore":null,"consistencyLevel":null}}}},{"timestamp":1766729441724,"totalFollowers":156000000,"totalFollowing":1290,"totalContents":2891,"videosPerformanceRecent":{"likes":{"all":11487300,"avg":574365,"median":220450,"min":0,"max":0},"comments":{"all":47220,"avg":2361,"median":0,"min":0,"max":0},"views":{"all":185600000,"avg":9280000,"median":7100000,"min":4500000,"max":25300000},"shares":{"all":98820,"avg":4941,"median":0,"min":0,"max":0},"engagement":{"avgEngagementRate":0.0487,"likesPerFollower":0.0037,"commentsPerFollower":0,"viewsPerFollower":0.0595,"engagementConsistency":{"cv":0.6899,"medianVsMean":0.7584,"topBottomRatio":0,"consistencyScore":null,"consistencyLevel":null}}}},{"timestamp":1766383841724,"totalFollowers":156000000,"totalFollowing":1290,"totalContents":2891,"videosPerformanceRecent":{"likes":{"all":11317300,"avg":565865,"median":214300,"min":0,"max":0},"comments":{"all":45960,"avg":2298,"median":0,"min":0,"max":0},"views":{"all":179000000,"avg":8950000,"median":6800000,"min":4400000,"max":23600000},"shares":{"all":95080,"avg":4754,"median":0,"min":0,"max":0},"engagement":{"avgEngagementRate":0.0493,"likesPerFollower":0.0036,"commentsPerFollower":0,"viewsPerFollower":0.0574,"engagementConsistency":{"cv":0.6945,"medianVsMean":0.7539,"topBottomRatio":0,"consistencyScore":null,"consistencyLevel":null}}}}]},"creditsUsed":1,"creditsAvailable":975,"planCreditsAvailable":900,"purchasedCreditsAvailable":75,"traceId":"20fb4d4399fcf96d227bd016d6171858","timestamp":1767939041800,"errorCode":"","errorDescription":"","success":true}}},"exampleType":"examples"}},"exampleType":"examples"},"076836e4-3180-4e36-a8ff-b971af276d6f":{"description":"Validation error.","content":{"application/json":{"schema":{"type":"object","title":"ValidationErrorResponse","properties":{"success":{"const":false,"isRequired":true,"uniqueKey":"success","typeLabel":"any"},"error":{"type":"string","isRequired":true,"uniqueKey":"error","typeLabel":"string"},"message":{"type":"string","isRequired":true,"uniqueKey":"message","typeLabel":"string"},"timestamp":{"type":"integer","isRequired":true,"uniqueKey":"timestamp","typeLabel":"integer"}},"required":["success","error","message","timestamp"],"uniqueKey":"","typeLabel":"ValidationErrorResponse · object"},"examples":{"missing uniqueId":{"title":"missing uniqueId","value":{"success":false,"error":"VALIDATION_ERROR","message":"Missing required field: 'uniqueId'.","timestamp":1770099403116}},"invalid pastDayRange":{"title":"invalid pastDayRange","value":{"success":false,"error":"VALIDATION_ERROR","message":"'pastDayRange' out of range. Must be between 1 and 365.","timestamp":1770099403116}}},"exampleType":"examples"}},"exampleType":"examples"},"4c2152fd-951d-4916-aec9-7a8f94d58b33":{"description":"Exceeded quota or rate limit.","content":{"application/json":{"schema":{"type":"object","title":"QuotaErrorResponse","properties":{"success":{"const":false,"isRequired":true,"uniqueKey":"success","typeLabel":"any"},"error":{"type":"string","isRequired":true,"uniqueKey":"error","typeLabel":"string"},"message":{"type":"string","isRequired":true,"uniqueKey":"message","typeLabel":"string"},"remainingPlanCredit":{"type":"number","isRequired":true,"uniqueKey":"remainingPlanCredit","typeLabel":"number"}},"required":["success","error","message","remainingPlanCredit"],"uniqueKey":"","typeLabel":"QuotaErrorResponse · object"},"examples":{"rate limit":{"title":"rate limit","value":{"success":false,"error":"RATE_LIMIT_EXCEEDED","message":"Too many requests. Please try again later."}},"quota exceeded":{"title":"quota exceeded","value":{"success":false,"error":"QUOTA_EXCEEDED","message":"Not enough credits to complete this request."}}},"exampleType":"examples"}},"exampleType":"examples"}},"security":{"240c7ac2-977e-4d68-bb73-fa5e341620c0":{"ApiKeyAuth":{"type":"apiKey","description":"The valid CreatorDB API key for authentication.","name":"api-key","in":"header","scopes":[],"schemeName":"ApiKeyAuth"}}},"servers":{"1b35eb6a-9129-44a5-85d4-a36fe76cd77e":{"url":"https://apiv3.creatordb.app","description":"Production Environment (CreatorDB Headless API V3)"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"apiKey","description":"The valid CreatorDB API key for authentication.","name":"api-key","in":"header","scopes":[],"schemeName":"ApiKeyAuth"},"schema":{"title":"api-key","type":"string","description":"The valid CreatorDB API key for authentication.","isRequired":true,"typeLabel":"string","deprecated":false},"schemeName":"ApiKeyAuth","name":"api-key"}],"title":"ApiKeyAuth"}]},"originalFileLocation":"api-v3/api-v3.yaml"},"subdomain":"creatordb-589c46f5","siteName":"CreatorDB Documentation Center","title":"Get Performance History - CreatorDB Documentation Center","navMaps":{"firstHrefInVersion":{"3.0":{"href":"/api-reference/tiktok/get-performance-history","matchLevel":0},"2.0":{"href":"/api-reference/general-operations/get-api-credit-status","matchLevel":2}},"firstHrefInLanguage":{}},"originalFileLocation":"api-reference/tiktok/get-performance-history.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=\"Retrieve daily performance snapshots for a specified TikTok creator within a specific period, including upload activity, follower growth, engagement metrics, and video performance. Dates are returned as Unix timestamps in milliseconds.\">\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 Performance History - CreatorDB Documentation Center\">\u003cmeta data-mint-head property=\"og:description\" content=\"Retrieve daily performance snapshots for a specified TikTok creator within a specific period, including upload activity, follower growth, engagement metrics, and video performance. Dates are returned as Unix timestamps in milliseconds.\">\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/tiktok/get-performance-history\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://creatordb-589c46f5.mintlify.app/_mintlify/api/og/v2?division=TikTok\u0026amp;title=Get+Performance+History\u0026amp;description=Retrieve+daily+performance+snapshots+for+a+specified+TikTok+creator+within+a+specific+period%2C+including+upload+activity%2C+follower+growth%2C+engagement+metrics%2C+an\u0026amp;theme=4f6f7d6d515d76d22bdf1025\u0026amp;signature=349bc2cf4ea3d797bcc5fb297f9f75ac8072a4a78749aa6c01f13d388bcdfc44\">\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 Performance History - CreatorDB Documentation Center\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Retrieve daily performance snapshots for a specified TikTok creator within a specific period, including upload activity, follower growth, engagement metrics, and video performance. Dates are returned as Unix timestamps in milliseconds.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://creatordb-589c46f5.mintlify.app/_mintlify/api/og/v2?division=TikTok\u0026amp;title=Get+Performance+History\u0026amp;description=Retrieve+daily+performance+snapshots+for+a+specified+TikTok+creator+within+a+specific+period%2C+including+upload+activity%2C+follower+growth%2C+engagement+metrics%2C+an\u0026amp;theme=4f6f7d6d515d76d22bdf1025\u0026amp;signature=349bc2cf4ea3d797bcc5fb297f9f75ac8072a4a78749aa6c01f13d388bcdfc44\">\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/tiktok/get-performance-history\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/tiktok/get-performance-history.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/tiktok/get-performance-history#webpage\",\"url\":\"https://docs.creatordb.app/api-reference/tiktok/get-performance-history\",\"name\":\"Get Performance History\",\"description\":\"Retrieve daily performance snapshots for a specified TikTok creator within a specific period, including upload activity, follower growth, engagement metrics, and video performance. Dates are returned as Unix timestamps in milliseconds.\",\"isPartOf\":{\"@id\":\"https://docs.creatordb.app#website\"},\"breadcrumb\":{\"@id\":\"https://docs.creatordb.app/api-reference/tiktok/get-performance-history#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.creatordb.app/api-reference/tiktok/get-performance-history#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"API Endpoints\",\"item\":\"https://docs.creatordb.app/api-reference/general-operations/get-api-usage\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"TikTok\",\"item\":\"https://docs.creatordb.app/api-reference/tiktok/search-creators\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"Get Performance History\",\"item\":\"https://docs.creatordb.app/api-reference/tiktok/get-performance-history\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.creatordb.app/api-reference/tiktok/get-performance-history#apireference\",\"headline\":\"Get Performance History\",\"name\":\"Get Performance History\",\"description\":\"Retrieve daily performance snapshots for a specified TikTok creator within a specific period, including upload activity, follower growth, engagement metrics, and video performance. Dates are returned as Unix timestamps in milliseconds.\",\"url\":\"https://docs.creatordb.app/api-reference/tiktok/get-performance-history\",\"mainEntityOfPage\":{\"@id\":\"https://docs.creatordb.app/api-reference/tiktok/get-performance-history#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","tabs":[{"tab":"API Reference","icon":"ServerCog","groups":[{"group":"Getting Started","icon":"Rocket","pages":[{"title":"Introduction","mode":"wide","href":"/api-v3/introduction"},{"title":"Authentication","mode":"wide","href":"/api-v3/authentication"},{"title":"Quickstart","mode":"wide","href":"/api-v3/quickstart"},{"title":"Data Methodology","mode":"default","href":"/api-v3/data-methodology"}]},{"group":"User Guides","icon":"Notebook","pages":[{"title":"Using Natural Language Search","mode":"default","href":"/api-v3/using_natural_language_search"},{"title":"Creator Custom Search Filters","mode":"wide","href":"/api-v3/creator-custom-search-filters"},{"title":"Configuring Custom Search Filters and Examples","mode":"wide","href":"/api-v3/configuring_advanced_search_filters"},{"title":"Submitting Creators","mode":"default","href":"/api-v3/submitting-creators"},{"title":"Downloading YouTube Video Subtitles","mode":"default","href":"/api-v3/downloading-youtube-video-subtitles"},{"title":"Fractional Calls","href":"/api-v3/fractional-calls"},{"title":"Field and Item Costs","href":"/api-v3/field-and-item-costs"},{"title":"API Credit Usage","mode":"wide","href":"/api-v3/api-credit-usage"}]},{"group":"API Endpoints","icon":"square-chevron-right","pages":[{"group":"General Operations","pages":[{"title":"Get API Usage","deprecated":null,"version":null,"openapi":"/api-v3/api-v3.yaml get /usage","href":"/api-reference/general-operations/get-api-usage"}]},{"group":"AI Search","pages":[{"title":"Natural Language Search","deprecated":null,"version":null,"openapi":"/api-v3/api-v3.yaml post /nls","href":"/api-reference/ai-search/natural-language-search"}]},{"group":"YouTube","pages":[{"title":"Search Creators","deprecated":null,"version":null,"openapi":"/api-v3/api-v3.yaml post /youtube/search","href":"/api-reference/youtube/search-creators"},{"title":"Submit Creators","deprecated":null,"version":null,"openapi":"/api-v3/api-v3.yaml post /youtube/submitCreators","href":"/api-reference/youtube/submit-creators"},{"title":"Get Profile Information","deprecated":null,"version":null,"openapi":"/api-v3/api-v3.yaml post /youtube/profile","href":"/api-reference/youtube/get-profile-information"},{"title":"Get Contact","deprecated":null,"version":null,"openapi":"/api-v3/api-v3.yaml post /youtube/contact","href":"/api-reference/youtube/get-contact"},{"title":"Get Performance Information","deprecated":null,"version":null,"openapi":"/api-v3/api-v3.yaml post /youtube/performance","href":"/api-reference/youtube/get-performance-information"},{"title":"Get Performance History","deprecated":null,"version":null,"openapi":"/api-v3/api-v3.yaml get /youtube/performance-history","href":"/api-reference/youtube/get-performance-history"},{"title":"Get Audience Demographics","deprecated":null,"version":null,"openapi":"/api-v3/api-v3.yaml post /youtube/audience","href":"/api-reference/youtube/get-audience-demographics"},{"title":"Get Content Details","deprecated":null,"version":null,"openapi":"/api-v3/api-v3.yaml post /youtube/content-detail","href":"/api-reference/youtube/get-content-details"},{"title":"Get Sponsorship Information","deprecated":null,"version":null,"openapi":"/api-v3/api-v3.yaml post /youtube/sponsorship","href":"/api-reference/youtube/get-sponsorship-information"},{"title":"List Topics","deprecated":null,"version":null,"openapi":"/api-v3/api-v3.yaml get /youtube/topics","href":"/api-reference/youtube/list-topics"},{"title":"List Niches","deprecated":null,"version":null,"openapi":"/api-v3/api-v3.yaml get /youtube/niches","href":"/api-reference/youtube/list-niches"},{"title":"Get Video Subtitles","deprecated":null,"version":null,"openapi":"/api-v3/api-v3.yaml get /youtube/subtitles/meta","href":"/api-reference/youtube/get-video-subtitles"},{"title":"Download Video Subtitles","deprecated":null,"version":null,"openapi":"/api-v3/api-v3.yaml get /youtube/subtitles/download","href":"/api-reference/youtube/download-video-subtitles"}]},{"group":"Instagram","pages":[{"title":"Search Creators","deprecated":null,"version":null,"openapi":"/api-v3/api-v3.yaml post /instagram/search","href":"/api-reference/instagram/search-creators"},{"title":"Submit Creators","deprecated":null,"version":null,"openapi":"/api-v3/api-v3.yaml post /instagram/submitCreators","href":"/api-reference/instagram/submit-creators"},{"title":"Get Profile Information","deprecated":null,"version":null,"openapi":"/api-v3/api-v3.yaml post /instagram/profile","href":"/api-reference/instagram/get-profile-information"},{"title":"Get Contact","deprecated":null,"version":null,"openapi":"/api-v3/api-v3.yaml post /instagram/contact","href":"/api-reference/instagram/get-contact"},{"title":"Get Performance Information","deprecated":null,"version":null,"openapi":"/api-v3/api-v3.yaml post /instagram/performance","href":"/api-reference/instagram/get-performance-information"},{"title":"Get Performance History","deprecated":null,"version":null,"openapi":"/api-v3/api-v3.yaml get /instagram/performance-history","href":"/api-reference/instagram/get-performance-history"},{"title":"Get Audience Demographics","deprecated":null,"version":null,"openapi":"/api-v3/api-v3.yaml post /instagram/audience","href":"/api-reference/instagram/get-audience-demographics"},{"title":"Get Content Details","deprecated":null,"version":null,"openapi":"/api-v3/api-v3.yaml post /instagram/content-detail","href":"/api-reference/instagram/get-content-details"},{"title":"Get Sponsorship Information","deprecated":null,"version":null,"openapi":"/api-v3/api-v3.yaml post /instagram/sponsorship","href":"/api-reference/instagram/get-sponsorship-information"},{"title":"List Niches","deprecated":null,"version":null,"openapi":"/api-v3/api-v3.yaml get /instagram/niches","href":"/api-reference/instagram/list-niches"}]},{"group":"TikTok","pages":[{"title":"Search Creators","deprecated":null,"version":null,"openapi":"/api-v3/api-v3.yaml post /tiktok/search","href":"/api-reference/tiktok/search-creators"},{"title":"Submit Creators","deprecated":null,"version":null,"openapi":"/api-v3/api-v3.yaml post /tiktok/submitCreators","href":"/api-reference/tiktok/submit-creators"},{"title":"Get Profile Information","deprecated":null,"version":null,"openapi":"/api-v3/api-v3.yaml post /tiktok/profile","href":"/api-reference/tiktok/get-profile-information"},{"title":"Get Contact","deprecated":null,"version":null,"openapi":"/api-v3/api-v3.yaml post /tiktok/contact","href":"/api-reference/tiktok/get-contact"},{"title":"Get Performance Information","description":"Retrieve advanced performance information of a specified TikTok creator, including post activity, follower growth, engagement metrics, and content performance.\u003cbr />\u003cbr />Optionally pass `fields` in the request body to return only a subset of performance blocks. Requesting a subset bills fractionally, capped at the full-bundle price. Fractional calls must be enabled on your API key. Otherwise, a request that includes `fields` returns a `400` error (`FractionalCallsNotEnabled`). For per-field costs, see [Field and Item Costs](/api-v3/field-and-item-costs#tiktok/performance). For how fractional costs work, see [Fractional Costs](/api-v3/fractional-calls).","deprecated":null,"version":null,"openapi":"/api-v3/api-v3.yaml post /tiktok/performance","href":"/api-reference/tiktok/get-performance-information"},{"title":"Get Performance History","deprecated":null,"version":null,"openapi":"/api-v3/api-v3.yaml get /tiktok/performance-history","href":"/api-reference/tiktok/get-performance-history"},{"title":"Get Audience Demographics","description":"Retrieve audience demographic insights for a specified TikTok creator, including country distribution, gender breakdown, and age composition. This endpoint provides detailed audience analytics to help understand creator reach, evaluate audience alignment, and support data‑driven influencer selection and campaign targeting.\u003cbr />\u003cbr />Optionally pass `fields` in the request body to return only a subset of demographic fields. You are billed for the fields you request, capped at the full-bundle price. Fractional calls must be enabled on your API key. Otherwise, a request that includes `fields` returns a `400` error (`FractionalCallsNotEnabled`). For per-field costs, see [Field and Item Costs](/api-v3/field-and-item-costs#tiktok/audience). For how fractional calls work, see [Fractional Calls](/api-v3/fractional-calls).","deprecated":null,"version":null,"openapi":"/api-v3/api-v3.yaml post /tiktok/audience","href":"/api-reference/tiktok/get-audience-demographics"},{"title":"Get Content Details","deprecated":null,"version":null,"openapi":"/api-v3/api-v3.yaml post /tiktok/content-detail","href":"/api-reference/tiktok/get-content-details"},{"title":"List Niches","deprecated":null,"version":null,"openapi":"/api-v3/api-v3.yaml get /tiktok/niches","href":"/api-reference/tiktok/list-niches"}]},{"group":"Sponsor","pages":[{"title":"Search Brands","deprecated":null,"version":null,"openapi":"/api-v3/api-v3.yaml post /sponsor/search","href":"/api-reference/sponsor/search-brands"},{"title":"Submit Brand","deprecated":null,"version":null,"openapi":"/api-v3/api-v3.yaml post /sponsor/submit","href":"/api-reference/sponsor/submit-brand"},{"title":"Get Brand Information","deprecated":null,"version":null,"openapi":"/api-v3/api-v3.yaml get /sponsor/information","href":"/api-reference/sponsor/get-brand-information"},{"title":"List Brands","deprecated":null,"version":null,"openapi":"/api-v3/api-v3.yaml get /sponsor/list","href":"/api-reference/sponsor/list-brands"},{"title":"List Sponsored Creators","deprecated":null,"version":null,"openapi":"/api-v3/api-v3.yaml get /sponsor/creators","href":"/api-reference/sponsor/list-sponsored-creators"},{"title":"Get Sponsored Creator Performance","deprecated":null,"version":null,"openapi":"/api-v3/api-v3.yaml get /sponsor/performance","href":"/api-reference/sponsor/get-sponsored-creator-performance"},{"title":"Get Sponsored Creator Demographics","deprecated":null,"version":null,"openapi":"/api-v3/api-v3.yaml get /sponsor/audience","href":"/api-reference/sponsor/get-sponsored-creator-demographics"},{"title":"Get Brand Summary","deprecated":null,"version":null,"openapi":"/api-v3/api-v3.yaml get /sponsor/summary","href":"/api-reference/sponsor/get-brand-summary"}]}]},{"group":"Filter Value References","icon":"book-user","pages":[{"title":"YouTube Channel Categories","mode":"wide","href":"/api-v3/youtube-categories"},{"title":"Instagram Categories","mode":"default","href":"/api-v3/instagram-categories"},{"title":"Country Codes","mode":"wide","href":"/api-v3/country-code"},{"title":"Language Codes","mode":"wide","href":"/api-v3/language-code"},{"title":"Industry List","mode":"default","href":"/api-v3/industry-list"}]},{"group":"Troubleshooting and FAQs","icon":"hammer","pages":[{"title":"Error Codes","mode":"default","href":"/api-v3/error-code"}]}]},{"tab":"Changelog","icon":"logs","pages":[{"title":"Changelog","href":"/api-v3/changelog"}]}]},{"version":"2.0","pages":[{"title":"2.0","href":"/api-reference/general-operations/get-api-credit-status"}]}]},{"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"}]}]},"title":"Get Performance History - CreatorDB Documentation Center","buildId":"dpl_DFJrtvUi8HS5F9nkooKuDJsuD5BM","deploymentId":"dpl_DFJrtvUi8HS5F9nkooKuDJsuD5BM","dynamics":["c2aa737661","b0f84f53ff","a9bb46feb3","2b790eda92"],"chunks":["OpenApiReferenceProvider-rfhihCWU.js","utils-BmH1XFxk.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-BcNsxPKB.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-BAES3tkd.js","snippetPresets-DCMQBKLP.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","Page-D5fEM6aW.js","ApiExamples-D6l_bzE9.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-BOktbnNh.js","shallow-BCs8SgM7.js","getApiPlaygroundDisplay-DEmW5bJB.js","CodeSnippet-CpZOpB9C.js","CodeSnippets-BOBDqibl.js","getPastedJson-DH2JBvmr.js","icon-BBJH-kKh.js","MethodPill-D2Sd5NLC.js","DuplicateIcon-CGgfL2qN.js","createIcon-BKudBBzi.js","DynamicMarkdown-85clUA0i.js","SectionHeading-D0JiMgDx.js","axios-vUo_bRtp.js","Markdown-Cfiy0xZO.js","clsx-rL8ZCCw4.js","lib--scc4DXi.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-aeztFa9U.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-BywkCr5C.js"]}