Inteligencia de TikTok KD
API de clasificaciones de creadores de TikTok MCP
Query TikTok creador clasificación por región y rango de fecha. Llama a la TikTok Rankings de Creadores API mediante REST o MCP con tu clave de API de Nexscope.
Prompts y casos de uso de API de clasificaciones 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. Query TikTok creador clasificación por región y rango de fecha
Prompt: Consulta la clasificación de creadores de TikTok por región y período en [target marketplace]. Mostrar los resultados disponibles e identificar claramente la información que falta.
2. Investigación en una moneda seleccionada
Prompt: Consulta la clasificación de creadores de TikTok por región y período en [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.
3. Investigación en un idioma seleccionado
Prompt: Consulta la clasificación de creadores de TikTok por región y período en [target marketplace]. Volver las descripciones disponibles en [my preferred supported language], manteniendo los identificadores sin cambios.
4. Revise un período específico de presentación de informes
Prompt: Consulta la clasificación de creadores de TikTok por región y período en [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: Consulta la clasificación de creadores de TikTok por región y período en [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: Consulta la clasificación de creadores de TikTok por región y período en [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.
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_searchhttps://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-search-1",
"method": "tools/call",
"params": {
"name": "nexscope_tiktok_creator_search",
"arguments": {
"dateRange": "last30Day",
"pageNumber": 1,
"pageSize": 10,
"region": "US"
}
}
}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 | Facultativo TikTok Región del mercado de tiendas. Ejemplo: US |
dateRange | string | opcional | Rango relativo de fecha. Ejemplo: last30Day |
pageNumber | integer | opcional | Número de página, 1-5. Las cuerdas numéricas finitas y nulo opcional siguen siendo aceptadas por el backend para la compatibilidad. Ejemplo: 1 |
pageSize | integer | opcional | Filas por página, 5-100. Las cuerdas numéricas finitas y nulo opcional siguen siendo aceptadas por el backend para la compatibilidad. Ejemplo: 10 |
currency | string | opcional | Código de moneda. Ejemplo: USD |
language | string | opcional | Lenguaje de respuesta. Ejemplo: en-US |
sortField | object | opcional | Objeto de proveedor opcional. Ejemplo: {} |
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; las respuestas reales no contienen `total` |
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_nickname | string | opcional | Nombre de experto |
creator_handle | string | opcional | TikTok nombre de página, como `@based` |
creator_id | string | opcional | Experto único ID, formato de cadena para evitar la pérdida de precisión para los enteros grandes |
creator_followers | string | opcional | Número de fans, devueltos como cadena |
content_views | string | opcional | El número total de opiniones del contenido, devuelto como cadena |
sales_volumn | integer | opcional | Volumen de ventas, campo deletreado `volumn` |
revenue | number | opcional | Total sales/GMV, devuelto por solicitud `currency` |
video_revenue | number | opcional | Ventas cortas de vídeo |
live_revenue | number | opcional | Ventas de streaming en vivo |
revenue_growth_rate | number | opcional | Tasa de crecimiento de las ventas (%), puede ser positiva o negativa |
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 |
Ilustración del formato
Ejemplo ilustrativo con datos ficticios, no una llamada en vivo a la herramienta.
Pregunta ilustrativa
Query TikTok creador clasificación por región y rango de fecha. Centrarse en el US.
Explicación ilustrativa de la respuesta
El resultado ilustrativo muestra ingresos: 19.99; volumn de ventas: 10. 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.
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": "VN",
"keyword": "tai nghe"
}Respuesta
{
"code": 0,
"msg": null,
"data": {
"data": [
{
"revenue_growth_rate": -16.21,
"revenue": 414508.08,
"video_revenue": 234.83,
"sales_volumn": 33181,
"content_views": "14386759",
"creator_followers": "4700000",
"creator_id": "6915637132371657729",
"creator_handle": "@quyenleo",
"creator_nickname": "Quyền Leo",
"live_revenue": 387398.84
},
{
"revenue_growth_rate": -17.98,
"revenue": 385569.34,
"video_revenue": 350.3,
"sales_volumn": 16958,
"content_views": "18730392",
"creator_followers": "2100000",
"creator_id": "7286334200113382408",
"creator_handle": "@ungthaimenuochoa",
"creator_nickname": "Ưng Thái",
"live_revenue": 384567.72
},
{
"revenue_growth_rate": 3.34,
"revenue": 352807.2,
"video_revenue": 109319.75,
"sales_volumn": 39490,
"content_views": "20941280",
"creator_followers": "740500",
"creator_id": "6978523869728965633",
"creator_handle": "@thanhdongian.dtt",
"creator_nickname": "Thành Đơn Giản",
"live_revenue": 241913.73
},
{
"revenue_growth_rate": -75.54,
"revenue": 326777.6,
"video_revenue": 164256.46,
"sales_volumn": 29982,
"content_views": "18249528",
"creator_followers": "2400000",
"creator_id": "6798739018520839169",
"creator_handle": "@chanhbeauty93",
"creator_nickname": "Nguyễn Thị Kim Xuyến's",
"live_revenue": 151371.99
},
{
"revenue_growth_rate": -40.09,
"revenue": 268523.01,
"video_revenue": 9719.18,
"sales_volumn": 24242,
"content_views": "4740083",
"creator_followers": "819800",
"creator_id": "154547111739473920",
"creator_handle": "@ngockhanhday",
"creator_nickname": "Ngọc Khánh đây",
"live_revenue": 251226.56
},
{
"revenue_growth_rate": -57.88,
"revenue": 268191.37,
"video_revenue": 1713.2,
"sales_volumn": 14841,
"content_views": "3022436",
"creator_followers": "466000",
"creator_id": "6882276426629252097",
"creator_handle": "@thegioimebimsua",
"creator_nickname": "Thế Giới Mẹ Bỉm Sữa",
"live_revenue": 261106.6
},
{
"revenue_growth_rate": 3.81,
"revenue": 262168.73,
"video_revenue": 447.24,
"sales_volumn": 9367,
"content_views": "4364385",
"creator_followers": "1700000",
"creator_id": "7047795841113015298",
"creator_handle": "@kimtronsalan1994",
"creator_nickname": "Kim Tròn Sà Lan",
"live_revenue": 256175.93
},
{
"revenue_growth_rate": -3.28,
"revenue": 258061.83,
"video_revenue": 104892.33,
"sales_volumn": 13215,
"content_views": "7753245",
"creator_followers": "1300000",
"creator_id": "7185560290230420482",
"creator_handle": "@realpewpew",
"creator_nickname": "Tạp Hóa PewPew",
"live_revenue": 146988.84
},
{
"revenue_growth_rate": -62.46,
"revenue": 244176.67,
"video_revenue": 17446.64,
"sales_volumn": 6765,
"content_views": "5183892",
"creator_followers": "2100000",
"creator_id": "7072683155098272773",
"creator_handle": "@hannaholala",
"creator_nickname": "HannahOlala",
"live_revenue": 185305.97
},
{
"revenue_growth_rate": 63.51,
"revenue": 232200.27,
"video_revenue": 122285.39,
"sales_volumn": 13948,
"content_views": "100976643",
"creator_followers": "522000",
"creator_id": "7132359344935715866",
"creator_handle": "@cerave.vietnam_official",
"creator_nickname": "CeraVe Việt Nam",
"live_revenue": 107976.67
},
{
"revenue_growth_rate": -15.71,
"revenue": 223957.62,
"video_revenue": 2711.05,
"sales_volumn": 55372,
"content_views": "14639568",
"creator_followers": "578200",
"creator_id": "7095071270736364546",
"creator_handle": "@hieubanhlamthuy",
"creator_nickname": "Tiệm Bánh Lâm Thủy Cổ Truyền",
"live_revenue": 221164.89
},
{
"revenue_growth_rate": -22.61,
"revenue": 223119.65,
"video_revenue": 0,
"sales_volumn": 14903,
"content_views": "549659",
"creator_followers": "208600",
"creator_id": "6705337685530117121",
"creator_handle": "@hinhy_review",
"creator_nickname": "Hiền Hinhy",
"live_revenue": 218528.18
},
{
"revenue_growth_rate": -28.62,
"revenue": 217684.72,
"video_revenue": 72.48,
"sales_volumn": 4513,
"content_views": "503950",
"creator_followers": "247300",
"creator_id": "7088240910156923905",
"creator_handle": "@phuongsena",
"creator_nickname": "Phương Sena",
"live_revenue": 212526.53
},
{
"revenue_growth_rate": -56.4,
"revenue": 212316.94,
"video_revenue": 1317.18,
"sales_volumn": 17086,
"content_views": "1324711",
"creator_followers": "253900",
"creator_id": "6628200945636753409",
"creator_handle": "@hungeverything",
"creator_nickname": "Hưng Everything ☻",
"live_revenue": 207628.75
},
{
"revenue_growth_rate": 6.51,
"revenue": 201761.75,
"video_revenue": 40154.35,
"sales_volumn": 15394,
"content_views": "5309890",
"creator_followers": "1600000",
"creator_id": "7092274959032992770",
"creator_handle": "@laquocquyen",
"creator_nickname": "Lã Quốc Quyền",
"live_revenue": 158247.25
},
{
"revenue_growth_rate": -15.94,
"revenue": 177135.27,
"video_revenue": 0,
"sales_volumn": 3636,
"content_views": "885495",
"creator_followers": "48100",
"creator_id": "7628809448744961040",
"creator_handle": "@trangsuckimbao999",
"creator_nickname": "Trang Sức Kim Bảo",
"live_revenue": 168171.01
},
{
"revenue_growth_rate": -26.6,
"revenue": 172962.58,
"video_revenue": 120366.37,
"sales_volumn": 29090,
"content_views": "13510150",
"creator_followers": "737500",
"creator_id": "6875773744855204865",
"creator_handle": "@totuyettram",
"creator_nickname": "Tô Tuyết Trâm",
"live_revenue": 51808.49
},
{
"revenue_growth_rate": -91.21,
"revenue": 164161.86,
"video_revenue": 0,
"sales_volumn": 3194,
"content_views": "392369",
"creator_followers": "5700",
"creator_id": "6749811226706838529",
"creator_handle": "@hunghanhtools",
"creator_nickname": "Hằng Review Đồ Nghề",
"live_revenue": 164161.86
},
{
"revenue_growth_rate": -10.55,
"revenue": 162454.54,
"video_revenue": 21451.29,
"sales_volumn": 10096,
"content_views": "899941",
"creator_followers": "99800",
"creator_id": "6905265191504954370",
"creator_handle": "@thegioibimsua0",
"creator_nickname": "Thế Giới Bỉm Sữa ✅",
"live_revenue": 139592.21
},
{
"revenue_growth_rate": -31.01,
"revenue": 161997,
"video_revenue": 25556.89,
"sales_volumn": 14896,
"content_views": "3279426",
"creator_followers": "742300",
"creator_id": "7068480615218070529",
"creator_handle": "@cocoon.vietnam",
"creator_nickname": "Cocoon Vietnam",
"live_revenue": 135071.68
}
]
}
}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": "tiktok-creator-search-example",
"method": "tools/call",
"params": {
"name": "nexscope_tiktok_creator_search",
"arguments": {
"dateRange": "last30Day",
"pageNumber": 1,
"pageSize": 10,
"region": "US"
}
}
}Formato de respuesta MCP
{
"jsonrpc": "2.0",
"id": "tiktok-creator-search-example",
"result": {
"content": [
{
"type": "text",
"text": "{\"code\":0,\"msg\":null,\"data\":{\"data\":[{\"revenue\":19.99,\"sales_volumn\":10}]}}"
}
],
"structuredContent": {
"code": 0,
"msg": null,
"data": {
"data": [
{
"revenue": 19.99,
"sales_volumn": 10
}
]
}
},
"isError": false
}
}