Nexscope

API de detalles de creadores de TikTok

Consulta el perfil de un creador de TikTok para posibles colaboraciones. Invoca la API mediante REST o MCP con tu clave de API de Nexscope.

Coste19 créditos / llamada
Probar en línea
POST · https://api.nexscope.ai/cj/creators/detailMCP · nexscope_chuhaijiang_tiktok_creator_detail

Qué hace esta API

Vea el perfil de un creador de TikTok para posibles asociaciones.

Casos de uso de API de detalles de creadores de TikTok

Socios de contenido de comercio de listas cortas

Para listar a los socios de contenido comercial, un analista del mercado envía el país y el ID a TikTok Creator Detail. request_id 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 Creator Detail con el país y la identificación para revisar el creador público o la evidencia en directo. request_id 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 Creator Detail con el país y la identificación para preparar un informe de investigación de campaña.

Preguntas frecuentes sobre API de detalles de creadores de TikTok

¿Qué hace el detalle del Creador TikTok API ¿Volver?

Vea el perfil de un creador de TikTok para posibles asociaciones. `errcode`, `errmsg`, `request_id`, `last_update_time`, `core_video_total_like_count_to_follower_count`, `tioktok_creator_detail_core_ec_video_count`, `tioktok_creator_detail_core_ecom_video_avg_play_count`, `tioktok_creator_detail_core_med_commission_rate`. Corresponde a los parámetros proporcionados `country`, `id`, `include`. 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 detalle del Creador TikTok API ¿costo?

El coste documentado actualmente es 19 créditos / llamada. 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 detalle del Creador TikTok API desde mi aplicación o un MCP ¿Cliente?

Enviar a POST solicitud a /cj/creators/detail 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_chuhaijiang_tiktok_creator_detail. 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 (en inglés)

Prueba esta API
Endpoint
https://api.nexscope.ai/cj/creators/detail
Método MCP
nexscope_chuhaijiang_tiktok_creator_detail

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/cj/creators/detail

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/cj/creators/detail' \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "country": "us",
  "id": "7302162228386776110",
  "include": "channel,core,portrait"
}'

Ejemplo de código

{
  "country": "us",
  "id": "7302162228386776110",
  "include": "channel,core,portrait"
}

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 la ausencia de una clave API (code 11209), 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 comercial de TikTok CJ
POSThttps://api.nexscope.ai/cj/creators/detail

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/cj/creators/detail
AutenticaciónBearer API key
Content-Typeapplication/json

Parámetros de la solicitud

NombreTipoObligatorioDescripción
countrystringobligatorio
Código del país de menor importancia
idstringobligatorio
ID experto
includestringopcional
`channel`, `core` o `portrait`; múltiples valores separados por comas

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

NombreTipoObligatorioDescripción
errcodeintegeropcional
200 means success
errmsgstringopcional
Typically `ok` on success
request_idstringopcional
Request tracking ID
dataobjectopcional
Basic and optional extended data
last_update_timeintegeropcional
Last updated timestamp
core_video_total_like_count_to_follower_countnumberopcional
Likes to fans ratio
tioktok_creator_detail_core_ec_video_countnumberopcional
Number of e-commerce videos; retain `tioktok` spelling by source field
tioktok_creator_detail_core_ecom_video_avg_play_countnumberopcional
Average views of e-commerce videos
tioktok_creator_detail_core_med_commission_ratenumberopcional
Median commission rate
channel_total_video_live_30d_gmvobject/numberopcional
The total GMV of video and live broadcast in the past 30 days
portrait_follower_countnumberopcional
Number of fans based on portraits

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 la ausencia de una clave API (code 11209), 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_chuhaijiang_tiktok_creator_detail",
    "arguments": {
      "country": "us",
      "id": "7302162228386776110",
      "include": "core,channel,portrait"
    }
  }
}

¿Qué puedes hacer con esta API?

Datos explicados y casos de uso prácticos

AI Guide

Question

What data can TikTok Creator Detail provide, and how might I use it?

AI answer

This API returns a creator profile for a specified TikTok market and creator ID. You can request core, channel, and portrait sections for additional performance and audience data.

Data categoryDocumented fieldsWhat the values mean
Creator identityid, ins_id, nicknameIdentifiers and display name in the profile item.
Audience sizecore_follower_count, portrait_follower_countFollower counts reported in the core and portrait sections.
Video engagementcore_author_avg_engagement_rate, core_video_total_like_count_to_follower_countAverage engagement and the ratio of video likes to followers.
E-commerce videostioktok_creator_detail_core_ec_video_count, tioktok_creator_detail_core_ecom_video_avg_play_count, channel_ec_video_30d_avg_play_countE-commerce video volume and reported average plays, including a 30-day channel measure.
Commerce performancechannel_total_video_live_30d_gmv, core_product_count, tioktok_creator_detail_core_med_commission_rateReported 30-day video-and-live GMV, product count, and median commission rate.
Audience portraitportrait_age_distributionReported age distribution of the creator's audience.
  • Compare potential partners by audience size and engagement, rather than follower count alone.
    • Prompt example: “I am researching TikTok marketplace data. Could you compare potential partners by audience size and engagement, rather than follower count alone? Show the returned values behind the comparison, and mark missing data.”
  • Check whether a creator regularly publishes e-commerce videos and how many plays those videos receive.
    • Prompt example: “I am researching TikTok marketplace data. Could you check whether a creator regularly publishes e-commerce videos and how many plays those videos receive? Show the relevant returned evidence and tell me what input you need from me.”
  • Assess the reported commerce activity and median commission rate before discussing a campaign.
    • Prompt example: “I am researching TikTok marketplace data. Could you assess the reported commerce activity and median commission rate before discussing a campaign? Show the relevant returned evidence and tell me what input you need from me.”
  • Use the age distribution to see whether a creator's audience resembles your intended customer group.
    • Prompt example: “I am researching TikTok marketplace data. Could you use the age distribution to see whether a creator's audience resembles your intended customer group? Show the relevant returned evidence and tell me what input you need from me.”

The example shows null values, and the extended sections depend on include; treat absent or null metrics as unavailable.

Prueba en línea

Ejecuta la API actual con tu clave de API y la carga JSON. Las pruebas en línea usan el entorno de API configurado de este sitio; el Endpoint y los ejemplos que puedes copiar usan la dirección de integración pública.

19 créditos / llamadaRegistros de uso de la API

Pruébalo

Envía una solicitud real con el mismo contrato que se muestra en la referencia.

Endpoint
/cj/creators/detail
Método de MCP
nexscope_chuhaijiang_tiktok_creator_detail
cURL
curl -X POST \
  https://api.nexscope.ai/cj/creators/detail \
  -H "Authorization: Bearer nk-..." \
  -H "Content-Type: application/json" \
  -d '{ "country": "us", "id": "7302162228386776110", "include": "channel,core,portrait" }'
Respuesta
Todavía no hay respuesta. Ejecuta la solicitud para ver la respuesta aquí.

API relacionadas