https://api.nexscope.ai/et/listVideoEjecutar 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/listVideo |
| Autenticación | Bearer API key |
| Content-Type | application/json |
Parámetros de la solicitud
| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
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) |
userId | string | opcional | Filtrado de ID experto. Longitud máxima 1000 |
productId | string | opcional | ID del producto asociado al vídeo. Longitud máxima 1000 |
productCategoryId | string | opcional | Categoría de producto asociada ID. Longitud máxima 1000 |
minTotalViewsCnt | integer | opcional | Filtro de reproducción de vídeo (valor mínimo) |
maxTotalViewsCnt | integer | opcional | Filtro de reproducción de vídeo (valor máximo) |
minDuration | integer | opcional | Filtrado de rango de duración del vídeo (segundos) - valor mínimo |
maxDuration | integer | opcional | Filtrado de rango de duración de vídeo (segundos) - valor máximo |
minCreateTime | integer | opcional | Valor mínimo del filtro del intervalo de tiempo de liberación (marca de tiempo del segundo nivel) |
maxCreateTime | integer | opcional | Filtrado del intervalo de tiempo de liberación (marca de tiempo del segundo nivel) - valor máximo |
salesFlag | integer | opcional | Si se debe llevar una mercancía de vídeo: 0 = no hay mercancías que lleven vídeo, 1 = mercancías que lleven vídeo |
isAd | integer | opcional | Si se debe transmitir vídeo: 0 = no hay streaming de vídeo, 1 = transmisión de vídeo |
createdByAi | string | opcional | Si el vídeo de AI, sólo acepta la cadena `"true"` (vídeo AI) o `"false"` (vídeo no de AI), no booleano |
videoSortField | integer | opcional | Campos de clasificación: 1=total_digg_cnt (número de me gusta), 2=create_time (tiempo de liberación), 3=total_views_cnt (número de dictámenes) Ejemplo: 3 |
sortType | integer | opcional | Método de clasificación: 0=orden ascendente (asc), 1=orden descendente (desc) Ejemplo: 1 |
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, el máximo es 100**; el límite superior para una sola página de la interfaz de terceros es 10, presiona internamente 10 para cada página que se extraiga varias veces y luego se fusione 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 (40 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 (para más detalles, véase el campo de vídeo más abajo) |
columns | array | opcional | Columnas renderizadas |
type | string | opcional | Estilo de representación |
costToken | integer | opcional | Consumir token |
videoId | string | opcional | ID de vídeo |
videoDesc | string | opcional | Descripción del vídeo |
officialUrl | string | opcional | Dirección oficial de vídeo TikTok |
coverUrl | string | opcional | Cubierta de vídeo URL |
duration | integer | opcional | Duración del vídeo (segundos) |
width | string | opcional | ancho de vídeo |
height | string | opcional | altura del vídeo |
ratio | string | opcional | Claridad de vídeo (resolución, como 540p/720p) |
dataSize | string | opcional | Tamaño del archivo de vídeo |
createDate | string | opcional | Fecha de lanzamiento del vídeo |
userId | string | opcional | ID experto |
uniqueId | string | opcional | ID de cuenta TikTok (unique_id) |
avatar | string | opcional | Maestro avatar |
totalViewsCnt | integer | opcional | Total de opiniones |
totalViews1dCnt | integer | opcional | Juega volumen en el pasado día |
totalViews7dCnt | integer | opcional | Juega volumen en los últimos 7 días |
totalViews30dCnt | integer | opcional | Volumen de reproducción en los últimos 30 días |
totalDiggCnt | integer | opcional | Total me gusta |
totalDigg1dCnt | integer | opcional | Número de likes en el pasado día |
totalDigg7dCnt | integer | opcional | Número de me gusta en los últimos 7 días |
totalDigg30dCnt | integer | opcional | Número de me gusta en los últimos 30 días |
totalCommentsCnt | integer | opcional | Total de observaciones |
totalSharesCnt | integer | opcional | Total de acciones |
totalFavoritesCnt | integer | opcional | Total de colecciones |
totalVideoSaleCnt | integer | opcional | Ventas de vídeo (número de piezas) |
totalVideoSaleGmvAmt | integer | opcional | Ventas de vídeo GMV (importe) |
salesFlagText | string | opcional | Si llevar productos de vídeo |
isAdText | string | opcional | Si se debe transmitir vídeo |
createdByAiText | string | opcional | Si el vídeo de AI (sí)/no/unknown) |
productCategoryList | string | opcional | Clasificación de productos |
videoProducts | string | opcional | Productos relacionados con el vídeo |
region | string | opcional | código de área |
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.