TikTok Analytics API: A Developer’s Guide To Every Route

In-App Analytics Vs. Creator Analytics Vs. The TikTok Analytics API

TikTok provides three separate native analytics environments: in-app Analytics on mobile for Business Accounts, TikTok Business Center as a web-based access-control layer, and TikTok Ads Manager as the primary interface for paid campaign data.

TikTok’s native analytics dashboard is free for all accounts and covers views, likes, comments, shares, saves, watch time, traffic sources, and audience demographics. It only reports on your own account and keeps roughly 365 days of history.

The TikTok Analytics API exists because this data otherwise stays locked inside TikTok’s interfaces. It exposes a programmatic subset of the same metrics, controlled by OAuth scopes and the approval tier of each route.

If analytics are not visible in-app, the usual causes are a personal account without Creator or Business access through TikTok Studio or Business Suite, or a missing eligibility threshold. Examples include the 100-follower minimum TikTok’s API requires for Audience Analytics and higher thresholds such as 1,000 followers for full Creator Tools access.

Route 1: TikTok Display API

The Display API is TikTok’s official OAuth-based set of HTTP APIs that provides read-only access to display an authenticated TikTok creator’s profile information and videos through the /v2/user/info/, /v2/video/list/, and /v2/video/query/ endpoints. It returns data only for the account that granted authorization.

Access requires a TikTok developer account on the TikTok Developer Portal, approval for both Login Kit and TikTok API products, granted user.info.basic and video.list scopes, and a completed OAuth 2.0 authorization flow with those scopes to obtain an access token.

The two primary scope strings for TikTok Display API analytics are user.info.basic and video.list. The user.info.basic scope now returns only open_id, union_id, avatar_url, avatar_url_100, avatar_large_url, and display_name. Follower count and profile fields such as bio_description and is_verified moved to user.info.stats and user.info.profile. The video.list scope reads the authenticated user’s public videos on TikTok.

The following Python example fetches the authenticated user’s video list using a bearer token from the OAuth flow:

import requests ACCESS_TOKEN = "YOUR_BEARER_TOKEN" url = "https://open.tiktokapis.com/v2/video/list/" headers = {"Authorization": f"Bearer {ACCESS_TOKEN}"} params = { "fields": "id,title,view_count,like_count,comment_count,share_count,create_time" } response = requests.get(url, headers=headers, params=params) data = response.json() print(data) 

A trimmed successful response looks like:

{ "data": { "videos": [ { "id": "7123456789012345678", "title": "My latest video", "view_count": 48200, "like_count": 3100, "comment_count": 87, "share_count": 412, "create_time": 1720000000 } ], "cursor": 10, "has_more": true }, "error": { "code": "ok" } } 

Rate limits on the TikTok Display API are enforced per endpoint at the app level with a documented default of 600 requests per one-minute sliding window per endpoint. That ceiling matters less than the scope limit. The Display API cannot return competitor data, public trending data, or metrics for any account that has not explicitly authorized the app.

Route 2: TikTok Business API Reporting Endpoint

The Display API covers your own organic content but cannot report on paid campaigns. That gap is where the TikTok Business API, specifically its Marketing API, fits. This route provides programmatic access to paid ads reporting.

Access requires a TikTok for Business account, a registered developer app, OAuth 2.0 advertiser authorization, and passing TikTok’s app review and data-security compliance check. Sandbox access often takes only hours, while production approval usually takes days or weeks.

The reporting endpoint is /report/integrated/get/. It returns aggregated metrics such as spend, clicks, impressions, conversions, and derived ratios, broken down by dimensions like campaign, ad group, ad, country, and placement. Rate limits for the Reporting permission category are about 1 request per second per advertiser and about 600 requests per hour per app.

The following Python example calls the reporting endpoint with an access token:

import requests ACCESS_TOKEN = "YOUR_ACCESS_TOKEN" ADVERTISER_ID = "YOUR_ADVERTISER_ID" url = "https://business-api.tiktok.com/open_api/v1.3/report/integrated/get/" headers = {"Access-Token": ACCESS_TOKEN} payload = { "advertiser_id": ADVERTISER_ID, "report_type": "BASIC", "dimensions": ["campaign_id"], "metrics": ["spend", "impressions", "clicks", "conversions"], "start_date": "2026-08-01", "end_date": "2026-08-31", "page": 1, "page_size": 10 } response = requests.post(url, headers=headers, json=payload) print(response.json()) 

This route returns paid-ad performance data only. Organic content analytics live in TikTok’s separate Organic API surfaces such as Accounts, Mentions, Discovery, and Spark Ads Recommendation. A TikTok for Business account is required, and Verified Business Account status unlocks Conversion Analytics in addition to Basic Analytics.

