Nexscope

API de análisis de directos de TikTok

Compara emisiones comerciales en directo de TikTok por ingresos por ventas, espectadores y productos vendidos. Invoca la API mediante REST o MCP desde 15 créditos por llamada.

CosteRecent Avg. 22 · Range 11–22 credits / call
Probar en línea
POST · https://api.nexscope.ai/kd/livestream/rankMCP · nexscope_tiktok_livestream_analytics

Qué hace esta API

Compare TikTok compras en directo por ingresos de ventas, espectadores y productos vendidos.

Casos de uso de API de análisis de directos de TikTok

Socios de contenido de comercio de listas cortas

Para seleccionar a los socios de contenido del comercio, un analista del mercado presenta la región y dateRange a TikTok Livestream Analytics. El errcode devuelto, errmsg, livestream_start_time ayudar a identificar posibles socios para una campaña comercial.

Revisar la evidencia de creador público o transmisión en vivo

Un analista de mercado utiliza TikTok Livestream Analytics con la región y dateRange para revisar la evidencia de creador público o transmisión en vivo. livestream_start_time ayudar a comparar las pruebas de contenido público para los socios seleccionados.

Preparar un informe de investigación de la campaña

Para este flujo de trabajo, un analista de mercado llama a TikTok Livestream Analytics con la región y dateRange El resultado ayuda a seleccionar creadores o transmisiones en vivo para una exposición informativa sobre la campaña.

Preguntas frecuentes sobre API de análisis de directos de TikTok

¿Qué hace el análisis en vivo TikTok? API ¿Volver?

Compare TikTok compras en directo por ingresos de ventas, espectadores y productos vendidos. `errcode`, `errmsg`, `livestream_start_time`, `livestream_end_time`, `livestream_duration`, `livestream_title`, `livestream_id`, `creator_id`. Corresponde a los parámetros proporcionados `region`, `dateRange`, `pageNumber`, `pageSize`, `language`. 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 análisis de Livestream TikTok? API ¿costo?

El coste documentado actualmente es Recent Avg. 22 · Range 11–22 credits / call. 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 al análisis de transmisión en vivo TikTok? API desde mi aplicación o un MCP ¿Cliente?

Enviar a POST solicitud a /kd/livestream/rank 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_livestream_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

Prueba esta API
Endpoint
https://api.nexscope.ai/kd/livestream/rank
Método MCP
nexscope_tiktok_livestream_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/livestream/rank

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/livestream/rank' \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "currency": "USD",
  "dateRange": "last7Day",
  "pageNumber": 1,
  "pageSize": 5,
  "region": "US"
}'

Ejemplo de código

{
  "currency": "USD",
  "dateRange": "last7Day",
  "pageNumber": 1,
  "pageSize": 5,
  "region": "US"
}

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 una clave API ausente o no válida (code 11209, incluida una copia incompleta o dañada) o una sesión web caducada (code 12001), 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/livestream/rank

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/livestream/rank
AutenticaciónBearer API key
Content-Typeapplication/json

Parámetros de la solicitud

NombreTipoObligatorioDescripción
regionstringopcional
Código de región/mercado, como `US`; longitud máxima 1000
dateRangestringopcional
Plazos, como `last7Day` (últimos 7 días), `last30Day` (últimos 30 días); duración máxima 1000
pageNumberintegeropcional
Número de página, valor 1-5; de retornos fuera de rango `errcode 501`
pageSizeintegeropcional
Cantidad por página, valor 5-100
languagestringopcional
Devolver el idioma, por ejemplo `zh-CN`, `en-US`
currencystringopcional
Unidad monetaria, como `USD`
category_idstringopcional
Filtro de ID de categoría
shop_idstringopcional
Filtro de ID de almacenamiento
creator_idstringopcional
Filtrado de ID experto
product_idstringopcional
Filtro de ID de producto
followers_rangestringopcional
Filtrar por número de ventiladores
sortFieldobjectopcional
Condiciones de clasificación, la estructura está definida por la puerta de entrada; cuando no se clasifica, pasar un objeto vacío `{}`
livestreamIdstringobligatorio
Transmisión en vivo ID único, como `7661409374878878494`, normalmente `livestream_id` de la lista; longitud máxima 1000

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 (27 campos)

