Inteligencia de TikTok KD
API de clasificaciones de vídeos de TikTok MCP
Rank TikTok videos por medidas de rendimiento disponibles para identificar contenido que vale la pena revisar para investigación de producto y creador.
Prompts y casos de uso de API de clasificaciones de vídeos de TikTok
Después de conectar esta herramienta MCP a tu asistente de IA, puedes plantear las preguntas siguientes. Sustituye los marcadores entre corchetes por tus datos y usa los valores admitidos en Argumentos.
¿Es tu primera vez con Nexscope MCP? Sigue la guía de conexión, y después usa los prompts siguientes. Las pestañas Integración y Parámetros y respuesta contienen los pasos de conexión, un ejemplo de llamada y la referencia técnica.
1. Revisar la clasificación de vídeos de TikTok
Prompt: Revisa los datos devueltos de la clasificación de vídeos de TikTok para [video ID] en [target marketplace]. Muestra los resultados disponibles e indica claramente qué información falta.
2. Consultar las descripciones en otro idioma
Prompt: Revisa los datos devueltos de la clasificación de vídeos de TikTok para [video ID] en [target marketplace]. Presenta las descripciones disponibles en [my preferred supported language] y conserva los identificadores sin cambios.
3. Consultar las cifras en otra moneda
Prompt: Revisa los datos devueltos de la clasificación de vídeos de TikTok para [video ID] en [target marketplace]. Presenta los importes disponibles en [my selected currency]. Usa [my supplied conversion rate] solo si la herramienta requiere un tipo de cambio. No compares importes expresados en monedas distintas.
4. Revisar un período específico
Prompt: Revisa los datos devueltos de la clasificación de vídeos de TikTok para [video ID] en [target marketplace]. Usa [my chosen reporting period] e indica ese período junto a las cifras devueltas. Distingue las instantáneas fechadas de los datos actuales.
5. Continuar resultados con un límite de páginas
Prompt: Revisa los datos devueltos de la clasificación de vídeos de TikTok para [video ID] en [target marketplace]. Empieza en [my selected page] y devuelve [my requested page size] dentro de los límites documentados. Pide permiso antes de consultar otra página y no presentes una sola página como el conjunto completo de datos.
6. Ordenar los resultados para revisarlos
Prompt: Revisa los datos devueltos de la clasificación de vídeos de TikTok para [video ID] en [target marketplace]. Prioriza [my chosen ranking metric] en [my chosen order]. Limita la clasificación a los filtros y al período seleccionados.
7. Filtrar por intervalos de GMV
Prompt: Revisa los datos devueltos de la clasificación de vídeos de TikTok para [video ID] en [target marketplace]. Limita los resultados a [my chosen gmv ranges such as 1-100, >1000, <100 range]. Mantén coherentes los límites inferior y superior y muestra solo los registros coincidentes.
8. Filtrar por ID de categoría
Prompt: Revisa los datos devueltos de la clasificación de vídeos de TikTok para [video ID] en [target marketplace]. Usa [my selected category id] para acotar los resultados. Indica solo lo que respalden los registros seleccionados.
9. Filtrar por ID de tienda
Prompt: Revisa los datos devueltos de la clasificación de vídeos de TikTok para [video ID] en [target marketplace]. Usa [my selected store id] para acotar los resultados. Indica solo lo que respalden los registros seleccionados.
10. Filtrar por ID de creador
Prompt: Revisa los datos devueltos de la clasificación de vídeos de TikTok para [video ID] en [target marketplace]. Usa [my selected expert id filtering] para acotar los resultados. Indica solo lo que respalden los registros seleccionados.
11. Filtrar por ID de producto
Prompt: Revisa los datos devueltos de la clasificación de vídeos de TikTok para [video ID] en [target marketplace]. Usa [my selected product id] para acotar los resultados. Indica solo lo que respalden los registros seleccionados.
12. Filtrar por número de seguidores
Prompt: Revisa los datos devueltos de la clasificación de vídeos de TikTok para [video ID] en [target marketplace]. Usa [my selected number of fans] para acotar los resultados. Indica solo lo que respalden los registros seleccionados.
13. Filtrar por ROAS publicitario
Prompt: Revisa los datos devueltos de la clasificación de vídeos de TikTok para [video ID] en [target marketplace]. Usa [my selected advertising roas filtering] para acotar los resultados. Indica solo lo que respalden los registros seleccionados.
Qué debes proporcionar
Sustituye las entradas entre corchetes por tus propios valores. Usa únicamente los mercados, períodos y formatos de entrada documentados.
Las estimaciones y clasificaciones devueltas corresponden a los datos y al período seleccionados. Un valor ausente no equivale a cero y una página de resultados no representa todo el mercado.
Paso 1 · Conectar
Conecta tu asistente de IA
Conecta un cliente MCP compatible a Nexscope y selecciona esta herramienta en tu asistente. Completa la autenticación en la configuración de conexión del cliente.
POST https://api.nexscope.ai/mcp
MCP-Protocol-Version: 2025-11-25
Content-Type: application/jsonAutenticación
Usa el código de autorización OAuth 2.1 con PKCE y el ámbito mcp:tools. Las claves de API siguen siendo una opción de compatibilidad admitida.
Authorization: Bearer nk-xxxxxxxxxxxxxxxxx¿Usas una clave de API? Obtén tu clave en Acceso a la API e inclúyela en el encabezado Authorization que se muestra arriba.
Llamar a esta herramienta MCP
nexscope_data_kd_video_rankhttps://api.nexscope.ai/mcptools/callInicializa una sesión HTTP Streamable MCP 2025-11-25 en https://api.nexscope.ai/mcp y después usa tools/call.
{
"jsonrpc": "2.0",
"id": "data-kd-video-rank-1",
"method": "tools/call",
"params": {
"name": "nexscope_data_kd_video_rank",
"arguments": {
"currency": "USD",
"dateRange": "last7Day",
"pageNumber": 1,
"pageSize": 10,
"region": "US",
"revenue_range": "1-100",
"sortField": {
"field": "revenue",
"type": "DESC"
}
}
}
}MCP 2025-11-25 · Streamable HTTPLa respuesta SSE del POST inicial comunica el progreso. El flujo SSE por GET transmite notificaciones; si se restablece la conexión, consulta la tarea asíncrona existente en vez de enviarla de nuevo.
Argumentos
| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
region | string | opcional | Region/market código, como `US` |
dateRange | string | opcional | Rango de tiempo, como `last7Day`, `last30Day` |
pageNumber | integer | opcional | Número de página, valor 1-5 |
pageSize | integer | opcional | Cantidad por página, valor 5-100 |
language | string | opcional | Lenguaje de retorno, por ejemplo `zh-CN`, `en-US` |
currency | string | opcional | Unidad de moneda, como `USD` |
category_id | string | opcional | Categoría ID filtro |
shop_id | string | opcional | Store ID filtro |
creator_id | string | opcional | Expert ID filtrado |
product_id | string | opcional | Producto ID filtro |
revenue_range | string | opcional | GMV rangos tales como `1-100`, `>1000`, `<100` |
followers_range | string | opcional | Filtrar por número de fans |
ads_roas | number | opcional | Publicidad ROAS filtrado |
sortField | object | opcional | GMV criterios de clasificación, como `{"field":"revenue","type":"DESC"}` |
videoId | string | obligatorio | TikTok video ID, como `7659161409279806734`, se puede obtener de `video_id` en la lista de respuestas |
Campos de respuesta
Usa structuredContent como los datos de respuesta de la API para el procesamiento programático.
| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
errcode | integer | opcional | Código de estado de la operación; `200` indica que se ha completado correctamente |
data | array | opcional | Lista o datos detallados |
costToken | integer | opcional | El token de deducción para esta llamada es generalmente `14000` |
errmsg | string | opcional | Mensaje de estado, `ok` sobre el éxito |
video_id | string | opcional | Video ID, formato de cadena para evitar la pérdida de precisión para los enteros grandes |
video_title | string | opcional | Video title/copywriting |
views | integer | opcional | Volumen de juego |
digg_count | integer | opcional | Número de gustos |
comment_count | integer | opcional | Número de comentarios |
share_count | integer | opcional | Número de acciones |
revenue | number | opcional | Total sales/GMV, devuelto por solicitud `currency` |
revenue_growth_rate | number | opcional | Tasa de crecimiento de las ventas (%), puede ser positiva o negativa |
ad | integer | opcional | Ya sea para usar advertising/product video logo, 1=yes |
ad_view_ratio | number | opcional | Proporción de reproducción de anuncios (%) |
ad_revenue_ratio | number | opcional | Proporción de ventas generadas por publicidad (%) |
ads_roas | number | opcional | Publicidad ROAS |
belonged_creator_id | string | opcional | Perteneciente experto ID |
belonged_creator_handle | string | opcional | Nombre del usuario del experto |
creator_debut | string | opcional | Fecha de entrada del experto (`YYYY-MM-DD`) |
video_id | string | opcional | Video ID, formato de cadena para evitar la pérdida de precisión para los enteros grandes |
video_title | string | opcional | Video title/copywriting |
video_region | string | opcional | Región de vídeo, puede ser una cadena vacía |
belonged_creator_id | string | opcional | Attribution expert ID |
belonged_creator_handle | string | opcional | Attribution expert username |
views | integer | opcional | Volumen de juego |
digg_count | integer | opcional | Número de gustos |
comment_count | integer | opcional | Número de comentarios |
share_count | integer | opcional | Número de acciones |
revenue | number | opcional | Total Sales/GMV |
sales_volumn | integer | opcional | Volumen de ventas, campo deletreado `volumn` |
video_gpm | number | opcional | Video GPMo GMV por mil obras |
ad | integer | opcional | Ya sea para ejecutar anuncios, 1=con anuncios, 0=sin anuncios |
ads_views | integer | opcional | Número de juegos de anuncios |
ads_roas | number | opcional | Publicidad ROAS |
ad_cpa | number | opcional | Publicidad CPA |
ad_view_ratio | number | opcional | Proporción de reproducción de anuncios (%) |
ads_period | integer | opcional | Período de publicidad (días) |
duration | number | opcional | Duración del vídeo (segundos) |
product_number | integer | opcional | Número de productos relacionados con el vídeo |
Guía de flujo de trabajo
Ejemplo de flujo de trabajo, no una respuesta de API verificada.
Tu objetivo
Revisa the returned TikTok video rankings. Centrarse en el US.
Pasos sugeridos
Proporcionar los insumos para esta tarea de investigación y revisar los registros devueltos en la vista de resultados documentada. La documentación disponible no establece una respuesta de ejemplo coincidente, por lo que no se reclama aquí ningún resultado, ejecución métrica o exitosa.
Sobre esta muestra: La ruta se llama como una herramienta de clasificación, pero su actual MCP schema requiere un vídeo individual ID mientras la solicitud publicada lo omite. Esta es una explicación de flujo de trabajo hasta que se resuelva ese conflicto; no se reclama ninguna respuesta válida de clasificación.
Ver los datos de ejemplo publicados (JSON)
Ejemplo de datos REST publicado. Para llamar a esta herramienta, consulta los argumentos MCP en Parámetros y respuesta.
Ejemplo de datos
Ejemplo de solicitud y respuesta
Parámetros de solicitud
{
"region": "US",
"dateRange": "last7Day",
"pageSize": 5,
"pageNumber": 1
}Respuesta
{
"code": 0,
"msg": null,
"data": {
"data": [
{
"comment_count": 5046,
"creator_debut": "2024-02-20",
"revenue_growth_rate": -169.06,
"ad": 1,
"ai_video": 0,
"ad_view_ratio": 4.153016241638658,
"belonged_creator_id": "6785569006138475525",
"ads_roas": 4,
"share_count": 63886,
"belonged_creator_handle": "wrldoflyrics_",
"revenue": 118017,
"video_title": "Never sleep like this again 👀 #cervicalpillow #neckpain #ergonomicpillow #healthysleep #memoryfoampillow ",
"digg_count": 414054,
"publish_date": "2026/10/07 16:17:59",
"views": 12990438,
"ad_revenue_ratio": 80,
"video_id": "7694022745193024799"
},
{
"comment_count": 561,
"creator_debut": "2025-11-03",
"revenue_growth_rate": -178.66,
"ad": 1,
"ai_video": 0,
"ad_view_ratio": 9.204356374431297,
"belonged_creator_id": "7320822121200878638",
"ads_roas": 3.89,
"share_count": 3090,
"belonged_creator_handle": "nuzzlecomfort",
"revenue": 113520,
"video_title": "Tell me I'm not the only one who's bought way too many pillows. 😭👇 #Nuzzle #blackfriday #SleepUpgrade #stiffneck #sidesleeper",
"digg_count": 17295,
"publish_date": "2026/10/20 14:20:00",
"views": 5790595,
"ad_revenue_ratio": 80,
"video_id": "7698712372248104223"
},
{
"comment_count": 5129,
"creator_debut": "2023-07-20",
"revenue_growth_rate": -212.72,
"ad": 1,
"ai_video": 0,
"ad_view_ratio": 16.006940094191393,
"belonged_creator_id": "6546693901460832266",
"ads_roas": 3.55,
"share_count": 15349,
"belonged_creator_handle": "_jen_hamilton_",
"revenue": 112723,
"video_title": "Changed my life. ",
"digg_count": 219760,
"publish_date": "2026/02/17 10:53:10",
"views": 3895048,
"ad_revenue_ratio": 75.45150501672241,
"video_id": "7607862589363670285"
},
{
"comment_count": 111,
"creator_debut": "2025-06-18",
"revenue_growth_rate": -225.85,
"ad": 1,
"ai_video": 0,
"ad_view_ratio": 10.987015868073566,
"belonged_creator_id": "6872508694422078469",
"ads_roas": 3.87,
"share_count": 10738,
"belonged_creator_handle": "mrs.alex_learnandplay",
"revenue": 101455,
"video_title": "The look on their face when creation come to life! Perfect gift for kids that love to create! @AOSEED USstore #screenfreeactivities #christmasgiftidea #giftforkids #3dprinting #giftforteens ",
"digg_count": 18616,
"publish_date": "2026/10/19 21:14:09",
"views": 4065963,
"ad_revenue_ratio": 79.84466019417475,
"video_id": "7698552088674045198"
},
{
"comment_count": 631,
"creator_debut": "2025-10-23",
"revenue_growth_rate": -190.49,
"ad": 1,
"ai_video": 0,
"ad_view_ratio": 11.692248189357255,
"belonged_creator_id": "7453413077551072302",
"ads_roas": 3.89,
"share_count": 5038,
"belonged_creator_handle": "holisticallyjulia",
"revenue": 98910,
"video_title": "",
"digg_count": 64354,
"publish_date": "2026/10/14 00:10:41",
"views": 5186556,
"ad_revenue_ratio": 80,
"video_id": "7696371077299178783"
}
]
}
}Ver el formato de solicitud y respuesta MCP
Ejemplos
Ejemplo de flujo de trabajo, no una respuesta de API verificada.
La estructura JSON-RPC siguiente muestra cómo se presentan en MCP los argumentos y los datos indicados. No procede de una captura de tráfico ni demuestra que la llamada se haya completado. Los ejemplos de flujo de trabajo no muestran un resultado.
Solicitud MCP
No hay un ejemplo verificado de solicitud MCP. Consulta Integración y los requisitos documentados antes de preparar una llamada.
Formato de respuesta MCP
Este flujo de trabajo no afirma haber obtenido un resultado de la API. No hay un ejemplo de respuesta verificado; consulta Parámetros y respuesta para ver la estructura documentada.