Nexscope

API de análisis de vídeos de TikTok

Compara vídeos promocionales de TikTok por visualizaciones, interacción e ingresos por ventas. Invoca la API mediante REST o MCP desde 15 créditos por llamada.

Coste15 créditos / llamada
Probar en línea
POST · https://api.nexscope.ai/kd/video/detailMCP · nexscope_tiktok_video_analytics

Qué hace esta API

Compare los videos promocionales de TikTok por vistas, compromiso e ingresos de ventas.

Casos de uso de API de análisis de vídeos de TikTok

Investigar análisis de vídeo TikTok

Para investigar el análisis de vídeo de tiktok, un analista del mercado presenta videoId y región a TikTok Video Analytics. El error devuelto, errmsg, video_id ayudar a investigar la operación solicitada.

Recopilar pruebas de análisis de vídeo TikTok

Un analista de mercado utiliza TikTok Video Analytics con videoId y región para recoger pruebas de análisis de vídeo de tiktok. video_id ayudar a comparar las pruebas para el alcance solicitado.

Revisión de resultados de análisis de vídeo TikTok

Para este flujo de trabajo, un analista de mercado llama a TikTok Video Analytics con videoId y región para revisar los resultados de análisis de vídeo de tiktok. El resultado ayuda a revisar los hechos devueltos con el equipo.

Preguntas frecuentes sobre API de análisis de vídeos de TikTok

¿Qué hace el análisis de vídeo TikTok? API ¿Volver?

Compare los videos promocionales de TikTok por vistas, compromiso e ingresos de ventas. `errcode`, `errmsg`, `video_id`, `video_title`, `video_region`, `belonged_creator_id`, `belonged_creator_handle`, `views`. Corresponde a los parámetros proporcionados `videoId`, `region`, `dateRange`, `language`, `currency`. Los campos opcionales pueden estar ausentes; un valor que falta no debe interpretarse como un cero medido. Los valores de ejemplo ilustran la forma de respuesta, en lugar de los resultados reales de la cuenta.

¿Cuántos créditos tiene el TikTok Video Analytics API ¿costo?

El coste documentado actualmente es 15 créditos / llamada. Es el mismo que figura en la parte superior de esta página. Si se muestra un intervalo o una estimación, el cargo final depende de la solicitud. Antes de llamar a la API, revisa los créditos disponibles y la página de precios. Consulta el registro de uso de la API para comprobar el cargo aplicado.

¿Cómo llamo a la analítica de vídeo TikTok API desde mi aplicación o un MCP ¿Cliente?

Enviar a POST solicitud a /kd/video/detail con tu API como un símbolo de portador y la JSON datos de entrada API En una MCP cliente como Claude o Cursor, conectar Nexscope y llamar nexscope_tiktok_video_analytics. Utilice el MCP argumentos mostrados en el MCP guía, o cambiar la prueba en línea a MCP para revisar su solicitud antes de añadirla a tu aplicación.

Ver planes y créditosConecta esta API con MCP (en inglés)

Prueba esta API
Endpoint
https://api.nexscope.ai/kd/video/detail
Método MCP
nexscope_tiktok_video_analytics

Paso 1 de 3 · Autenticarse

Autenticación

Todos los endpoints de ejecución requieren una clave de API de usuario. Envíala como token bearer en la cabecera Authorization .

Authorization: Bearer nk-xxxxxxxxxxxxxxxxx
Las claves de API ausentes o no válidas devuelven un error de autenticación. Gestiona las claves desde .

Paso 2 de 3 · Enviar una solicitud

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

Ejecutar una API

Envía un cuerpo de solicitud JSON usando los parámetros descritos abajo.

Solicitud de ejemplo

Sustituye YOUR_API_KEY y ejecuta este comando en tu 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"
}'

Ejemplo de código

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

Paso 3 de 3 · Inspeccionar el resultado

Comprueba la respuesta

Consulta code para ver el estado de la solicitud y data para ver el resultado. Abre la referencia de parámetros y respuestas para consultar las definiciones completas de los campos.

Códigos de estado HTTP

CódigoDescripción
200Respuesta HTTP predeterminada tanto para el éxito como para muchos errores de negocio. Solo el código JSON externo 0 indica éxito o aceptación asíncrona; consulta data para obtener el resultado.
429Límite de admisión de ejecuciones; respeta Retry-After cuando esté presente.
503La admisión de ejecuciones no está disponible temporalmente; respeta Retry-After cuando esté presente.
OpcionalX-Nexscope-Http-Status: semantic asigna estados HTTP a los errores de negocio gestionados por el controlador en las rutas de ejecución y tareas. Los fallos previos a la autenticación, como la ausencia de una clave API (code 11209), pueden seguir devolviendo HTTP 200 antes de esta asignación. Comprueba siempre el código JSON externo; las solicitudes malformadas y los fallos de infraestructura también pueden devolver respuestas HTTP distintas de 200.
Todas las categorías/ Inteligencia de TikTok KD
POSThttps://api.nexscope.ai/kd/video/detail

Ejecutar esta API

