TikTok Intelligence KD
TikTok Video Analytics MCP
Compare TikTok promotional videos by views, engagement, and sales revenue. Call the TikTok Video Analytics API via REST or MCP with your Nexscope API key.
TikTok Video Analytics AI Prompts & Use Cases
After connecting this MCP tool to your AI assistant, you can ask the questions below. Replace bracketed placeholders with your own inputs and use the supported values in Arguments.
New to Nexscope MCP? Follow the connection guide, then use the prompts below. The Integration and Parameters & Response tabs contain the connection steps, call example, and technical reference.
1. Compare TikTok Promotional Videos
Prompt: Compare TikTok Promotional Videos for [video ID] in [target marketplace]. Show the available results and clearly identify missing information.
2. Research In A Selected Language
Prompt: Compare TikTok Promotional Videos for [video ID] in [target marketplace]. Return the available descriptions in [my preferred supported language], while keeping identifiers unchanged.
3. Research In A Selected Currency
Prompt: Compare TikTok Promotional Videos for [video ID] in [target marketplace]. Present the available monetary values in [my selected currency], using [my supplied conversion rate] only if the tool requires one. Do not compare amounts in different currencies.
4. Review A Specific Reporting Period
Prompt: Compare TikTok Promotional Videos for [video ID] in [target marketplace]. Use [my chosen reporting period] and show the period with the returned figures. Keep dated snapshots distinct from current data.
5. Continue The Results Within A Page Limit
Prompt: Compare TikTok Promotional Videos for [video ID] in [target marketplace]. Start at [my selected page] and return [my requested page size] within the documented limits. Ask before requesting another page and do not describe one page as the complete dataset.
6. Prioritize The Results For Review
Prompt: Compare TikTok Promotional Videos for [video ID] in [target marketplace]. Prioritize [my chosen ranking metric] in [my chosen order]. Keep the ranking limited to the selected filters and reporting period.
7. Find Matches By GMV
Prompt: Compare TikTok Promotional Videos for [video ID] in [target marketplace]. Limit results to [my chosen gmv range]. Keep the lower and upper bounds consistent and show only the matching records.
8. Find Matches By Creator Follower
Prompt: Compare TikTok Promotional Videos for [video ID] in [target marketplace]. Limit results to [my chosen creator follower range]. Keep the lower and upper bounds consistent and show only the matching records.
9. Narrow Results By Category ID
Prompt: Compare TikTok Promotional Videos for [video ID] in [target marketplace]. Use [my selected category id] to narrow the results. Report only what the selected records support.
10. Narrow Results By Shop ID
Prompt: Compare TikTok Promotional Videos for [video ID] in [target marketplace]. Use [my selected shop id] to narrow the results. Report only what the selected records support.
11. Narrow Results By Creator ID
Prompt: Compare TikTok Promotional Videos for [video ID] in [target marketplace]. Use [my selected creator id] to narrow the results. Report only what the selected records support.
12. Narrow Results By Product ID
Prompt: Compare TikTok Promotional Videos for [video ID] in [target marketplace]. Use [my selected product id] to narrow the results. Report only what the selected records support.
13. Narrow Results By Advertising Roas
Prompt: Compare TikTok Promotional Videos for [video ID] in [target marketplace]. Use [my selected advertising roas] to narrow the results. Report only what the selected records support.
What You Need to Provide
Replace bracketed inputs with your own values. Use only the documented marketplace, period and input formats.
Returned estimates and rankings describe the selected data and period; missing values are not zero and a page of results is not the full market.
Step 1 · Connect
Connect Your AI Assistant
Connect a compatible MCP client to Nexscope, then select this tool from your assistant. Use the connection settings in your client to complete authentication.
POST https://api.nexscope.ai/mcp
MCP-Protocol-Version: 2025-11-25
Content-Type: application/jsonAuthentication
Use OAuth 2.1 Authorization Code with PKCE and the mcp:tools scope. API keys remain supported as a compatibility option.
Authorization: Bearer nk-xxxxxxxxxxxxxxxxxUsing an API key? Get your key from API Access and include it in the Authorization header shown above.
Call this MCP tool
nexscope_tiktok_video_analyticshttps://api.nexscope.ai/mcptools/callInitialize an MCP 2025-11-25 Streamable HTTP session at https://api.nexscope.ai/mcp, then use tools/call.
{
"jsonrpc": "2.0",
"id": "tiktok-video-analytics-1",
"method": "tools/call",
"params": {
"name": "nexscope_tiktok_video_analytics",
"arguments": {
"dateRange": "last30Day",
"pageNumber": 1,
"pageSize": 10,
"region": "US",
"sortField": {},
"videoId": "6768504823336815877"
}
}
}MCP 2025-11-25 · Streamable HTTPProgress is delivered on the original POST SSE response. GET SSE carries notifications; reconnecting must query existing asynchronous work rather than submit again.
Arguments
| Name | Type | Required | Description |
|---|---|---|---|
region | string | optional | Region/market code, e.g., US Example: US |
dateRange | string | optional | Time range, e.g., last7Day, last30Day Example: last30Day |
pageNumber | integer | optional | Page number, value range 1-5 Example: 1 |
pageSize | integer | optional | Items per page, value range 5-100 Example: 10 |
language | string | optional | Return language, e.g., zh-CN, en-US |
currency | string | optional | Currency unit, e.g., USD |
sortField | object | optional | Sort criteria; omitted to use default rank order Example: {} |
category_id | string | optional | Category ID filter |
shop_id | string | optional | Shop ID filter |
creator_id | string | optional | Creator ID filter |
product_id | string | optional | Product ID filter |
revenue_range | string | optional | GMV range; response field revenue is total GMV |
followers_range | string | optional | Creator follower range filter |
ads_roas | number | optional | Advertising ROAS filter |
videoId | string | optional | TikTok video ID, e.g., 7659161409279806734, obtainable from the video_id in the video rank response Example: 6768504823336815877 |
Response fields
Treat structuredContent as the programmatic API response payload.
| Name | Type | Required | Description |
|---|---|---|---|
errcode | integer | optional | Business status code, `200` indicates success |
data | array | optional | Video details data, usually a 1-element array when successful |
costToken | integer | optional | The deduction token for this call is usually `14000` |
errmsg | string | optional | Status message, `ok` on success |
video_id | string | optional | Video ID, string format to avoid loss of precision for large integers |
video_title | string | optional | Video title/copywriting |
video_region | string | optional | Video region, may be an empty string |
belonged_creator_id | string | optional | Attribution expert ID |
belonged_creator_handle | string | optional | Attribution expert username |
views | integer | optional | Play volume |
digg_count | integer | optional | Number of likes |
comment_count | integer | optional | Number of comments |
share_count | integer | optional | Number of shares |
revenue | number | optional | Total Sales/GMV |
sales_volumn | integer | optional | Sales volume, field spelled `volumn` |
video_gpm | number | optional | Video GPM, or GMV per thousand plays |
ad | integer | optional | Whether to run ads, 1=with ads, 0=without ads |
ads_views | integer | optional | Number of ad plays |
ads_roas | number | optional | Advertising ROAS |
ad_cpa | number | optional | Advertising CPA |
ad_view_ratio | number | optional | Advertisement playback proportion (%) |
ads_period | integer | optional | Advertising period (days) |
duration | number | optional | Video duration (seconds) |
product_number | integer | optional | Number of video related products |
Example Q&A
Based on a published documentation sample, not a live tool call.
Your Question
Compare TikTok promotional videos by views, engagement, and sales revenue. Focus on Vietnam.
Example Answer
In the published sample, its reported revenue is 139766.7. Its reported comment count is 9. Its reported creator debut is 2025-04-14. These observations apply only to the shown record and reporting scope.
About this sample: Published documentation excerpt, not a live query. Arrays show at most two records and long text may be shortened. Missing units, dates or coverage remain unspecified; the excerpt does not represent the complete dataset.
View the Published Sample Data (JSON)
Published REST data example. Use Parameters & Response for MCP arguments when calling this tool.
Data Example
Sample request and response
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"
}
]
}
}View the MCP Request & Response Format
Examples
Based on a published documentation sample, not a live tool call.
The JSON-RPC envelope below illustrates how the shown arguments and payload fit into MCP. It is not captured network traffic or proof of a successful call. Workflow-only examples do not include a result.
MCP Request
{
"jsonrpc": "2.0",
"id": "tiktok-video-analytics-example",
"method": "tools/call",
"params": {
"name": "nexscope_tiktok_video_analytics",
"arguments": {
"region": "VN",
"dateRange": "last30Day",
"currency": "USD",
"category_id": "601990",
"pageNumber": 1,
"pageSize": 10
}
}
}MCP Response Format
{
"jsonrpc": "2.0",
"id": "tiktok-video-analytics-example",
"result": {
"content": [
{
"type": "text",
"text": "{\"code\":0,\"msg\":null,\"data\":{\"data\":[{\"revenue\":139766.7,\"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\",\"video_title\":\"Cùng chờ đợi điều bất ngờ từ OMO #ThomSangThanhNha #BeautyOfSweat #HetMinhLaXinhNhat #OMO\"},{\"revenue\":134865.74,\"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\",\"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â…\"}]}}"
}
],
"structuredContent": {
"code": 0,
"msg": null,
"data": {
"data": [
{
"revenue": 139766.7,
"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",
"video_title": "Cùng chờ đợi điều bất ngờ từ OMO #ThomSangThanhNha #BeautyOfSweat #HetMinhLaXinhNhat #OMO"
},
{
"revenue": 134865.74,
"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",
"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â…"
}
]
}
},
"isError": false
}
}