Inteligencia de TikTok KD
API de análisis de creadores de TikTok MCP
Compare TikTok creadores por seguidores, ingresos de ventas y región. Llama a la TikTok Creator Analytics API mediante REST o MCP con tu clave de API de Nexscope.
Prompts y casos de uso de API de análisis de creadores 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. Compare TikTok creadores por seguidores, ingresos de ventas, y región
Prompt: Compare TikTok creadores por seguidores, ingresos de ventas, y región para [creator ID] dentro [target marketplace]. Mostrar los resultados disponibles e identificar claramente la información que falta.
2. Investigación en un idioma seleccionado
Prompt: Compare TikTok creadores por seguidores, ingresos de ventas, y región para [creator 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: Compare TikTok creadores por seguidores, ingresos de ventas, y región para [creator 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: Compare TikTok creadores por seguidores, ingresos de ventas, y región para [creator 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.
5. Continuar los resultados dentro de un límite de página
Prompt: Compare TikTok creadores por seguidores, ingresos de ventas, y región para [creator ID] dentro [target marketplace]. Inicio [my selected page] y retorno [my requested page size] dentro de los límites documentados. Pregunte antes de solicitar otra página y no describa una página como conjunto de datos completo.
6. Priorizar los resultados para la revisión
Prompt: Compare TikTok creadores por seguidores, ingresos de ventas, y región para [creator ID] dentro [target marketplace]. Prioridad [my chosen ranking metric] dentro [my chosen order]. Mantenga la clasificación limitada a los filtros seleccionados y el período de presentación de informes.
7. Encontrar coincidencias por ingresos / GMV
Prompt: Compare TikTok creadores por seguidores, ingresos de ventas, y región para [creator ID] dentro [target marketplace]. Limitación de los resultados [my chosen revenue / gmv range]. Mantener los límites inferiores y superiores consistentes y mostrar sólo los registros coincidentes.
8. Encontrar coincidencias por seguidor
Prompt: Compare TikTok creadores por seguidores, ingresos de ventas, y región para [creator ID] dentro [target marketplace]. Limitación de los resultados [my chosen follower range]. Mantener los límites inferiores y superiores consistentes y mostrar sólo los registros coincidentes.
9. Resultados estrechos por categoría ID Lista
Prompt: Compare TikTok creadores por seguidores, ingresos de ventas, y región para [creator ID] dentro [target marketplace]. Uso [my selected category id list] para reducir los resultados. Informe sólo lo que los registros seleccionados soportan.
10. Resultados estrechos por tienda ID
Prompt: Compare TikTok creadores por seguidores, ingresos de ventas, y región para [creator ID] dentro [target marketplace]. Uso [my selected shop id] para reducir los resultados. Informe sólo lo que los registros seleccionados soportan.
11. Resultados estrechos por tipo creador
Prompt: Compare TikTok creadores por seguidores, ingresos de ventas, y región para [creator ID] dentro [target marketplace]. Uso [my selected creator type] para reducir los resultados. Informe sólo lo que los registros seleccionados soportan.
12. Resultados estrechos por participación
Prompt: Compare TikTok creadores por seguidores, ingresos de ventas, y región para [creator ID] dentro [target marketplace]. Uso [my selected engagement-rate] para reducir los resultados. Informe sólo lo que los registros seleccionados soportan.
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_tiktok_creator_analyticshttps://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": "tiktok-creator-analytics-1",
"method": "tools/call",
"params": {
"name": "nexscope_tiktok_creator_analytics",
"arguments": {
"creatorId": "68616495085350913",
"dateRange": "last30Day",
"pageNumber": 1,
"pageSize": 10,
"region": "US",
"sortField": {}
}
}
}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, e.g., US Ejemplo: US |
dateRange | string | opcional | Rango de tiempo, e.g. , Last7Day, last30Day Ejemplo: last30Day |
pageNumber | integer | opcional | Solicitudes de Rank solamente: página número 1-5; las solicitudes de detalle no se afectan. Las cuerdas numéricas finitas y nulo opcional siguen siendo aceptadas para la compatibilidad. Ejemplo: 1 |
pageSize | integer | opcional | Solicitudes aleatorias solamente: artículos por página 5-100; solicitudes de detalle no se afectan. Las cuerdas numéricas finitas y nulo opcional siguen siendo aceptadas para la compatibilidad. Ejemplo: 10 |
language | string | opcional | Lenguaje de retorno, e.g. zh-CN, en-US |
currency | string | opcional | Unidad de moneda e.g., USD |
sortField | object | opcional | Clasificar criterios; pasar un objeto vacío {} para el orden de rango predeterminado cuando no ordenar Ejemplo: {} |
category_ids | array | opcional | Categoría ID lista filtro Ejemplo: [] |
shop_id | string | opcional | Tienda ID filtro |
revenue_range | string | opcional | Ingresos / GMV filtro |
creator_type | string | opcional | Tipo de filtro |
followers_range | string | opcional | Filtro del rango de seguimiento |
engagement_rate | string | opcional | Filtro de tasa de compromiso |
creatorId | string | opcional | Creador único ID, e.g., 7153432386608251946, creator_id en la respuesta de rango creador Ejemplo: 68616495085350913 |
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 los expertos, generalmente un array de 1 elemento cuando es exitoso |
costToken | integer | opcional | El token de deducción para esta llamada es generalmente `14000` |
errmsg | string | opcional | Mensaje de estado, `ok` sobre el éxito |
creator_id | string | opcional | El maestro es único ID |
creator_nickname | string | opcional | Nombre de experto |
creator_handle | string | opcional | Expert handle |
creator_region | string | opcional | Área de expertos |
creator_status | string | opcional | Categoría principal |
creator_bio | string | opcional | Perfil del experto |
creator_belonged_shop_id | string | opcional | Store ID |
creator_followers | string | opcional | Número total de fans, devueltos como cadena |
new_followers | integer | opcional | Añadir nuevos fans en `dateRange` ventana |
revenue | number | opcional | Total Sales/GMV |
video_revenue | number | opcional | ventas de vídeo |
live_revenue | number | opcional | Ventas en vivo |
sales_volumn | integer | opcional | Volumen de ventas, campo deletreado `volumn` |
unit_price | number | opcional | precio unitario |
video_number | integer | opcional | Número de vídeos en la ventana |
video_views | integer | opcional | Total de vídeos |
video_gpm | number | opcional | Video GPM |
live_number | integer | opcional | Número de transmisiones en vivo dentro de la ventana |
live_views | integer | opcional | Total de vistas en directo |
live_gpm | number | opcional | Vivir GPM |
product_number | integer | opcional | Número de productos relacionados |
shop_number | integer | opcional | Número de tiendas asociadas |
creator_contact_email | string | opcional | Correo electrónico de contacto |
creator_contact_ins | string | opcional | Instagram Contacto |
creator_contact_whatsapp | string | opcional | WhatsApp Contacto |
creator_contact_facebook | string | opcional | Facebook Contacto |
creator_contact_tiktok | string | opcional | TikTok Información de contacto |
creator_contact_zalo | string | opcional | Contáctenos |
creator_contact_line | string | opcional | Información de contacto de línea |
Preguntas y respuestas de ejemplo
Se basa en una muestra de la documentación publicada, no en una llamada en vivo a la herramienta.
Tu pregunta
Compare TikTok creadores por seguidores, ingresos de ventas y región. Centrarse en el US.
Respuesta de ejemplo
En la muestra publicada, sus ingresos reportados son 604814. El valor indicado de el volumen de ventas es 21290. Su tasa de crecimiento de los ingresos notificada es 7.44. Estas observaciones se aplican únicamente al ámbito de registro y presentación de informes mostrados.
Sobre esta muestra: Extracto de la documentación publicada, no de una consulta en vivo. Las listas muestran como máximo dos registros y algunos textos largos pueden estar abreviados. Si faltan unidades, fechas o datos sobre la cobertura, el extracto no permite determinarlos ni representa el conjunto de datos completo.
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"
}Respuesta
{
"code": 0,
"msg": null,
"data": {
"data": [
{
"revenue_growth_rate": 7.44,
"revenue": 604814,
"video_revenue": 116862,
"sales_volumn": 21290,
"content_views": "63012951",
"creator_followers": "4400000",
"creator_id": "7153432386608251946",
"creator_handle": "@based",
"creator_nickname": "BASED",
"live_revenue": 487952
},
{
"revenue_growth_rate": -49.68,
"revenue": 366565.95,
"video_revenue": 364347.95,
"sales_volumn": 3343,
"content_views": "13488958",
"creator_followers": "234500",
"creator_id": "7147457260049777706",
"creator_handle": "@trending_ttok",
"creator_nickname": "Trending TT",
"live_revenue": 0
},
{
"revenue_growth_rate": -5.28,
"revenue": 343100.92,
"video_revenue": 339466.92,
"sales_volumn": 7084,
"content_views": "21422089",
"creator_followers": "332000",
"creator_id": "6857245188058776581",
"creator_handle": "@myfamilypov",
"creator_nickname": "Josh Morris",
"live_revenue": 0
},
{
"revenue_growth_rate": -35.16,
"revenue": 334938.02,
"video_revenue": 38,
"sales_volumn": 13241,
"content_views": "2577338",
"creator_followers": "872400",
"creator_id": "6800598044448457733",
"creator_handle": "@.brendaayala1",
"creator_nickname": "Brenda Ayala",
"live_revenue": 330199.01
},
{
"revenue_growth_rate": -9.36,
"revenue": 322449.82,
"video_revenue": 46680.16,
"sales_volumn": 1984,
"content_views": "1940096",
"creator_followers": "218400",
"creator_id": "7495995566804714538",
"creator_handle": "@airgeeksrc",
"creator_nickname": "AirGeeksRc",
"live_revenue": 272671.67
},
{
"revenue_growth_rate": -71.31,
"revenue": 248703,
"video_revenue": 99126,
"sales_volumn": 2704,
"content_views": "3530138",
"creator_followers": "521900",
"creator_id": "7179385436960310318",
"creator_handle": "@alondrixsexycurves",
"creator_nickname": "Alondrix sexy curves",
"live_revenue": 146809
},
{
"revenue_growth_rate": -66.54,
"revenue": 223023.9,
"video_revenue": 222115.9,
"sales_volumn": 1608,
"content_views": "6006518",
"creator_followers": "159800",
"creator_id": "7275090345011414059",
"creator_handle": "@dealswithty",
"creator_nickname": "Ty",
"live_revenue": 0
},
{
"revenue_growth_rate": -78.39,
"revenue": 217726.61,
"video_revenue": 126643.43,
"sales_volumn": 2676,
"content_views": "4138969",
"creator_followers": "198200",
"creator_id": "6801519791112897542",
"creator_handle": "@noelyfajas",
"creator_nickname": "Noely Fajas",
"live_revenue": 73958.43
},
{
"revenue_growth_rate": 22.05,
"revenue": 213379.62,
"video_revenue": 209679.58,
"sales_volumn": 8296,
"content_views": "6935085",
"creator_followers": "90500",
"creator_id": "7397634882631861290",
"creator_handle": "@tiktok_shop_christie",
"creator_nickname": "Tiktok Christie",
"live_revenue": 0
},
{
"revenue_growth_rate": -8.67,
"revenue": 213317.76,
"video_revenue": 0,
"sales_volumn": 6908,
"content_views": "1951957",
"creator_followers": "1200000",
"creator_id": "6639149111151607814",
"creator_handle": "@therealmustbecindy",
"creator_nickname": "Mustbecindy",
"live_revenue": 211956.76
},
{
"revenue_growth_rate": -7.99,
"revenue": 202658.1,
"video_revenue": 200681.1,
"sales_volumn": 8426,
"content_views": "20821599",
"creator_followers": "35000",
"creator_id": "7315783616931841066",
"creator_handle": "@honeyquiche",
"creator_nickname": "honeyquiche",
"live_revenue": 0
},
{
"revenue_growth_rate": -40.17,
"revenue": 201463,
"video_revenue": 200595,
"sales_volumn": 6625,
"content_views": "10574268",
"creator_followers": "14300",
"creator_id": "7476529109741536298",
"creator_handle": "@shoppingwithameliarose",
"creator_nickname": "Amelia Rose 🥀",
"live_revenue": 0
},
{
"revenue_growth_rate": -73.27,
"revenue": 200056.83,
"video_revenue": 0,
"sales_volumn": 9087,
"content_views": "1073122",
"creator_followers": "282200",
"creator_id": "7291543591306347562",
"creator_handle": "@highland.fashion7",
"creator_nickname": "Highland Fashion",
"live_revenue": 188813.89
},
{
"revenue_growth_rate": -27.97,
"revenue": 197016.27,
"video_revenue": 194522.32,
"sales_volumn": 8308,
"content_views": "17406928",
"creator_followers": "110600",
"creator_id": "25340095",
"creator_handle": "@lilyy_turcotte",
"creator_nickname": "lily",
"live_revenue": 0
},
{
"revenue_growth_rate": -25.56,
"revenue": 193928.99,
"video_revenue": 192608.99,
"sales_volumn": 3055,
"content_views": "5021978",
"creator_followers": "35200",
"creator_id": "7520310673173316621",
"creator_handle": "@sophmademebuyit",
"creator_nickname": "Soph🦋",
"live_revenue": 0
},
{
"revenue_growth_rate": -38.49,
"revenue": 193793.69,
"video_revenue": 193638.69,
"sales_volumn": 5082,
"content_views": "9060083",
"creator_followers": "46900",
"creator_id": "7509687704070964254",
"creator_handle": "@molly.on.the.mic",
"creator_nickname": "Molly On The Mic",
"live_revenue": 0
},
{
"revenue_growth_rate": -75.34,
"revenue": 185654.98,
"video_revenue": 0,
"sales_volumn": 1565,
"content_views": "825793",
"creator_followers": "470000",
"creator_id": "6906678272890848261",
"creator_handle": "@allpoketcg",
"creator_nickname": "AllPokeTCG",
"live_revenue": 170761.9
},
{
"revenue_growth_rate": -1.53,
"revenue": 183765,
"video_revenue": 183460,
"sales_volumn": 8010,
"content_views": "9392415",
"creator_followers": "50100",
"creator_id": "6900091235630564358",
"creator_handle": "@morganliving",
"creator_nickname": "morganliving",
"live_revenue": 0
},
{
"revenue_growth_rate": -47.96,
"revenue": 179639.07,
"video_revenue": 168896.91,
"sales_volumn": 3721,
"content_views": "9438342",
"creator_followers": "426500",
"creator_id": "6731158605980271622",
"creator_handle": "@luiseltigree",
"creator_nickname": "luiseltigree",
"live_revenue": 0
},
{
"revenue_growth_rate": -80.33,
"revenue": 179238.59,
"video_revenue": 42133.72,
"sales_volumn": 9159,
"content_views": "5632884",
"creator_followers": "8300000",
"creator_id": "6787875411281134598",
"creator_handle": "@jeffreestar",
"creator_nickname": "Jeffree Star",
"live_revenue": 134808.87
}
]
}
}Ver el formato de solicitud y respuesta MCP
Ejemplos
Se basa en una muestra de la documentación publicada, no en 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": "tiktok-creator-analytics-example",
"method": "tools/call",
"params": {
"name": "nexscope_tiktok_creator_analytics",
"arguments": {
"region": "US"
}
}
}Formato de respuesta MCP
{
"jsonrpc": "2.0",
"id": "tiktok-creator-analytics-example",
"result": {
"content": [
{
"type": "text",
"text": "{\"code\":0,\"msg\":null,\"data\":{\"data\":[{\"revenue\":604814,\"sales_volumn\":21290,\"revenue_growth_rate\":7.44,\"video_revenue\":116862,\"content_views\":\"63012951\",\"creator_followers\":\"4400000\",\"creator_id\":\"7153432386608251946\",\"creator_handle\":\"@based\",\"creator_nickname\":\"BASED\",\"live_revenue\":487952},{\"revenue\":366565.95,\"sales_volumn\":3343,\"revenue_growth_rate\":-49.68,\"video_revenue\":364347.95,\"content_views\":\"13488958\",\"creator_followers\":\"234500\",\"creator_id\":\"7147457260049777706\",\"creator_handle\":\"@trending_ttok\",\"creator_nickname\":\"Trending TT\",\"live_revenue\":0}]}}"
}
],
"structuredContent": {
"code": 0,
"msg": null,
"data": {
"data": [
{
"revenue": 604814,
"sales_volumn": 21290,
"revenue_growth_rate": 7.44,
"video_revenue": 116862,
"content_views": "63012951",
"creator_followers": "4400000",
"creator_id": "7153432386608251946",
"creator_handle": "@based",
"creator_nickname": "BASED",
"live_revenue": 487952
},
{
"revenue": 366565.95,
"sales_volumn": 3343,
"revenue_growth_rate": -49.68,
"video_revenue": 364347.95,
"content_views": "13488958",
"creator_followers": "234500",
"creator_id": "7147457260049777706",
"creator_handle": "@trending_ttok",
"creator_nickname": "Trending TT",
"live_revenue": 0
}
]
}
},
"isError": false
}
}