Route 3: TikTok Research API

TikTok’s Research API is its official route for qualified researchers to access public data on TikTok content and accounts. It is also the most restricted route. Independent audits find that it provides only a partial, delayed, and selectively filtered subset of the platform’s public information environment, rather than the highest-fidelity data.

Access is limited to independent and academic researchers conducting research on a non-for-profit basis. Applicants submit an application, wait for approval, and must follow TikTok’s Community Guidelines and Research Tools Terms of Service. Most developers and commercial teams do not receive approval.

The Research API provides access to public Videos, Comments, and Accounts. Video data includes total likes, total comments, voice-to-text, subtitles, creation time, and video length. Comment data includes text, total likes, replies, and posting time. Account data includes bios, profile pictures, liked videos, and follower and following counts. Under the EU Digital Services Act, TikTok must also share certain data with researchers who hold Vetted Researcher status from a Digital Services Coordinator.

The following Python example queries the Research API video query endpoint:

import requests ACCESS_TOKEN = "YOUR_RESEARCH_API_TOKEN" url = "https://open.tiktokapis.com/v2/research/video/query/" headers = { "Authorization": f"Bearer {ACCESS_TOKEN}", "Content-Type": "application/json" } payload = { "query": { "and": [ {"field_name": "hashtag_name", "operation": "IN", "field_values": ["climatechange"]} ] }, "start_date": "20260801", "end_date": "20260831", "max_count": 10, "fields": "id,like_count,comment_count,share_count,create_time,hashtag_names" } response = requests.post(url, headers=headers, json=payload) print(response.json()) 

The Research API is rate-limited, requires academic affiliation, and excludes commercial use and specific countries. For developers and agencies working on commercial or product use cases, the Research API route is effectively unavailable because access requires Eligible Researcher status with an approved project application.

Route 4: Third-Party And Open-Source Alternatives

Two unofficial routes serve developers who cannot access the official APIs or need data the official APIs do not expose.

Third-party scraper APIs are commercial services that expose structured TikTok public data via REST endpoints. Depending on the provider, that data includes user profiles, engagement metrics, trending videos, hashtag analytics, and in some cases TikTok Shop data.

Documented limitations include no access to private data, no OAuth-free access to arbitrary users, incomplete TikTok Shop and live-stream coverage for some providers, and frequent outages or response-format changes, especially among RapidAPI TikTok providers with inconsistent data quality and no SLA guarantees. Third-party TikTok scrapers such as Apify’s TikTok Data Scraper require a paid subscription and no TikTok approval or account login, although some services like EnsembleData offer a free tier or trial.

Open-source libraries such as davidteather/TikTok-Api on GitHub simulate browser behavior to extract publicly visible data. These libraries often carry more than 100 open issues, which reflects the high maintenance burden caused by TikTok’s anti-bot system updates that break libraries on a regular cadence. TikTok’s open-source OpenSDKs for iOS and Android are publicly available, but integrating them still requires registering an app on the TikTok for Developers portal and obtaining a Client Key and Client Secret after application approval.

The following example shows a minimal call using the open-source TikTok-Api library:

import asyncio from TikTokApi import TikTokApi async def get_user_videos(username): async with TikTokApi() as api: await api.create_sessions(ms_tokens=["YOUR_MS_TOKEN"], num_sessions=1) user = api.user(username=username) async for video in user.videos(count=10): print(video.id, video.stats) asyncio.run(get_user_videos("example_user")) 

Documented constraints include read-only access, no authenticated routes, and bot-detection failures that appear as empty responses or exceptions and often require proxies. Open-source scraping remains operationally possible but rarely robust enough for unattended production use.

TikTok Analytics API Vs. Scraping: Access Reality

Many non-academic applicants see Research API applications rejected or delayed. When that happens, and when the Display API’s own-account-only scope does not cover the use case, developers usually choose between third-party scrapers and open-source libraries, each with clear tradeoffs.

TikTok’s Terms of Service, last updated May 5, 2026, prohibit users from using any automated system or software to scrape, crawl, export, or otherwise extract any data or content for any purpose unless TikTok approves it in writing. ToS violations can trigger account termination and breach-of-contract claims, while criminal liability under the CFAA usually requires more than a ToS breach under current US interpretations.

Which Route Should You Use?

The right route depends on what data you need and who owns the account. Use this framework to match developer goals to the appropriate route:

