Nexscope
🇺🇸 English
🇺🇸English
Start free

TikTok Video Analytics

Compare TikTok promotional videos by views, engagement, and sales revenue. Call the TikTok Video Analytics API via REST or MCP from 15 credits per call.

CostRecent Avg. 22 · Range 11–22 credits / call
Try online
POST · https://api.nexscope.ai/kd/video/detailMCP · nexscope_tiktok_video_analytics

What this API does

Compare TikTok promotional videos by views, engagement, and sales revenue. The request accepts videoId, region, dateRange, language, currency. Its documented result includes errcode, errmsg, video_id, video_title, video_region, belonged_creator_id, belonged_creator_handle, views.

TikTok Video Analytics API use cases

Investigate TikTok Video Analytics

To investigate tiktok video analytics, a marketplace analyst submits videoId and region to TikTok Video Analytics. The returned errcode, errmsg, video_id help investigate the requested operation.

Collect TikTok Video Analytics evidence

A marketplace analyst uses TikTok Video Analytics with videoId and region to collect tiktok video analytics evidence. The returned errcode, errmsg, video_id help compare evidence for the requested scope.

Review TikTok Video Analytics results

For this workflow, a marketplace analyst calls TikTok Video Analytics with videoId and region to review tiktok video analytics results. The result helps review the returned facts with the team.

TikTok Video Analytics API FAQ

What does the TikTok Video Analytics API return?

Compare TikTok promotional videos by views, engagement, and sales revenue. The documented output includes errcode, errmsg, video_id, video_title, video_region, belonged_creator_id, belonged_creator_handle, views. It corresponds to the supplied videoId, region, dateRange, language, currency. Optional fields can be absent; a missing value should not be interpreted as a measured zero. Example values illustrate the response shape, rather than live account results.

How many credits does the TikTok Video Analytics API cost?

The current documented cost is Recent Avg. 22 · Range 11–22 credits / call. This is the same cost shown at the top of this page. If a range or estimate is displayed, the final charge depends on the request. Review your available credits and the pricing page before calling the API, and check API usage records for the actual charge.

How do I call the TikTok Video Analytics API from my app or an MCP client?

Send a POST request to https://api.nexscope.ai/kd/video/detail with your API key as a Bearer token and the JSON inputs shown in API integration. In a compatible MCP client such as Claude or Cursor, connect Nexscope and call nexscope_tiktok_video_analytics. Use the MCP arguments shown in the MCP guide, or switch Online test to MCP to review its request before adding it to your app.

View plans and creditsConnect this API with MCP

Try this API
Endpoint
https://api.nexscope.ai/kd/video/detail
MCP method
nexscope_tiktok_video_analytics

Step 1 of 3 · Authenticate

Authentication

All run endpoints require a user API key. Send it as a bearer token in the Authorization header.

Authorization: Bearer nk-xxxxxxxxxxxxxxxxx
Missing or invalid API keys return an authentication error. Manage keys from .

Step 2 of 3 · Send a request

POSThttps://api.nexscope.ai/kd/video/detail

Run an API

Send a JSON request body using the parameters described below.

Example request

Replace YOUR_API_KEY, then run this command in your terminal.

curl -X POST 'https://api.nexscope.ai/kd/video/detail' \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "currency": "USD",
  "dateRange": "last7Day",
  "region": "US",
  "videoId": "7659161409279806734"
}'

Code example

{
  "currency": "USD",
  "dateRange": "last7Day",
  "region": "US",
  "videoId": "7659161409279806734"
}

Step 3 of 3 · Inspect the result

Check the response

Read code for the request status and data for the result. Open the parameter and response reference for the full field definitions.

HTTP status codes

CodeDescription
200Default HTTP response for both success and many business errors. Only outer JSON code 0 indicates success or asynchronous acceptance; inspect data for the result.
429Execution admission rate limit; honor Retry-After when present.
503Execution admission is temporarily unavailable; honor Retry-After when present.
Opt-inX-Nexscope-Http-Status: semantic maps controller-handled business errors to HTTP status on run and task routes. Pre-authentication failures, such as a missing API key (code 11209), may still return HTTP 200 before this mapping. Always check the outer JSON code; malformed requests and infrastructure failures may also return non-200 HTTP responses.
View parameters & responseTry online
All categories/ TikTok Intelligence KD
POSThttps://api.nexscope.ai/kd/video/detail

Run this API

Send a JSON request to execute this API and receive the documented response payload.

Open tester

Endpoint

MethodPOST
Pathhttps://api.nexscope.ai/kd/video/detail
AuthBearer API key
Content-Typeapplication/json