NombreTipoObligatorioDescripción
errcodeintegeropcional
Business status code, `200` indicates success
dataarrayopcional
Live broadcast list or live broadcast details
costTokenintegeropcional
The deduction token for this call is fixed to `14000`
errmsgstringopcional
Status message, `ok` on success
livestream_start_timeintegeropcional
Live broadcast start time (epoch milliseconds)
livestream_end_timeintegeropcional
Live broadcast end time (epoch milliseconds)
livestream_durationintegeropcional
Live broadcast duration (seconds)
livestream_titlestringopcional
Live title
livestream_idstringopcional
The unique ID of the live broadcast (a string to avoid the loss of large integer precision), which can be used as the `livestreamId` of the details interface
creator_idstringopcional
The unique ID of the expert (string, to avoid loss of large integer precision)
creator_handlestringopcional
Expert account handle
revenuestringopcional
Total sales/GMV, returned by requested `currency`; returned as a string, such as `"185590.52"`
unit_pricestringopcional
The unit price of the piece is returned according to the requested `currency`; the return is a string, such as `"265.89"`
viewsintegeropcional
Number of views
record_typestringopcional
Record type, such as `SHORT`
livestream_idstringopcional
Live broadcast unique ID, consistent with the requested `livestreamId`
livestream_titlestringopcional
Live title, such as `24 HOUR STREAM`
creator_idstringopcional
The unique ID of the expert (string, to avoid loss of large integer precision)
creator_handlestringopcional
Expert username/handle, such as `pokepiglt`
livestream_start_timeintegeropcional
Live broadcast start time, epoch milliseconds
livestream_end_timeintegeropcional
Live broadcast end time, epoch milliseconds
livestream_durationintegeropcional
Live broadcast duration, unit seconds
record_typestringopcional
Record type, such as `SHORT`
viewersintegeropcional
Number of viewers; use `viewers` for details and `views` for lists
revenuenumberopcional
Live sales/GMV, returned by requested `currency`; details are of type numeric
gpmnumberopcional
GMV per mille, GMV per thousand impressions; details exclusive
product_numberintegeropcional
Number of goods delivered live

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 una clave API ausente o no válida (code 11209, incluida una copia incompleta o dañada) o una sesión web caducada (code 12001), 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_livestream_analytics",
    "arguments": {
      "dateRange": "last30Day",
      "pageNumber": 1,
      "pageSize": 10,
      "region": "US",
      "sortField": {}
    }
  }
}

¿Qué puedes hacer con esta API?

Datos explicados y casos de uso prácticos

AI Guide

Question

What can TikTok Livestream Analytics tell me about shopping streams, and how might I use it?

AI answer

Query TikTok shopping livestream rankings for a market and date range, or request a specific stream with livestreamId. List and detail responses document some different fields and value types.

Data categoryDocumented fieldsWhat the values mean
Stream and creatorlivestream_id, livestream_title, creator_id, creator_handleIdentifies the broadcast and its creator. A list result’s ID can be used for a detail request.
Timinglivestream_start_time, livestream_end_time, livestream_durationStart and end times in epoch milliseconds and broadcast length in seconds.
Audienceviews, viewersviews is documented for list results; viewers is documented for details.
Salesrevenue, unit_priceReported livestream GMV and unit price in the requested currency; list values are documented as strings, while detail revenue is numeric.
Detail performancegpm, product_numberDetail-level GMV per thousand impressions and number of products delivered live.
Record contextrecord_typeThe reported record type, such as SHORT.
  • Compare streams in a selected market by reported GMV and views within the requested date range.
    • Prompt example: “I am researching TikTok marketplace data. Could you compare streams in a selected market by reported GMV and views within the requested date range? Show the returned values behind the comparison, and mark missing data.”
  • Identify a stream by livestream_id, then request its details to inspect viewers, gpm, and product_number when returned.
    • Prompt example: “I am researching TikTok marketplace data. Could you identify a stream by livestream_id, then request its details to inspect viewers, gpm, and product_number when returned? Show matching records and source links where the API provides them; ask me for any required identifier or filter.”
  • Compare stream duration with sales to investigate which broadcasts merit closer review.
    • Prompt example: “I am researching TikTok marketplace data. Could you compare stream duration with sales to investigate which broadcasts merit closer review? Show the returned values behind the comparison, and mark missing data.”
  • Filter by a creator or product ID to examine relevant broadcasts, then inspect the returned titles and performance fields.
    • Prompt example: “I am researching TikTok marketplace data. Could you filter by a creator or product ID to examine relevant broadcasts, then inspect the returned titles and performance fields? Show matching records and source links where the API provides them; ask me for any required identifier or filter.”

Ejemplo de datos

Ejemplo de solicitud y respuesta

Parámetros de solicitud

{
  "region": "US",
  "page": 1,
  "size": 5
}

