Inteligencia de TikTok ET
API de detalles de vídeos de TikTok por lotes MCP
Recuperar detalles para varios TikTok videos en una solicitud para comparar su contenido y la información de rendimiento disponible.
Prompts y casos de uso de API de detalles de vídeos de TikTok por lotes
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. Compare los detalles disponibles de varios TikTok videos
Prompt: Compare los detalles disponibles de varios TikTok videos para [video IDs]. Mostrar los resultados disponibles e identificar claramente la información que falta.
2. Compare los detalles disponibles de varios TikTok videos por Video Links
Prompt: Compare los detalles disponibles de varios TikTok vídeos [video links]. Mantener los resultados devueltos atados a esa entrada y no inferir partidos que no fueron devueltos.
3. Compare el rendimiento de vídeo Windows
Prompt: Compare los detalles disponibles de varios TikTok videos para [video IDs]. Mostrar los resultados disponibles e identificar claramente la información que falta. Compare las vistas y le gusta por separado para las ventanas de un día, siete días y 30 días. No agregue ventanas superpuestas o infiera el crecimiento de duraciónes desiguales.
4. Revisión Comercio y Etiquetas de Publicidad
Prompt: Compare los detalles disponibles de varios TikTok videos para [video IDs]. Mostrar los resultados disponibles e identificar claramente la información que falta. Mostrar enlaces de productos devueltos, cuenta de venta y GMV junto con publicidad y AI- Etiquetas creadas. No inferir un efecto ad causal o un ingreso neto.
5. Reutilización del plan de dimensiones de vídeo
Prompt: Compare los detalles disponibles de varios TikTok videos para [video IDs]. Mostrar los resultados disponibles e identificar claramente la información que falta. Duración del inventario, ancho, altura, relación de aspecto y oficial URL para cada vídeo devuelto. Bandera datos técnicos no disponibles; no asuma derechos de reutilización o edite los vídeos.
6. Combinar vídeo conocido IDs and Links
Prompt: Recuperar detalles para [up to 1,000 video IDs] junto con [up to 1,000 full TikTok video URLs]. Deja que la herramienta fusione el extracto IDs y mantener las identidades retornadas visibles. No asuma entradas duplicadas producen videos distintos o que no se revocan IDs son válidos.
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.
Uso a la mayoría de 1.000 IDs y en la mayoría de 1.000 TikTok video URLs. IDs y URLs se pueden suministrar juntos; se fusionan, no se excluyen mutuamente.
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_et_batch_video_detailhttps://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-et-batch-video-detail-1",
"method": "tools/call",
"params": {
"name": "nexscope_data_et_batch_video_detail",
"arguments": {
"videoIds": [
"7030893014180531462",
"6768504823336815877",
"7425631540178160939"
]
}
}
}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 |
|---|---|---|---|
videoIds | array | opcional | TikTok video ID lista, hasta 1000. Puede obtenerse de los resultados de las consultas de la lista de vídeo Cantidad máxima de elementos: 1000 |
videoIds[] | string | obligatorio | TikTok video ID lista, hasta 1000. Puede obtenerse de los resultados de las consultas de la lista de vídeo |
videoUrls | array | opcional | Lista de TikTok video URLs (en forma de `https://www.tiktok.com/@<unique_id>/video/<videoId>` o `https://www.tiktok.com/video/<videoId>`), hasta 1.000; el servidor extrae el último `videoId` de cada uno URL y lo fusiona `videoIds`, que no es mutuamente excluyente con `videoIds` Cantidad máxima de elementos: 1000 |
videoUrls[] | string | obligatorio | Lista de TikTok video URLs (en forma de `https://www.tiktok.com/@<unique_id>/video/<videoId>` o `https://www.tiktok.com/video/<videoId>`), hasta 1.000; el servidor extrae el último `videoId` de cada uno URL y lo fusiona `videoIds`, que no es mutuamente excluyente con `videoIds` |
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 comercial, 200 indica éxito (ver código de error abajo para detalles) |
errmsg | string | opcional | Descripción del estado empresarial |
total | integer | opcional | Número de vídeos devueltos |
columns | array | opcional | Definición de columna remitente (cada elemento contiene) `field`/`title`/`cellType`/`filterable`/`sortable`) |
videos | array | opcional | Lista de detalles de vídeo (ver campo de objeto de vídeo abajo para detalles) |
costToken | integer | opcional | Consume token |
type | string | opcional | Estilo de rendering (como `tableListWorkbenches`) |
videoId | string | opcional | Video ID |
videoDesc | string | opcional | Video description/copywriting |
officialUrl | string | opcional | TikTok dirección de vídeo oficial |
coverUrl | string | opcional | Cubierta de vídeo URL |
duration | integer | opcional | Duración del vídeo (segundos) |
width | string | opcional | Ancho de vídeo (px) |
height | string | opcional | Altura de vídeo (px) |
ratio | string | opcional | Definición de vídeo (como 540p/720p) |
dataSize | string | opcional | Tamaño del archivo de vídeo |
createDate | string | opcional | Fecha de lanzamiento de vídeo (yyyyy-MM- No. HH:mm:ss) |
userId | string | opcional | Expert ID |
uniqueId | string | opcional | TikTok cuenta ID (unique_id) |
avatar | string | opcional | Maestro avatar URL |
totalViewsCnt | integer | opcional | Total de opiniones |
totalViews1dCnt | integer | opcional | Aumento del volumen de juego en el último día |
totalViews7dCnt | integer | opcional | Aumento del volumen de reproducción en los últimos 7 días |
totalViews30dCnt | integer | opcional | Aumento del volumen de reproducción en los últimos 30 días |
totalDiggCnt | integer | opcional | Total likes |
totalDigg1dCnt | integer | opcional | Incremento de gustos en los últimos 1 día |
totalDigg7dCnt | integer | opcional | Incremento de gustos en los últimos 7 días |
totalDigg30dCnt | integer | opcional | Incremento de gustos en los últimos 30 días |
totalCommentsCnt | integer | opcional | Total de observaciones |
totalSharesCnt | integer | opcional | Total de acciones |
totalFavoritesCnt | integer | opcional | Total collections |
totalVideoSaleCnt | integer | opcional | Venta de vídeo (piezas, estimación) |
totalVideoSaleGmvAmt | integer | opcional | Ventas de vídeo GMV (número estimado) |
salesFlagText | string | opcional | Ya sea para traer vídeo de mercancías (yes/no) |
isAdText | string | opcional | Ya sea para transmitir vídeo (yes/no) |
createdByAiText | string | opcional | Ya. AI video (en inglés)yes/no/unknown) |
productCategoryList | string | opcional | Clasificación de los productos asociadosJSON cuerda, vacío significa `[]`) |
videoProducts | string | opcional | Producto con vídeoJSON cuerda, vacío significa `[]`) |
region | string | opcional | Código de región donde se encuentra el vídeo |
sourceType | string | opcional | Fuente de datos (como TikTok) |
Ilustración del formato
Ejemplo ilustrativo con datos ficticios, no una llamada en vivo a la herramienta.
Pregunta ilustrativa
Mostrar los detalles de TikTok video 7030893014180531462.
Explicación ilustrativa de la respuesta
El resultado ilustrativo contiene una demostración de productos de 30 segundos con 1.000 visualizaciones totales. Estos valores de muestra no establecen ventas ni el rendimiento de otros vídeos.
Sobre esta muestra: Ejemplo de formato ilustrativo con duración y vistas ficticias, no una búsqueda de vídeo en vivo.
No hay datos de ejemplo publicados para esta página. Una ilustración del formato o una guía de flujo de trabajo no sustituye un resultado publicado.
Ver el formato de solicitud y respuesta MCP
Ejemplos
Ejemplo ilustrativo con datos ficticios, no una llamada en vivo a la herramienta.
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
{
"jsonrpc": "2.0",
"id": "data-et-batch-video-detail-example",
"method": "tools/call",
"params": {
"name": "nexscope_data_et_batch_video_detail",
"arguments": {
"videoIds": [
"7030893014180531462"
]
}
}
}Formato de respuesta MCP
{
"jsonrpc": "2.0",
"id": "data-et-batch-video-detail-example",
"result": {
"content": [
{
"type": "text",
"text": "{\"code\":0,\"msg\":null,\"data\":{\"total\":1,\"videos\":[{\"videoId\":\"7030893014180531462\",\"videoDesc\":\"Example product demonstration\",\"duration\":30,\"totalViewsCnt\":1000}]}}"
}
],
"structuredContent": {
"code": 0,
"msg": null,
"data": {
"total": 1,
"videos": [
{
"videoId": "7030893014180531462",
"videoDesc": "Example product demonstration",
"duration": 30,
"totalViewsCnt": 1000
}
]
}
},
"isError": false
}
}