POST
https://api.nexscope.ai/et/listProductVideoEjecutar 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/listProductVideo |
| Autenticación | Bearer API key |
| Content-Type | application/json |
Parámetros de la solicitud
| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
productId | string | obligatorio | ID del producto. Longitud máxima 1000 |
userId | string | opcional | Identificador del creador que se usa para filtrar los vídeos de distribución de creadores específicos. Longitud máxima de 1000 caracteres. |
productVideoSortField | integer | opcional | Campos de clasificación: 1=volumen de reproducción, 2=me gusta, 3=comparticiones, 4=ventas de vídeo, 5=ventas de vídeo GMV, 6=tiempo de lanzamiento. `1` Ejemplo: 1 |
sortType | integer | opcional | Método de clasificación: 0=orden ascendente, 1=orden descendente. Predeterminado `1` Ejemplo: 1 |
minCreateTime | integer | opcional | Intervalo de tiempo de lanzamiento de vídeo - inicio (marca de tiempo del segundo nivel) |
maxCreateTime | integer | opcional | Fin del intervalo de tiempo de publicación de vídeo (marca de tiempo del segundo nivel) |
pageNum | integer | opcional | Número de página de la paginación. `1` Ejemplo: 1 |
pageSize | integer | opcional | El número de entradas de paginación (debe ser un múltiplo de 10, máximo 100; el límite superior de una sola página en la interfaz oficial es 10, presiona internamente 10 para tirar varias veces por página y luego fusionarse). `50` 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 (18 campos)
| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
total | integer | opcional | Número de registros |
data | array | opcional | Lista de vídeos (ver objeto 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 |
productId | string | opcional | ID del producto |
userId | string | opcional | ID experto |
videoDesc | string | opcional | Descripción del vídeo |
officialUrl | string | opcional | Dirección oficial de vídeo TikTok |
covet | integer | opcional | Número de acciones |
totalFavoritesCnt | integer | opcional | Número de colecciones |
totalVideoSaleCnt | integer | opcional | Ventas de vídeo (estimadas) |
totalVideoSaleGmvAmt | integer | opcional | Ventas de vídeo GMV (estimación) |
hashTag | string | opcional | Hashtag |
createDate | string (date) | opcional | Fecha de lanzamiento del 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.