Respuesta

{
  "code": 0,
  "msg": null,
  "data": {
    "data": [
      {
        "livestream_start_time": "1790105782000",
        "livestream_duration": 29998,
        "revenue": "327961.84",
        "livestream_title": "",
        "creator_id": "6677756329987228678",
        "livestream_id": "7688445351061195533",
        "creator_handle": "byenblanfaktori",
        "unit_price": "7.73",
        "livestream_end_time": "1790135780000",
        "views": 408515,
        "record_type": "SHORT"
      },
      {
        "livestream_start_time": "1789468902000",
        "livestream_duration": 522419,
        "revenue": "124951.0",
        "livestream_title": "DEALS FOR YOU - Live Now!",
        "creator_id": "7153432386608251946",
        "livestream_id": "7685709140785728287",
        "creator_handle": "based",
        "unit_price": "27.83",
        "livestream_end_time": "1789991321000",
        "views": 3813644,
        "record_type": "SHORT"
      },
      {
        "livestream_start_time": "1790143565000",
        "livestream_duration": 4489,
        "revenue": "122173.0",
        "livestream_title": "DEALS FOR YOU - Live Now!",
        "creator_id": "7153432386608251946",
        "livestream_id": "7688607461032348446",
        "creator_handle": "based",
        "unit_price": "28.38",
        "livestream_end_time": "1790148054000",
        "views": 35956,
        "record_type": "SHORT"
      },
      {
        "livestream_start_time": "1789948635000",
        "livestream_duration": 21369,
        "revenue": "105431.93",
        "livestream_title": "Ripping The Hottest Sports Cards",
        "creator_id": "6688398622600692742",
        "livestream_id": "7687770584767318815",
        "creator_handle": "burtonbreaks",
        "unit_price": "184.0",
        "livestream_end_time": "1789970004000",
        "views": 359696,
        "record_type": "SHORT"
      },
      {
        "livestream_start_time": "1790338081000",
        "livestream_duration": 127381,
        "revenue": "104258.0",
        "livestream_title": "DEALS FOR YOU - Live Now!",
        "creator_id": "7153432386608251946",
        "livestream_id": "7689442635441834782",
        "creator_handle": "based",
        "unit_price": "28.38",
        "livestream_end_time": "1790465462000",
        "views": 1064234,
        "record_type": "SHORT"
      },
      {
        "livestream_start_time": "1790355613000",
        "livestream_duration": 43808,
        "revenue": "104146.5",
        "livestream_title": "MINT MONEY STAR ROBE DROP 💚💸",
        "creator_id": "6787875411281134598",
        "livestream_id": "7689518323038128910",
        "creator_handle": "jeffreestar",
        "unit_price": "28.59",
        "livestream_end_time": "1790399421000",
        "views": 497834,
        "record_type": "SHORT"
      },
      {
        "livestream_start_time": "1790383058000",
        "livestream_duration": 20813,
        "revenue": "98712.94",
        "livestream_title": "Hola❤️",
        "creator_id": "6800598044448457733",
        "livestream_id": "7689636419756706591",
        "creator_handle": ".brendaayala1",
        "unit_price": "29.7",
        "livestream_end_time": "1790403871000",
        "views": 315245,
        "record_type": "SHORT"
      },
      {
        "livestream_start_time": "1789992320000",
        "livestream_duration": 4512,
        "revenue": "94207.0",
        "livestream_title": "DEALS FOR YOU - Live Now!",
        "creator_id": "7153432386608251946",
        "livestream_id": "7687957811115969310",
        "creator_handle": "based",
        "unit_price": "29.9",
        "livestream_end_time": "1789996832000",
        "views": 32863,
        "record_type": "SHORT"
      },
      {
        "livestream_start_time": "1790092508000",
        "livestream_duration": 14896,
        "revenue": "87770.93",
        "livestream_title": "💝Medicube x Nello Collab Mega💝",
        "creator_id": "7291517492299007018",
        "livestream_id": "7688388230848219917",
        "creator_handle": "medicube_official_shop",
        "unit_price": "34.31",
        "livestream_end_time": "1790107404000",
        "views": 61503,
        "record_type": "FULL"
      },
      {
        "livestream_start_time": "1790017706000",
        "livestream_duration": 12414,
        "revenue": "79376.5",
        "livestream_title": "",
        "creator_id": "7014603102829593606",
        "livestream_id": "7688067090044963598",
        "creator_handle": "simplymandys",
        "unit_price": "37.65",
        "livestream_end_time": "1790030120000",
        "views": 80987,
        "record_type": "SHORT"
      },
      {
        "livestream_start_time": "1790355686000",
        "livestream_duration": 10779,
        "revenue": "73958.43",
        "livestream_title": "NOELY FAJAS MEGA LIVE",
        "creator_id": "6801519791112897542",
        "livestream_id": "7689518679498787614",
        "creator_handle": "noelyfajas",
        "unit_price": "89.65",
        "livestream_end_time": "1790366465000",
        "views": 75247,
        "record_type": "FULL"
      },
      {
        "livestream_start_time": "1790270453000",
        "livestream_duration": 51829,
        "revenue": "72404.21",
        "livestream_title": "",
        "creator_id": "6829169369835127814",
        "livestream_id": "7689152573131066125",
        "creator_handle": "calicurvesfajas",
        "unit_price": "65.7",
        "livestream_end_time": "1790322282000",
        "views": 222287,
        "record_type": "SHORT"
      },
      {
        "livestream_start_time": "1790355124000",
        "livestream_duration": 36821,
        "revenue": "70073.0",
        "livestream_title": "Fajas colombianas   🇨🇴",
        "creator_id": "7179385436960310318",
        "livestream_id": "7689516256734530317",
        "creator_handle": "alondrixsexycurves",
        "unit_price": "118.17",
        "livestream_end_time": "1790391945000",
        "views": 165052,
        "record_type": "SHORT"
      },
      {
        "livestream_start_time": "1790295054000",
        "livestream_duration": 23887,
        "revenue": "68666.76",
        "livestream_title": "Hola!!❤️",
        "creator_id": "6800598044448457733",
        "livestream_id": "7689258465444760351",
        "creator_handle": ".brendaayala1",
        "unit_price": "26.07",
        "livestream_end_time": "1790318941000",
        "views": 281085,
        "record_type": "SHORT"
      },
      {
        "livestream_start_time": "1790108377000",
        "livestream_duration": 3533,
        "revenue": "64389.0",
        "livestream_title": "DEALS FOR YOU - Live Now!",
        "creator_id": "7153432386608251946",
        "livestream_id": "7688456553828993823",
        "creator_handle": "based",
        "unit_price": "28.59",
        "livestream_end_time": "1790111910000",
        "views": 40296,
        "record_type": "SHORT"
      },
      {
        "livestream_start_time": "1790249163000",
        "livestream_duration": 127738,
        "revenue": "63659.89",
        "livestream_title": "RIPS ALL DAYYY!!!",
        "creator_id": "6906678272890848261",
        "livestream_id": "7689060444446722847",
        "creator_handle": "allpoketcg",
        "unit_price": "142.42",
        "livestream_end_time": "1790376901000",
        "views": 167774,
        "record_type": "SHORT"
      },
      {
        "livestream_start_time": "1790116436000",
        "livestream_duration": 2818,
        "revenue": "62098.65",
        "livestream_title": "FAST PACED TECH Nick",
        "creator_id": "7617890876685108238",
        "livestream_id": "7688491201942522655",
        "creator_handle": "refreshed.tech",
        "unit_price": "459.99",
        "livestream_end_time": "1790119254000",
        "views": 13763,
        "record_type": "SHORT"
      },
      {
        "livestream_start_time": "1790285688000",
        "livestream_duration": 31709,
        "revenue": "54655.29",
        "livestream_title": "",
        "creator_id": "7043091206013060102",
        "livestream_id": "7689218099326225165",
        "creator_handle": "glamourmodernfashion1",
        "unit_price": "73.07",
        "livestream_end_time": "1790317397000",
        "views": 66047,
        "record_type": "SHORT"
      },
      {
        "livestream_start_time": "1790268132000",
        "livestream_duration": 12027,
        "revenue": "50930.0",
        "livestream_title": "",
        "creator_id": "7042472144287466543",
        "livestream_id": "7689142531280046879",
        "creator_handle": "djounefelix5",
        "unit_price": "339.53",
        "livestream_end_time": "1790280159000",
        "views": 51296,
        "record_type": "SHORT"
      },
      {
        "livestream_start_time": "1790035193000",
        "livestream_duration": 2237,
        "revenue": "48597.51",
        "livestream_title": "Ripping The Hottest Sports Cards",
        "creator_id": "6688398622600692742",
        "livestream_id": "7688142341407853343",
        "creator_handle": "burtonbreaks",
        "unit_price": "109.95",
        "livestream_end_time": "1790037430000",
        "views": 5878,
        "record_type": "SHORT"
      }
    ]
  }
}

API relacionadas