https://api.nexscope.ai/kd/creator/detailEjecutar esta API
Envía una solicitud JSON para ejecutar esta API y recibir los datos de respuesta documentados.
Endpoint
| Método | POST |
| Ruta | https://api.nexscope.ai/kd/creator/detail |
| Autenticación | Bearer API key |
| Content-Type | application/json |
Parámetros de la solicitud
| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
creatorId | string | obligatorio | ID único experto, como `7153432386608251946`, normalmente `creator_id` de la lista |
shop_id | string | opcional | Filtro de ID de almacenamiento |
category_ids | integer[] | opcional | Filtro de lista de identificación de categoría |
region | string | opcional | Código de región/mercado, como `US` |
dateRange | string | opcional | Plazos, como `last7Day`, `last30Day` |
language | string | opcional | Devolver el idioma, por ejemplo `zh-CN`, `en-US` |
currency | string | opcional | Unidad monetaria, como `USD` |
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 (33 campos)
| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
errcode | integer | opcional | Código de la situación empresarial, `200` indica éxito |
data | array | opcional | Datos de detalles de expertos, generalmente un array de 1 elemento cuando tiene éxito |
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 | Identificación única del maestro |
creator_nickname | string | opcional | Expert nickname |
creator_handle | string | opcional | nombre de usuario experto |
creator_region | string | opcional | Ámbito de competencia |
creator_status | string | opcional | Estado maestro |
creator_bio | string | opcional | Perfil del experto |
creator_belonged_shop_id | string | opcional | ID de almacenamiento |
creator_followers | string | opcional | Número total de fans, devueltos como una cuerda |
new_followers | integer | opcional | Añadir nuevos fans en `dateRange` ventana |
revenue | number | opcional | Total de ventas/VMG |
video_revenue | number | opcional | ventas de vídeo |
live_revenue | number | opcional | Ventas en vivo |
sales_volumn | integer | opcional | Volumen de ventas, campo escrito `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 vistas de vídeo |
video_gpm | number | opcional | Video GPM |
live_number | integer | opcional | Número de transmisiones en directo dentro de la ventana |
live_views | integer | opcional | Total de vistas en vivo |
live_gpm | number | opcional | GPM en vivo |
product_number | integer | opcional | Número de productos relacionados |
shop_number | integer | opcional | Número de almacenes asociados |
creator_contact_email | string | opcional | Correo electrónico de contacto |
creator_contact_ins | string | opcional | Contacto con Instagram |
creator_contact_whatsapp | string | opcional | Contacto WhatsApp |
creator_contact_facebook | string | opcional | Contacto en Facebook |
creator_contact_tiktok | string | opcional | Información de contacto de TikTok |
creator_contact_zalo | string | opcional | Contáctenos |
creator_contact_line | string | opcional | Información de contacto en línea |
Respuestas
| Código | Descripción |
|---|---|
| 200 | Respuesta 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. |
| 429 | Límite de admisión de ejecuciones; respeta Retry-After cuando esté presente. |
| 503 | La admisión de ejecuciones no está disponible temporalmente; respeta Retry-After cuando esté presente. |
| Opcional | X-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.