Request parameters

NameTypeRequiredDescription
videoIdstringrequired
TikTok video ID such as `7659161409279806734`, usually `video_id` from the list
regionstringoptional
Region/market code, such as `US`
dateRangestringoptional
Time range, such as `last7Day`, `last30Day`
languagestringoptional
Return language, for example `zh-CN`, `en-US`
currencystringoptional
Currency unit, such as `USD`

Response example

Platform response envelope. code 0 indicates success or acceptance; data contains the business result.

No response example is published for this API. Refer to the response fields below.

Response fields

Response field reference (24 fields)

NameTypeRequiredDescription
errcodeintegeroptional
Business status code, `200` indicates success
dataarrayoptional
Video details data, usually a 1-element array when successful
costTokenintegeroptional
The deduction token for this call is usually `14000`
errmsgstringoptional
Status message, `ok` on success
video_idstringoptional
Video ID, string format to avoid loss of precision for large integers
video_titlestringoptional
Video title/copywriting
video_regionstringoptional
Video region, may be an empty string
belonged_creator_idstringoptional
Attribution expert ID
belonged_creator_handlestringoptional
Attribution expert username
viewsintegeroptional
Play volume
digg_countintegeroptional
Number of likes
comment_countintegeroptional
Number of comments
share_countintegeroptional
Number of shares
revenuenumberoptional
Total Sales/GMV
sales_volumnintegeroptional
Sales volume, field spelled `volumn`
video_gpmnumberoptional
Video GPM, or GMV per thousand plays
adintegeroptional
Whether to run ads, 1=with ads, 0=without ads
ads_viewsintegeroptional
Number of ad plays
ads_roasnumberoptional
Advertising ROAS
ad_cpanumberoptional
Advertising CPA
ad_view_rationumberoptional
Advertisement playback proportion (%)
ads_periodintegeroptional
Advertising period (days)
durationnumberoptional
Video duration (seconds)
product_numberintegeroptional
Number of video related products

Responses

CodeDescription
200Default HTTP response for both success and many business errors. Only outer JSON code 0 indicates success or asynchronous acceptance; inspect data for the result.
429Execution admission rate limit; honor Retry-After when present.
503Execution admission is temporarily unavailable; honor Retry-After when present.
Opt-inX-Nexscope-Http-Status: semantic maps controller-handled business errors to HTTP status on run and task routes. Pre-authentication failures, such as a missing API key (code 11209), may still return HTTP 200 before this mapping. Always check the outer JSON code; malformed requests and infrastructure failures may also return non-200 HTTP responses.

Data source, freshness, and limitations

Source, freshness, coverage, rate limits, and estimation notes are not specified in this API definition unless they appear in the request or response field documentation above. Do not assume official marketplace data or real-time freshness when it is not explicitly documented.

Step 1 of 2 · Connect your MCP client

MCP

V2 recommended

Connect remote agents through the standard MCP 2025-11-25 Streamable HTTP endpoint. Use OAuth 2.1 Authorization Code with PKCE, or an API key for compatibility.

POST https://api.nexscope.ai/mcp
MCP-Protocol-Version: 2025-11-25
Content-Type: application/json
Authentication

OAuth clients request the mcp:tools scope. The endpoint's 401 response advertises protected-resource metadata for authorization discovery.

Step 2 of 2 · Call the tool

Call a tool

{
  "jsonrpc": "2.0",
  "id": "tool-call-1",
  "method": "tools/call",
  "params": {
    "name": "nexscope_tiktok_video_analytics",
    "arguments": {
      "dateRange": "last30Day",
      "pageNumber": 1,
      "pageSize": 10,
      "region": "US",
      "sortField": {},
      "videoId": "6768504823336815877"
    }
  }
}

Legacy MCP v1

Existing API-key clients can continue using the compatibility endpoint. New integrations should use MCP v2.

GET / POST /mcp/legacy

Data Example

Request parameters

{
  "region": "VN",
  "dateRange": "last30Day",
  "currency": "USD",
  "category_id": "601990",
  "pageNumber": 1,
  "pageSize": 10
}

Response

