Inteligencia de TikTok KD

API de detalles de emisiones en directo de TikTok MCP

Retire un TikTok livestream by ID para revisar la información de ventas y rendimiento disponibles para su región y rango de fecha elegido.

CosteRecent 22 créditos por llamadaPrueba en línea

Prompts y casos de uso de API de detalles de emisiones en directo 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. Revisa a TikTok métricas de rendimiento disponibles

Prompt: Revisa a TikTok métricas de rendimiento disponibles para livestream [livestream ID] dentro [target marketplace]. Mostrar los resultados disponibles e identificar claramente la información que falta.

2. Investigación en un idioma seleccionado

Prompt: Revisa a TikTok métricas de rendimiento disponibles para livestream [livestream ID] dentro [target marketplace]. Volver las descripciones disponibles en [my preferred supported language], manteniendo los identificadores sin cambios.

3. Investigación en una moneda seleccionada

Prompt: Revisa a TikTok métricas de rendimiento disponibles para livestream [livestream ID] dentro [target marketplace]. Presentar los valores monetarios disponibles [my selected currency], utilizando [my supplied conversion rate] sólo si la herramienta requiere uno. No compare las cantidades en diferentes monedas.

4. Revise un período específico de presentación de informes

Prompt: Revisa a TikTok métricas de rendimiento disponibles para livestream [livestream ID] dentro [target marketplace]. Uso [my chosen reporting period] y mostrar el período con las cifras devueltas. Mantenga las instantáneas datadas distintas de los datos actuales.

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/json

Autenticació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

Nombre de la herramienta MCP

nexscope_data_kd_livestream_detail

Punto de conexión MCP

https://api.nexscope.ai/mcp

Método JSON-RPC

tools/call

Inicializa 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-livestream-detail-1",
  "method": "tools/call",
  "params": {
    "name": "nexscope_data_kd_livestream_detail",
    "arguments": {
      "currency": "USD",
      "dateRange": "last7Day",
      "livestreamId": "7661409374878878494",
      "region": "US"
    }
  }
}

MCP 2025-11-25 · Streamable HTTP

La 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
`livestreamId`	`string`	obligatorio	Objetivo en directo emisiones únicas ID, como `7661409374878878494`, generalmente `livestream_id` de la lista; longitud máxima 1000
`region`	`string`	opcional	Region/market código, como `US`; longitud máxima 1000
`dateRange`	`string`	opcional	Rango de tiempo, como `last7Day` (últimos 7 días), `last30Day` (últimos 30 días); longitud máxima 1000
`language`	`string`	opcional	Lenguaje de retorno, por ejemplo `zh-CN`, `en-US`
`currency`	`string`	opcional	Unidad de moneda, como `USD`

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	Datos de transmisión en vivo, siempre una gama de 1 elemento cuando tenga éxito
`costToken`	`integer`	opcional	El token de deducción para esta llamada se fija a `14000`
`errmsg`	`string`	opcional	Mensaje de estado, `ok` sobre el éxito
`livestream_id`	`string`	opcional	Transmisión en vivo única ID, de conformidad con lo solicitado `livestreamId`
`livestream_title`	`string`	opcional	Título en vivo, como `24 HOUR STREAM`
`creator_id`	`string`	opcional	El único ID of the expert (string, to avoid loss of large integer accuracy)
`creator_handle`	`string`	opcional	Expert username/handle, como `pokepiglt`
`livestream_start_time`	`integer`	opcional	Tiempo de inicio de transmisión en vivo, época milisegundos
`livestream_end_time`	`integer`	opcional	Tiempo de transmisión en vivo, época milisegundos
`livestream_duration`	`integer`	opcional	Duración de transmisión en vivo, segundos de unidad
`record_type`	`string`	opcional	Tipo de registro, como `SHORT`
`viewers`	`integer`	opcional	Número de espectadores; uso `viewers` para detalles y `views` para listas
`revenue`	`number`	opcional	Vivir sales/GMV, devuelto por solicitud `currency`; detalles son de tipo numérico
`gpm`	`number`	opcional	GMV per mille, GMV por mil impresiones; detalles exclusivos
`product_number`	`integer`	opcional	Número de bienes entregados en vivo

Ilustración del formato

Ejemplo ilustrativo con datos ficticios, no una llamada en vivo a la herramienta.

Pregunta ilustrativa

Revisa a TikTok métricas de rendimiento disponibles de livestream. Use livestream ID 7661409374878878494. Centrarse en el US.

Explicación ilustrativa de la respuesta

El resultado ilustrativo muestra ingresos: 19.99. Estas cifras describen sólo el registro mostrado. A partir de este ejemplo, no se pueden calcular las medidas que faltan.

Sobre esta muestra: Ejemplo ilustrativo con registros ficticios; no procede de una llamada real. Los identificadores, precios y recuentos son datos de demostración.

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