• Own account analytics (organic): Display API with user.info.basic and video.list scopes.
• Paid campaign reporting: Business API Marketing API with the /report/integrated/get/ endpoint, which requires an advertiser account and app review.
• Public video and account data for academic research: Research API with an application at developers.tiktok.com, usually limited to academic or non-profit institutions.
• Competitor public metrics, trending data, hashtag analytics: Third-party scraper API with faster access, a paid subscription, and ToS and GDPR risk to evaluate.
• Custom scraping pipeline with full control: Open-source library with no subscription cost, high maintenance work, and fragile behavior when TikTok’s frontend changes.
• Analytics without building or maintaining any integration: Sozee’s native Analytics, described below.

See your TikTok metrics without writing a line of code.

Skip The Integration: Sozee’s Native TikTok Analytics

Every route above introduces overhead such as TikTok approval, OAuth token management, scraper maintenance, or ToS risk. If your goal is performance measurement rather than API engineering, that overhead may not justify a custom build. A platform with native analytics changes that calculation.

Sozee’s Analytics feature tracks impressions, reach, likes, comments, shares, and engagement. Its differentiator is the split between what Sozee posted and what the creator posted directly, which gives creators and agencies a clear view of how the platform contributes to performance without any API calls or OAuth grants.

The Scheduler connects TikTok alongside Instagram, X, Facebook, Reddit, and Fanvue on a per-character basis, so analytics tie directly to the content pipeline that produced them. The Vault feeds both the Scheduler and the Agent, which means every image, video, and voice note generated inside Sozee flows into scheduling and measurement without manual exports.

Sozee follows a complete studio loop of Cast, Direct, Create, Refine, Publish, and Learn. Analytics powers the Learn stage, where content performance feeds back into the next shoot setup. For agencies that manage multiple creators, Teams and Workspaces keep each client’s characters, vault, connected accounts, and credits fully isolated under one login.

The result is a platform that closes the loop between content creation and performance measurement. Creators and agencies gain the metrics while avoiding API approval queues, scraper breakage, and token lifecycle management.

Put your content pipeline and TikTok analytics under one login.

Frequently Asked Questions

Is The TikTok API Free?

TikTok does not currently charge subscription or per-call fees for Display, Business, or Research API access, although it reserves the right to introduce charges later. Approval gates access for each route. Third-party TikTok data APIs are commercial products with monthly subscription costs. The main constraint is approval and scope, not price.

How Do I Access The TikTok API?

Access steps depend on the surface you need. For the Display API, register a developer app at developers.tiktok.com, complete OAuth 2.0, and request the scopes your use case requires.

For the Business API Marketing API, register at the TikTok for Business developer portal at business-api.tiktok.com, complete OAuth advertiser authorization, and pass app review and a data-security compliance check before production access.

For the Research API, qualified researchers in eligible regions such as the U.S., Europe, Canada, and Brazil must create a TikTok for Developers account with a professional email, submit a research proposal that shows academic or non-profit intent, and wait for approval, which typically takes about four weeks.

How Do I Export TikTok Analytics Data?

TikTok’s native analytics can be viewed in-app or in TikTok Business Suite, but raw data cannot be exported directly from the in-app interface. TikTok Ads Manager supports CSV exports for paid campaign data, with a limit of 200,000 rows per file.

For organic analytics, the Display API’s video.list endpoint returns per-video metrics programmatically for the authenticated account, including view, like, comment, and share counts when requested through the fields parameter. Creators and agencies that want scheduled exports without building an integration can rely on Sozee’s native Analytics and the Sozee-posted versus creator-posted split described above.

How Can I Extract Data From TikTok?

For your own account’s organic data, TikTok’s Display API is the official route, although it focuses on embedding videos and does not provide full metadata, search, or user data. For paid ads data, the Business API Marketing API reporting endpoint is the correct path.

For public data on other accounts such as competitor profiles, trending videos, and hashtag analytics, the Research API is the official route and carries the academic-only restriction described in Route 3. Outside those official routes, third-party scraper APIs and open-source libraries can extract publicly visible data but carry TikTok Terms of Service risk and ongoing maintenance needs as TikTok’s frontend changes. Platforms like Sozee provide native analytics for content posted through the platform, which removes the need to extract data directly.

What Is The Best TikTok Analytics Tool?

The best tool depends on your use case. TikTok’s native analytics is the source of truth for your own account and is free, with about a year of history and coverage limited to your own data. Third-party tools add competitor tracking, longer history, and client-ready reporting, but they cannot bypass TikTok’s API limits on your own account.

For creators and agencies that want analytics tied directly to content creation and scheduling, Sozee’s native Analytics and the Sozee-posted versus creator-posted split give a clear view of what works without any custom integration work.

Track every TikTok post’s performance in one dashboard.