https://api.nexscope.ai/rg/textTrademarkDetectionEjecutar 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/rg/textTrademarkDetection |
| Autenticación | Bearer API key |
| Content-Type | application/json |
Parámetros de la solicitud
| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
productTitle | string | obligatorio | Título del producto, utilizado para la detección de marcas, máximo 1000 caracteres |
regions | string | opcional | Códigos de país/región, múltiplos separados con comas. `US`, `EM`, `GB`, `DE`, `FR`, `IT`, `ES`, `AU`, `CA`, `MX`, `JP`, `CN`, `WO`, `TR`, `BX` Ejemplo: US |
limit | integer | obligatorio | Límite del número de resultados retornados, máximo 500 Ejemplo: 100 |
productText | string | opcional | Otras informaciones de texto sobre el producto, como descripción de cinco puntos o descripción del producto, máximo 1000 caracteres |
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 (28 campos)
| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
total | integer | opcional | Número de registros de marcas coincidentes |
data | array | opcional | Lista de marcas (aplanada), cada elemento contiene los campos siguientes |
detectId | string | opcional | ID de llamada de interfaz |
columns | array | opcional | Definiciones de columna renderizadas |
blacklistTrademarks | array | opcional | Marcas registradas en la lista negra detectadas en el texto |
whitelistTrademarks | array | opcional | Marcas comerciales (seguras) de la lista blanca detectadas en el texto |
textTrademarkRadar | string | opcional | Nivel de riesgo del producto: `0` es de bajo riesgo, `1` está pendiente de verificación manual, y `2` es alto riesgo |
costToken | integer | opcional | Consumir token |
type | string | opcional | Estilo de representación |
trademarkName | string | opcional | Marcas |
region | string | opcional | Código del país |
score | integer | opcional | puntuación de riesgo |
highestModeScore | integer | opcional | Máxima puntuación de riesgo, rango 0-5 |
trademarksStatus | string | opcional | Marca de mayor puntuación de la palabra estado |
regionStatus | string | opcional | Situación de las marcas en las regiones correspondientes |
holder | string | opcional | titular de los derechos |
applicationNumber | string | opcional | Número de la solicitud |
registrationNumber | string | opcional | Número de registro |
isFamous | boolean | opcional | ¿Es una marca famosa? |
isAmazonBrand | boolean | opcional | ¿Es una marca de búsqueda amazónica? |
isActiveHolder | boolean | opcional | ¿Eres un defensor activo de los derechos? |
isCompatibility | boolean | opcional | Compatibilidad |
isCommonSense | boolean | opcional | ¿Es una palabra común? |
niceClass | array | opcional | Clasificación de Niza |
originalTextMatches | array | opcional | La palabra original que desencadenó la coincidencia |
trademark | string | opcional | Denominación comercial |
region | string | opcional | Código del país |
note | string | opcional | Comentarios |
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.