https://api.nexscope.ai/et/listVideoRankEjecutar 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/et/listVideoRank |
| Autenticación | Bearer API key |
| Content-Type | application/json |
Parámetros de la solicitud
| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
date | string | obligatorio | Listar la fecha de consulta, formato `YYYY-MM-DD` |
rankType | integer | obligatorio | Tipo de lista: `1` = lista diaria, `2` = lista semanal, `3` = lista mensual |
region | string | obligatorio | Código de zona. Valores opcionales: Estados Unidos (Estados Unidos), ID (Indonesia), TH (Tailandia), PH (Filipinas), MY (Malasia), VN (Vietnam), GB (UK), MX (México), SG (Singapur), SA (Arabia Saudita), BR (Brasil), ES (España), JP (Japón), DE (Alemania), IT (Italia), FR (Francia) |
videoRankField | integer | obligatorio | métricas de clasificación de vídeo: `1` = Clasificación por puntos de vista, `2` = Clasificación por ventas de vídeo |
productCategoryId | string | opcional | Producto de primera categoría ID, utilizado para filtrar categorías de productos en la lista de videos del producto |
createdByAi | string | opcional | Si el vídeo de AI, cadena opcional `true` / `false` |
pageNum | integer | opcional | Número de página de la paginación, a partir de 1 Ejemplo: 1 |
pageSize | integer | opcional | Número de artículos por página. Debe ser un múltiplo de 10, con un máximo de 100; el límite superior de una sola página en la interfaz oficial es 10, y internamente es 10 después de múltiples tirones por página y luego se fusionan Ejemplo: 50 |
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 (31 campos)
| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
errcode | integer | opcional | Código de estado de negocio, 200 indica éxito (ver código de error para más detalles) |
errmsg | string | opcional | Descripción del estado de las actividades |
total | integer | opcional | Número de registros |
data | array | opcional | Lista de vídeos, ordenados por `videoRankField` (Para más información, véase el campo de vídeo más adelante) |
columns | array | opcional | Columnas renderizadas (metadatos de renderización de primera línea, la longitud puede ser mayor que `data`, por favor consulte `data` para la recuperación de datos) |
type | string | opcional | Estilo de representación |
costToken | integer | opcional | Consumir token |
videoId | string | opcional | ID de vídeo |
officialUrl | string | opcional | Dirección oficial de vídeo TikTok |
userId | string | opcional | ID experto |
uniqueId | string | opcional | ID de cuenta TikTok |
nickName | string | opcional | Expert nickname |
avatar | string | opcional | Maestro avatar |
category | string | opcional | Clasificación de expertos |
videoDesc | string | opcional | Descripción del vídeo |
createDate | string | opcional | Fecha de lanzamiento del vídeo |
coverUrl | string | opcional | Cubierta de vídeo URL |
region | string | opcional | código de área |
duration | integer | opcional | Duración del vídeo (segundos) |
createdByAiText | string | opcional | Vídeo de IA o no (sí/no) |
salesFlagText | string | opcional | Si se debe llevar un vídeo de las mercancías (sí/no) |
productCategoryList | string | opcional | Clasificación del producto de carga |
videoProducts | string | opcional | Productos de vídeo |
totalCommentsCnt | integer | opcional | Número de comentarios por ciclo |
totalDiggCnt | integer | opcional | Número de me gusta por ciclo |
totalFavoritesCnt | integer | opcional | Número de colecciones de ciclo |
totalSharesCnt | integer | opcional | Número de ciclos compartidos |
totalViewsCnt | integer | opcional | Volumen de reproducción del ciclo |
totalVideoSaleCnt | integer | opcional | Ventas periódicas de vídeo (estimadas) |
totalVideoSaleGmvAmt | number | opcional | Ventas de vídeo en ciclo GMV (estimación) |
sourceType | string | opcional | Fuente del producto |
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.