{
  "code": 0,
  "msg": null,
  "data": {
    "data": [
      {
        "comment_count": 9,
        "creator_debut": "2025-04-14",
        "revenue_growth_rate": -304.94,
        "ad": 1,
        "ai_video": 0,
        "ad_view_ratio": 66.42179113856544,
        "belonged_creator_id": "7402589657018729492",
        "ads_roas": 3.17,
        "share_count": 394,
        "belonged_creator_handle": "omo_vietnam",
        "revenue": 139766.7,
        "video_title": "Cùng chờ đợi điều bất ngờ từ OMO #ThomSangThanhNha #BeautyOfSweat #HetMinhLaXinhNhat #OMO",
        "digg_count": 5321,
        "publish_date": "2026/08/14 14:52:45",
        "views": 4490853,
        "ad_revenue_ratio": 80,
        "video_id": "7673792111703067922"
      },
      {
        "comment_count": 74,
        "creator_debut": "2023-01-05",
        "revenue_growth_rate": -203.57,
        "ad": 1,
        "ai_video": 0,
        "ad_view_ratio": 9.639310523664063,
        "belonged_creator_id": "7132359344935715866",
        "ads_roas": 4.12,
        "share_count": 2008,
        "belonged_creator_handle": "cerave.vietnam_official",
        "revenue": 134865.74,
        "video_title": "🚀 HÀNH TINH LÀN DA RA TÍN HIỆU “CĂNG KIN KÍT”? HÃY ĐỂ SữA RửA MẶT CERAVE FOAMING CLEANSER GIẢI CứU THÔI Cứ rửa mặt là da khô căng, cố rửa cho sạch bóng dầu thì lại làm mất luôn độ ẩm tự nhiên. Hãy để con tàu Ceramides từ CeraVe tới, với bảo bối mang theo là Sữa Rửa Mặt Quốc Dân CeraVe Foaming Cleanser: ⏱ Kiềm dầu tới 12H: Quét sạch mọi mảng bám khói bụi, dầu thừa và kem chống nắng sâu trong lỗ chân lông, trả lại bề mặt ráo mịn khô thoáng suốt nửa ngày dài. ✨ \"Out Trình\" làm sạch, sạch ẩm chuẩn chuyên gia: Phá vỡ định kiến \"sạch là phải khô”, mang lại cảm giác nền da sạch sâu nhưng vẫn đủ ẩm. 🛡 Phục hồi hàng rào da sau 1 lần rửa mặt: Tích hợp bộ 3 Ceramides thiết yếu, cùng công nghệ độc quyền MVE, vừa làm sạch vừa khóa ẩm, tái thiết lập bức tường hàng rào bảo vệ da vững chắc.  Cùng Phi hành “da” Quang Hùng MasterD làm sạch và kiềm dầu 12H với sữa rửa mặt CeraVe Foaming Cleanser nhé. #CeraVeVietnam #QuangHungMasterD #VuTruSachAm #OutTrinhLamSach #SachAmChuanChuyenGia",
        "digg_count": 11679,
        "publish_date": "2026/08/31 12:18:37",
        "views": 46696483,
        "ad_revenue_ratio": 79.99999999999999,
        "video_id": "7680060840183155988"
      },
      {
        "comment_count": 196,
        "creator_debut": "2023-01-05",
        "revenue_growth_rate": -195.51,
        "ad": 1,
        "ai_video": 0,
        "ad_view_ratio": 9.772549725311675,
        "belonged_creator_id": "7132359344935715866",
        "ads_roas": 3.46,
        "share_count": 2370,
        "belonged_creator_handle": "cerave.vietnam_official",
        "revenue": 110547.41,
        "video_title": "Chốt ngay TOP 1 BEST SELLER của nhà CeraVe đủ mọi size #CeraVe #CeraVeVietNam #SachAmChuanChuyenGia ",
        "digg_count": 29878,
        "publish_date": "2025/11/23 18:35:02",
        "views": 10669365,
        "ad_revenue_ratio": 21.758034765073543,
        "video_id": "7575882927083408648"
      },
      {
        "comment_count": 2602,
        "creator_debut": "2025-08-10",
        "revenue_growth_rate": -202.02,
        "ad": 1,
        "ai_video": 0,
        "ad_view_ratio": 26.628412629367137,
        "belonged_creator_id": "6549000645243305985",
        "ads_roas": 4.01,
        "share_count": 17023,
        "belonged_creator_handle": "taohuongly",
        "revenue": 101378.54,
        "video_title": "#ad Tắm đều mỗi ngày là cái da trắng sáng mịn màng lúc nào k hay nha #xabongtrangda #xaphongtamtrang #xabongtamtrang #xaphongtrangda #xaphongglutathione ",
        "digg_count": 106134,
        "publish_date": "2026/09/10 15:14:00",
        "views": 19874155,
        "ad_revenue_ratio": 78.68902884439794,
        "video_id": "7683816884860357895"
      },
      {
        "comment_count": 42,
        "creator_debut": "2022-06-07",
        "revenue_growth_rate": -202.03,
        "ad": 1,
        "ai_video": 0,
        "ad_view_ratio": 66.97559735018125,
        "belonged_creator_id": "6774242491736933378",
        "ads_roas": 3.24,
        "share_count": 405,
        "belonged_creator_handle": "khanhthiphanhien",
        "revenue": 91477.46,
        "video_title": "Ít ai biết rằng hồi nhỏ Kubi không phải là em bé quá nổi bật về chiều cao. Nhiều khán giả nhìn 8 huy chương vàng của Kubi hôm nay sẽ nghĩ đến những giờ tập luyện miệt mài. Nhưng với Thi, đằng sau thành tích đó còn là một nền tảng thể chất được xây dựng từ rất sớm và duy trì đều đặn qua từng ngày, nhờ vào vận động và chất lượng của dinh dưỡng. Với Thi, mục tiêu của việc bổ sung dinh dưỡng không chỉ là để con cao hơn mà làm sao để con phát triển cơ xương chắc khỏe, cơ thể có sức bền, chịu lực tốt, giúp con tự tin thi đấu. 💃🏻🕺🏻   Đó cũng là lý do Thi chọn PediaSure đồng hành cùng Kubi từ khi 3 tuổi và vẫn tiếp tục sử dụng đến hôm nay. Điều khiến mình yên tâm là PediaSure được chứng minh lâm sàng giúp tăng hàm lượng khoáng xương (1,*), tăng chỉ số cơ cánh tay (2,^) và tăng khối nạc mà không tăng nhiều khối mỡ hơn (1,*,**). Đây cũng là điểm khác biệt mà đến nay Thi chưa thấy ở các sản phẩm khác mà Thi từng tìm hiểu. Hiệu quả của sản phẩm đã được kiểm chứng qua các nghiên cứu lâm sàng, nên Thi rất an tâm khi chia sẻ về PediaSure với mọi người.    Nếu ba mẹ mong muốn cải thiện chiều cao cho con một cách chất lượng, Thi mời ba mẹ cùng theo dõi series \"Cao lớn chất lượng rất khả thi\" nhé! Cả nhà xem hết video để xem 2 mẹ con nhảy cùng nhau nha.  ---------- (1)Mandy Ow và cộng sự (2025) (2)Mandy Ow và cộng sự (2024) (^)Cụ thể là diện tích cơ cánh tay (AMA-Arm Muscle Area) (*) Nghiên cứu thực hiện so sánh giữa nhóm trẻ Việt Nam dùng PediaSure và được tư vấn dinh dưỡng và nhóm trẻ Việt Nam tiếp tục sử dụng sữa thường lệ và được tư vấn dinh dưỡng (**) So với thời điểm ban đầu   #PediaSure #TangTruongChatLuong #SeriesKhanhThi #CaoLonChatLuongRatKhaThi #Ads",
        "digg_count": 9666,
        "publish_date": "2026/09/08 20:00:00",
        "views": 3444462,
        "ad_revenue_ratio": 78.98370620115911,
        "video_id": "7683071350029782279"
      },
      {
        "comment_count": 1065,
        "creator_debut": "2025-02-04",
        "revenue_growth_rate": -205.37,
        "ad": 1,
        "ai_video": 0,
        "ad_view_ratio": 6.988778375742069,
        "belonged_creator_id": "7388227221980890113",
        "ads_roas": 3.88,
        "share_count": 9783,
        "belonged_creator_handle": "thanhgiadungne",
        "revenue": 83064.46,
        "video_title": "Chai này tẩy được thâm kim vết mốc hay thật sự , vết ố vàng , trà cà phê hay sa tế dầu mở đều sạch hết nghe .#tayquanaosaiza #taythamkim #tayovang #saiza ",
        "digg_count": 65729,
        "publish_date": "2026/08/24 14:02:53",
        "views": 25432771,
        "ad_revenue_ratio": 79.28877379710596,
        "video_id": "7677490094055492871"
      },
      {
        "comment_count": 634,
        "creator_debut": "2023-01-05",
        "revenue_growth_rate": -197.81,
        "ad": 1,
        "ai_video": 0,
        "ad_view_ratio": 32.08784260519356,
        "belonged_creator_id": "7132359344935715866",
        "ads_roas": 3.71,
        "share_count": 10573,
        "belonged_creator_handle": "cerave.vietnam_official",
        "revenue": 76995.92,
        "video_title": "CERAVE XANH NGỌC, DẦU NHỜN ĐỪNG CHỌC !!! 💙 Da dầu nhờn thì “trình” gì khi CeraVe mang tới các “mom” SỮA RỬA MẶT SẠCH SÂU KIỀM DẦU CERAVE FOAMING CLEANSER với dạng gel tạo bọt “out trình” làm sạch bụi bẩn, bã nhờn và “out” cả kem chống nắng, đồng thời cấp ẩm với 3 loại Ceramides thiết yếu 1, 3, 6-II, làm dịu da và phục hồi hàng rào bảo vệ da để “out” khỏi tình trạng da khô và bong tróc. THỬ NGAY !!! #cerave #ceravevietnam #outtrinhlamsach #sachamchuanchuyengia# #chamsocda",
        "digg_count": 58251,
        "publish_date": "2025/07/29 11:02:27",
        "views": 8679524,
        "ad_revenue_ratio": 80,
        "video_id": "7532349323393223944"
      },
      {
        "comment_count": 39,
        "creator_debut": "2026-05-11",
        "revenue_growth_rate": -196.22,
        "ad": 0,
        "ai_video": 0,
        "ad_view_ratio": 0,
        "belonged_creator_id": "7600067987735397397",
        "ads_roas": 0,
        "share_count": 74,
        "belonged_creator_handle": "tp.ho.tun.anh4",
        "revenue": 75465.68,
        "video_title": "",
        "digg_count": 788,
        "publish_date": "2026/08/16 10:33:42",
        "views": 194980,
        "ad_revenue_ratio": 0,
        "video_id": "7674467532094328072"
      },
      {
        "comment_count": 127,
        "creator_debut": "2025-10-24",
        "revenue_growth_rate": -204.29,
        "ad": 1,
        "ai_video": 0,
        "ad_view_ratio": 79.48047922938801,
        "belonged_creator_id": "7431487921055073288",
        "ads_roas": 2.73,
        "share_count": 238,
        "belonged_creator_handle": "taphoaemhoa2",
        "revenue": 75163.77,
        "video_title": "Da dán sửa chữa yên xe , ghế sofa 🛋️ #xuhuongtiktok #suachua #danyenxe ",
        "digg_count": 2292,
        "publish_date": "2026/05/28 09:06:14",
        "views": 1781026,
        "ad_revenue_ratio": 80.00000000000001,
        "video_id": "7644758165338213650"
      },
      {
        "comment_count": 36,
        "creator_debut": "2024-09-18",
        "revenue_growth_rate": -206.55,
        "ad": 1,
        "ai_video": 0,
        "ad_view_ratio": 13.945335668681412,
        "belonged_creator_id": "7361264065505494021",
        "ads_roas": 3.55,
        "share_count": 4934,
        "belonged_creator_handle": "comfort.vietnam",
        "revenue": 73720.93,
        "video_title": "💜 COMFORT PURE MỚI - THƠM SANG THANH NHÃ ĐẾN 100 GIỜ* #ComfortPure #ComfortTinhKhoi #thomsangthanhnha #luuhuong100gio Tất cả các hình ảnh nhân vật được tài trợ bởi Unilever Việt Nam *Dựa trên kết quả đánh giá nội bộ trên vải trong điều kiện phòng thí nghiệm khi bảo quản trong tủ. Kết quả thực tế có thể thay đổi.",
        "digg_count": 8607,
        "publish_date": "2026/06/19 18:05:45",
        "views": 12498351,
        "ad_revenue_ratio": 79.99999999999999,
        "video_id": "7653061087188815111"
      }
    ]
  }
}

Online test

Execute the current API with your API key and JSON payload. Online tests use this site's configured API environment; the Endpoint and copyable examples use the public integration address.

Recent Avg. 22 · Range 11–22 credits / callAPI usage records

Try it

Send a real request with the same contract shown in the reference.

Endpoint
/kd/video/detail
MCP method
nexscope_tiktok_video_analytics
cURL
curl -X POST \
  https://api.nexscope.ai/kd/video/detail \
  -H "Authorization: Bearer nk-..." \
  -H "Content-Type: application/json" \
  -d '{ "currency": "USD", "dateRange": "last7Day", "region": "US", "videoId": "7659161409279806734" }'
Response
No response yet. Run the request to see the response here.

Related APIs

TikTok Shop Tik Tok Livestream Details

Retrieve a TikTok livestream by ID to review available sales and performance information for your chosen region and date range.

TikTok Shop Tik Tok Shop Rankings

Rank TikTok shops for a selected region and date range to compare available performance and discover shops worth researching.

TikTok Shop Tik Tok Video Rankings

Rank TikTok videos by available performance measures to identify content worth reviewing for product and creator research.

TikTok Creator Analytics

Compare TikTok creators by followers, sales revenue, and region.