Envía una solicitud JSON para ejecutar esta API y recibir los datos de respuesta documentados.

Endpoint

MétodoPOST
Rutahttps://api.nexscope.ai/kd/video/detail
AutenticaciónBearer API key
Content-Typeapplication/json

Parámetros de la solicitud

NombreTipoObligatorioDescripción
videoIdstringobligatorio
ID de vídeo TikTok como `7659161409279806734`, normalmente `video_id` de la lista
regionstringopcional
Código de región/mercado, como `US`
dateRangestringopcional
Plazos, como `last7Day`, `last30Day`
languagestringopcional
Devolver el idioma, por ejemplo `zh-CN`, `en-US`
currencystringopcional
Unidad monetaria, como `USD`

Respuesta de ejemplo

Estructura de respuesta de la plataforma. code 0 indica éxito o aceptación; data contiene el resultado de negocio.

No hay un ejemplo de respuesta publicado para esta API. Consulta los campos de respuesta siguientes.

Campos de respuesta

Referencia de campos de respuesta (24 campos)

NombreTipoObligatorioDescripción
errcodeintegeropcional
Código de la situación empresarial, `200` indica éxito
dataarrayopcional
Detalles de los datos de vídeo, generalmente un array de 1 elemento cuando tiene éxito
costTokenintegeropcional
El token de deducción para esta llamada es generalmente `14000`
errmsgstringopcional
Mensaje de estado, `ok` sobre el éxito
video_idstringopcional
ID de vídeo, formato de cadena para evitar la pérdida de precisión para los números enteros grandes
video_titlestringopcional
Título/escrito de vídeo
video_regionstringopcional
Región de vídeo, puede ser una cadena vacía
belonged_creator_idstringopcional
ID experto en atribución
belonged_creator_handlestringopcional
Nombre de usuario del experto en atribución
viewsintegeropcional
Volumen de reproducción
digg_countintegeropcional
Número de me gusta
comment_countintegeropcional
Número de comentarios
share_countintegeropcional
Número de acciones
revenuenumberopcional
Total de ventas/VMG
sales_volumnintegeropcional
Volumen de ventas, campo escrito `volumn`
video_gpmnumberopcional
Video GPM, o GMV por mil obras de teatro
adintegeropcional
Si ejecutar anuncios, 1=con anuncios, 0=sin anuncios
ads_viewsintegeropcional
Número de obras de teatro
ads_roasnumberopcional
Publicidad ROAS
ad_cpanumberopcional
Publicidad CPA
ad_view_rationumberopcional
Proporción de reproducción de anuncios (%)
ads_periodintegeropcional
Período de publicidad (días)
durationnumberopcional
Duración del vídeo (segundos)
product_numberintegeropcional
Número de productos relacionados con el vídeo

Respuestas

CódigoDescripción
200Respuesta HTTP predeterminada tanto para el éxito como para muchos errores de negocio. Solo el código JSON externo 0 indica éxito o aceptación asíncrona; consulta data para obtener el resultado.
429Límite de admisión de ejecuciones; respeta Retry-After cuando esté presente.
503La admisión de ejecuciones no está disponible temporalmente; respeta Retry-After cuando esté presente.
OpcionalX-Nexscope-Http-Status: semantic asigna estados HTTP a los errores de negocio gestionados por el controlador en las rutas de ejecución y tareas. Los fallos previos a la autenticación, como la ausencia de una clave API (code 11209), pueden seguir devolviendo HTTP 200 antes de esta asignación. Comprueba siempre el código JSON externo; las solicitudes malformadas y los fallos de infraestructura también pueden devolver respuestas HTTP distintas de 200.

Fuente de datos, vigencia y limitaciones

La fuente, la vigencia, la cobertura, los límites de frecuencia y las notas de estimación no se especifican en esta definición de API salvo que aparezcan en la documentación de campos de solicitud o respuesta anterior. No supongas datos oficiales del mercado ni actualización en tiempo real cuando no estén documentados explícitamente.

Paso 1 de 2 · Conectar tu cliente MCP

MCP

Usa el endpoint MCP cuando un agente necesite descubrir y llamar a herramientas de API con JSON-RPC.

GET /mcp/legacy
POST /mcp/legacy
Authorization: Bearer nk-xxxxxxxxxxxxxxxxx
Content-Type: application/json

Paso 2 de 2 · Llamar a la herramienta

Llamar a una herramienta

{
  "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"
    }
  }
}

Ejemplo de datos

Parámetros de solicitud

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

Respuesta

{
  "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"
      }
    ]
  }
}

Prueba en línea

Ejecuta la API actual con tu clave de API y la carga JSON. Las pruebas en línea usan el entorno de API configurado de este sitio; el Endpoint y los ejemplos que puedes copiar usan la dirección de integración pública.

15 créditos / llamadaRegistros de uso de la API

Pruébalo

Envía una solicitud real con el mismo contrato que se muestra en la referencia.

Endpoint
/kd/video/detail
Método de MCP
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" }'
Respuesta
Todavía no hay respuesta. Ejecuta la solicitud para ver la respuesta aquí.

API relacionadas