Nexscope

API de evaluación de JEV

Evalúa texto según criterios predefinidos o tus propias preguntas. Invoca la API mediante REST o MCP desde 10 créditos por llamada.

Coste10 créditos / llamada
Probar en línea
POST · https://api.nexscope.ai/jev/evaluateMCP · nexscope_jev_evaluate

Qué hace esta API

Evalúe el texto en función de criterios predefinidos o de sus propias preguntas.

Casos de uso de API de evaluación de JEV

Compruebe un texto contra un preset de evaluación

Para comprobar un texto contra un preset de evaluación, un analista del mercado presenta useCase Las comprobaciones, decisiones y modelos devueltos ayudan a inspeccionar la evaluación preestablecida seleccionada para el texto suministrado.

Revisar las pruebas que sustentan una reclamación

Un analista de mercado utiliza JEV Content Evaluation con useCase Las comprobaciones, decisiones y modelos devueltos ayudan a comparar la reclamación declarada con las pruebas aportadas.

Registrar los resultados de la evaluación estructurada

Para este flujo de trabajo, un analista de mercado llama a JEV Content Evaluation con useCase El resultado ayuda a registrar las respuestas de la evaluación para una revisión humana.

Preguntas frecuentes sobre API de evaluación de JEV

¿Qué hace la evaluación del contenido del JEV? API ¿Volver?

Evalúe el texto en función de criterios predefinidos o de sus propias preguntas. `checks`, `decision`, `model`, `policyVersion`, `reasonCodes`, `answers`, `rows.confidence`, `rows.evidenceRefs`. Corresponde a los parámetros proporcionados `useCase`, `input`, `state`, `questions`, `input.content`. Los campos opcionales pueden estar ausentes; un valor que falta no debe interpretarse como un cero medido. Los valores de ejemplo ilustran la forma de respuesta, en lugar de los resultados reales de la cuenta.

¿Cuántos créditos tiene la evaluación de contenido JEV? API ¿costo?

El coste documentado actualmente es 10 créditos / llamada. Es el mismo que figura en la parte superior de esta página. Si se muestra un intervalo o una estimación, el cargo final depende de la solicitud. Antes de llamar a la API, revisa los créditos disponibles y la página de precios. Consulta el registro de uso de la API para comprobar el cargo aplicado.

¿Cómo llamo a la evaluación de contenido JEV? API desde mi aplicación o un MCP ¿Cliente?

Enviar a POST solicitud a /jev/evaluate con tu API como un símbolo de portador y la JSON datos de entrada API En una MCP cliente como Claude o Cursor, conectar Nexscope y llamar nexscope_jev_evaluate. Utilice el MCP argumentos mostrados en el MCP guía, o cambiar la prueba en línea a MCP para revisar su solicitud antes de añadirla a tu aplicación.

Ver planes y créditosConecta esta API con MCP

Prueba esta API
Endpoint
https://api.nexscope.ai/jev/evaluate
Método MCP
nexscope_jev_evaluate

Paso 1 de 3 · Autenticarse

Autenticación

Todos los endpoints de ejecución requieren una clave de API de usuario. Envíala como token bearer en la cabecera Authorization .

Authorization: Bearer nk-xxxxxxxxxxxxxxxxx
Las claves de API ausentes o no válidas devuelven un error de autenticación. Gestiona las claves desde .

Paso 2 de 3 · Enviar una solicitud

POSThttps://api.nexscope.ai/jev/evaluate

Ejecutar una API

Elija exactamente un modo de petición: useCase + entrada, o estado + preguntas. Petición máxima seriada: 16,000 bytes UTF-8. Modelo, aguas arriba URL, los umbrales de identidad y ejecución son de propiedad del servidor y no pueden suministrarse. Todo el texto debe ser no en blanco.

Solicitud de ejemplo

Sustituye YOUR_API_KEY y ejecuta este comando en tu terminal.

curl -X POST 'https://api.nexscope.ai/jev/evaluate' \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "input": {
    "content": "Never share passwords. Contact customer support through the official website."
  },
  "useCase": "response_guardrails"
}'

Ejemplo de código

{
  "input": {
    "content": "Never share passwords. Contact customer support through the official website."
  },
  "useCase": "response_guardrails"
}

Paso 3 de 3 · Inspeccionar el resultado

Comprueba la respuesta

Consulta code para ver el estado de la solicitud y data para ver el resultado. Abre la referencia de parámetros y respuestas para consultar las definiciones completas de los campos.

Códigos de estado HTTP

CódigoDescripción
200Respuesta 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.
429Límite de admisión de ejecuciones; respeta Retry-After cuando esté presente.
503La admisión de ejecuciones no está disponible temporalmente; respeta Retry-After cuando esté presente.
OpcionalX-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 una clave API ausente o no válida (code 11209, incluida una copia incompleta o dañada) o una sesión web caducada (code 12001), 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.
POSThttps://api.nexscope.ai/jev/evaluate

Ejecutar esta API

Envía una solicitud JSON para ejecutar esta API y recibir los datos de respuesta documentados.

Endpoint

MétodoPOST
Rutahttps://api.nexscope.ai/jev/evaluate
AutenticaciónBearer API key
Content-Typeapplication/json

Modos de evaluación y ejemplos

Usa el mismo endpoint y la clave de API Bearer para ambos modos. Envía useCase + input o state + questions. No los mezcles ni envíes model. La herramienta MCP nexscope_jev_evaluate acepta el mismo cuerpo.

El modo personalizado acepta texto no vacío, un objeto o un array como estado y entre 1 y 32 preguntas. Las instrucciones son cadenas obligatorias de hasta 4 000 caracteres. Choice acepta entre 2 y 255 opciones; Score acepta entre 2 y 32 niveles de texto ordenados. Las descripciones de criterios admiten hasta 2 000 caracteres. Los ID de preguntas y opciones usan entre 1 y 64 letras, dígitos, guiones bajos o guiones. Los ID de palabras clave, evidencias, hechos y candidatos usan el mismo formato y deben ser únicos dentro de sus respectivos arrays.

La solicitud serializada completa debe ocupar como máximo 16 000 bytes UTF-8, aunque cada campo cumpla sus límites. Cada llamada cuenta como una solicitud, incluso si incluye un lote de palabras clave. No se obtienen datos automáticamente. Envía solo contexto que tengas autorización para compartir con TypeSafe.

Preguntas personalizadas

Evalúa los tres tipos de preguntas juntos. Cada pregunta lee el mismo estado de forma independiente. Las preguntas no pueden depender de otra respuesta de la misma solicitud.

{
  "state": {
    "product": "750ml insulated steel water bottle",
    "keyword": "hiking water bottle"
  },
  "questions": {
    "relevant": {
      "type": "noul",
      "instructions": "Is the keyword relevant to this product?"
    },
    "intent": {
      "type": "choice",
      "instructions": "Classify the search intent.",
      "criteria": {
        "purchase": "Looking for a product to buy",
        "research": "Looking for information",
        "other": "Neither"
      }
    },
    "fit": {
      "type": "score",
      "instructions": "Rate keyword fit using only the product description.",
      "criteria": [
        "Unrelated",
        "Weak fit",
        "Good fit",
        "Direct fit"
      ]
    }
  }
}

Protecciones de respuesta

Comprueba los riesgos y la gravedad de la respuesta. Devuelve pass, review o block.

{
  "useCase": "response_guardrails",
  "input": {
    "content": "Never share your password with anyone."
  }
}

Evaluación inicial de riesgos de propiedad intelectual

Señala posibles problemas de propiedad intelectual. Siempre devuelve review; no constituye una autorización legal.

{
  "useCase": "ip_risk_triage",
  "input": {
    "text": "A product description using a third-party brand name."
  }
}

Relevancia SEO

Proporciona query y al menos uno de title, metaDescription o contentExcerpt. Puntúa la relevancia, no las posiciones ni el volumen de búsqueda.

{
  "useCase": "seo_relevance",
  "input": {
    "query": "insulated hiking bottle",
    "title": "Insulated steel water bottle for hiking"
  }
}

Comprobación de evidencias

Evalúa únicamente sourceText. Una cita opcional debe aparecer tras normalizar los espacios; de lo contrario, se devuelve quote_not_found sin llamar al modelo.

{
  "useCase": "evidence_check",
  "input": {
    "claim": "The bottle holds 750ml.",
    "sourceText": "Capacity: 750ml. Material: steel.",
    "quote": "Capacity: 750ml."
  }
}

Relevancia de palabras clave para el negocio

Entre 1 y 10 palabras clave por llamada. exclusions es obligatorio y puede estar vacío. serpEvidence opcional contiene hasta 30 extractos proporcionados; keywordId debe hacer referencia a una palabra clave de esta solicitud. Etiquetas: relevant, irrelevant, uncertain.

{
  "useCase": "keyword_business_relevance",
  "input": {
    "businessDescription": "We sell reusable hiking bottles.",
    "exclusions": [
      "Disposable bottles"
    ],
    "keywords": [
      {
        "id": "k1",
        "keyword": "steel hiking bottle"
      }
    ],
    "serpEvidence": [
      {
        "id": "e1",
        "keywordId": "k1",
        "source": "Supplied search result excerpt",
        "text": "Reusable steel bottles for outdoor use."
      }
    ]
  }
}

Afinidad con un grupo de palabras clave

Compara entre 1 y 10 palabras clave con entre 1 y 5 representantes candidatos. Evalúa la afinidad temática y de página; no crea un flujo completo de agrupación. Etiquetas: same_page, separate_page, uncertain. candidateId puede ser null. El ID de candidato no_candidate está reservado.

{
  "useCase": "keyword_cluster_fit",
  "input": {
    "keywords": [
      {
        "id": "k1",
        "keyword": "insulated hiking bottle"
      }
    ],
    "candidates": [
      {
        "id": "c1",
        "keyword": "hiking water bottles"
      }
    ]
  }
}

Afinidad entre palabras clave y productos de Amazon

Evalúa entre 1 y 10 palabras clave usando entre 1 y 30 hechos de producto proporcionados. Fuentes de hechos: title, bullet, attribute, description. Etiquetas: match, partial, conflict, unknown. Mercados admitidos: US, UK, DE, FR, JP, CA, IT, ES, MX, IN.

{
  "useCase": "amazon_keyword_product_fit",
  "input": {
    "marketplace": "US",
    "productFacts": [
      {
        "id": "f1",
        "source": "title",
        "value": "750ml insulated steel water bottle"
      }
    ],
    "keywords": [
      {
        "id": "k1",
        "keyword": "steel water bottle"
      }
    ]
  }
}

Leer una respuesta personalizada

El sobre de Nexscope sigue siendo code / msg / data. El modo personalizado devuelve data.useCase = custom, policyVersion = jev-custom-v1, decision = evaluated, reasonCodes y checks vacíos y las respuestas en data.result.answers. Evaluated confirma que hay respuestas disponibles; no aprueba ninguna acción. Usa tus propios umbrales de decisión. No se expone el uso de tokens.

{
  "code": 0,
  "msg": "success",
  "data": {
    "useCase": "custom",
    "policyVersion": "jev-custom-v1",
    "model": "<resolved model>",
    "decision": "evaluated",
    "reasonCodes": [],
    "checks": {},
    "result": {
      "answers": {
        "relevant": {
          "type": "noul",
          "noul": 0.92
        },
        "intent": {
          "type": "choice",
          "choice": "purchase",
          "confidence": 0.9,
          "probabilities": {
            "purchase": 0.9,
            "research": 0.08,
            "other": 0.02
          }
        },
        "fit": {
          "type": "score",
          "score": 2.8,
          "confidence": 0.9,
          "probabilities": {
            "0": 0,
            "1": 0,
            "2": 0.2,
            "3": 0.8
          },
          "legend": {
            "0": "Unrelated",
            "1": "Weak fit",
            "2": "Good fit",
            "3": "Direct fit"
          }
        }
      }
    }
  }
}

Los valores anteriores son ilustrativos. Noul es la probabilidad de sí, no un booleano. Score es el promedio de niveles con índice inicial cero ponderado por probabilidades y puede ser fraccionario. Los ajustes predefinidos de palabras clave devuelven filas en data.result.rows, identificadas por el ID de entrada, con etiquetas, confianza y reasonCodes; evidenceRefs identifica el contexto proporcionado, no fuentes verificadas de forma independiente. La versión de la política de palabras clave es jev-keyword-tools-v1; los ajustes predefinidos originales conservan jev-evaluation-v1.

Errores y límites

Comprueba el código de respuesta antes de leer los datos. 99001: parámetros no válidos; corrige la solicitud. 99009: cuota compartida superada; espera antes de volver a intentarlo. 13007: evaluación no disponible, tiempo de espera agotado o respuesta ascendente no válida; no se devuelve ninguna decisión utilizable. Se requiere una suscripción activa. Cada evaluación tiene un límite de espera ascendente de 10 segundos y no se reintenta automáticamente.

Este es el contrato de API de Nexscope. Usa TypeSafe internamente y aplica de forma intencionada los límites anteriores; no es un acceso sin restricciones a la TypeSafe API.

Parámetros de la solicitud

NombreTipoObligatorioDescripción
inputobjectopcional
Los campos dependen del preset seleccionado; ver los esquemas de modo a continuación.
questionsobjectopcional
Requerido en modo personalizado. 1–32 preguntas independientes, con clave de identificación definida por el llamante.
statestring | object | arrayopcional
Requerido en modo personalizado. Contexto no vacío compartido por cada pregunta; los datos suministrados se envían a TypeSafe.
Longitud mínima: 1
Cantidad mínima de elementos: 1
useCasestringopcional
Requerido con entrada en modo preestablecido. Uno de siete preestablecidos de propiedad del servidor.
Permitidos: response_guardrails, ip_risk_triage, seo_relevance, evidence_check, keyword_business_relevance, keyword_cluster_fit, amazon_keyword_product_fit

Preset mode

response_guardrails

NombreTipoObligatorioDescripción
inputobjectopcional
Checks credential_exposure, harmful_instruction, deceptive_claim, instruction_override, and severity. The fixed server policy maps the checks to pass, review, or block.
input.contentstringobligatorio
Authorized response or draft content.
Longitud mínima: 1
Longitud máxima: 6000
useCasestringopcional
Requerido con entrada en modo preestablecido. Uno de siete preestablecidos de propiedad del servidor.
Constante: response_guardrails

ip_risk_triage

NombreTipoObligatorioDescripción
inputobjectopcional
Checks trademark, copyright, patent, other IP, and insufficient-context signals plus risk type and severity. The result always requires human review and is not legal clearance.
input.textstringobligatorio
Authorized product or description text for advisory IP-risk triage.
Longitud mínima: 1
Longitud máxima: 4000
useCasestringopcional
Requerido con entrada en modo preestablecido. Uno de siete preestablecidos de propiedad del servidor.
Constante: ip_risk_triage

seo_relevance

NombreTipoObligatorioDescripción
inputobjectopcional
Requires query and at least one supplied title, metaDescription, or contentExcerpt. Scores relevance only; it does not predict rankings, traffic, search volume, or intent data.
input.contentExcerptstringopcional
Valor de Content excerpt usado por esta operación de API.
Longitud mínima: 1
Longitud máxima: 4000
input.metaDescriptionstringopcional
Valor de Meta description usado por esta operación de API.
Longitud mínima: 1
Longitud máxima: 1000
input.querystringobligatorio
Valor de Query usado por esta operación de API.
Longitud mínima: 1
Longitud máxima: 500
input.titlestringopcional
Valor de Title usado por esta operación de API.
Longitud mínima: 1
Longitud máxima: 300
useCasestringopcional
Requerido con entrada en modo preestablecido. Uno de siete preestablecidos de propiedad del servidor.
Constante: seo_relevance

Opción 1 de cualquier alternativa — requiere title

NombreTipoObligatorioDescripción
inputanyopcional
Requerido con useCase en modo preestablecido. Entrada específica estricta preestablecida. Presets de palabras clave aceptan sólo palabras clave delimitadas, candidato, pruebas SERP y campos de productos y hechos.

Opción 2 de cualquier alternativa — requiere metaDescription

NombreTipoObligatorioDescripción
inputanyopcional
Requerido con useCase en modo preestablecido. Entrada específica estricta preestablecida. Presets de palabras clave aceptan sólo palabras clave delimitadas, candidato, pruebas SERP y campos de productos y hechos.

Opción 3 de cualquier alternativa — requiere contentExcerpt

NombreTipoObligatorioDescripción
inputanyopcional
Requerido con useCase en modo preestablecido. Entrada específica estricta preestablecida. Presets de palabras clave aceptan sólo palabras clave delimitadas, candidato, pruebas SERP y campos de productos y hechos.

evidence_check

NombreTipoObligatorioDescripción
inputobjectopcional
Assesses the claim only against sourceText. If supplied quote is absent after whitespace normalization, the server returns deterministic quote_not_found without a model call.
input.claimstringobligatorio
Valor de Claim usado por esta operación de API.
Longitud mínima: 1
Longitud máxima: 1000
input.quotestringopcional
Optional quote that must occur in sourceText after whitespace normalization.
Longitud mínima: 1
Longitud máxima: 1000
input.sourceTextstringobligatorio
Valor de Source text usado por esta operación de API.
Longitud mínima: 1
Longitud máxima: 6000
useCasestringopcional
Requerido con entrada en modo preestablecido. Uno de siete preestablecidos de propiedad del servidor.
Constante: evidence_check

keyword_business_relevance

NombreTipoObligatorioDescripción
inputobjectopcional
Requerido con useCase en modo preestablecido. Entrada específica estricta preestablecida. Presets de palabras clave aceptan sólo palabras clave delimitadas, candidato, pruebas SERP y campos de productos y hechos.
input.businessDescriptionstringobligatorio
Valor de Business description usado por esta operación de API.
Longitud mínima: 1
Longitud máxima: 4000
input.exclusionsarrayobligatorio
Valor de Exclusions usado por esta operación de API.
Cantidad máxima de elementos: 50
input.exclusions[]stringobligatorio
Elemento de input exclusions.
Longitud mínima: 1
Longitud máxima: 200
input.keywordsarrayobligatorio
Valor de Keywords usado por esta operación de API.
Cantidad mínima de elementos: 1
Cantidad máxima de elementos: 10
input.keywords[]objectobligatorio
Elemento de input keywords.
input.keywords[].idstringobligatorio
Valor de Id usado por esta operación de API.
Patrón: ^[A-Za-z0-9_-]{1,64}$
input.keywords[].keywordstringobligatorio
Valor de Keyword usado por esta operación de API.
Longitud mínima: 1
Longitud máxima: 500
input.serpEvidencearrayopcional
Valor de Serp evidence usado por esta operación de API.
Cantidad máxima de elementos: 30
input.serpEvidence[]objectobligatorio
Elemento de input serpEvidence.
input.serpEvidence[].idstringobligatorio
Valor de Id usado por esta operación de API.
Patrón: ^[A-Za-z0-9_-]{1,64}$
input.serpEvidence[].keywordIdstringobligatorio
Valor de Keyword id usado por esta operación de API.
Patrón: ^[A-Za-z0-9_-]{1,64}$
input.serpEvidence[].sourcestringobligatorio
Valor de Source usado por esta operación de API.
Longitud mínima: 1
Longitud máxima: 200
input.serpEvidence[].textstringobligatorio
Valor de Text usado por esta operación de API.
Longitud mínima: 1
Longitud máxima: 2000
useCasestringopcional
Requerido con entrada en modo preestablecido. Uno de siete preestablecidos de propiedad del servidor.
Constante: keyword_business_relevance

keyword_cluster_fit

NombreTipoObligatorioDescripción
inputobjectopcional
Requerido con useCase en modo preestablecido. Entrada específica estricta preestablecida. Presets de palabras clave aceptan sólo palabras clave delimitadas, candidato, pruebas SERP y campos de productos y hechos.
input.candidatesarrayobligatorio
Valor de Candidates usado por esta operación de API.
Cantidad mínima de elementos: 1
Cantidad máxima de elementos: 5
input.candidates[]objectobligatorio
Elemento de input candidates.
input.candidates[].idstringobligatorio
Valor de Id usado por esta operación de API.
Patrón: ^[A-Za-z0-9_-]{1,64}$
input.candidates[].keywordstringobligatorio
Valor de Keyword usado por esta operación de API.
Longitud mínima: 1
Longitud máxima: 500
input.keywordsarrayobligatorio
Valor de Keywords usado por esta operación de API.
Cantidad mínima de elementos: 1
Cantidad máxima de elementos: 10
input.keywords[]objectobligatorio
Elemento de input keywords.
input.keywords[].idstringobligatorio
Valor de Id usado por esta operación de API.
Patrón: ^[A-Za-z0-9_-]{1,64}$
input.keywords[].keywordstringobligatorio
Valor de Keyword usado por esta operación de API.
Longitud mínima: 1
Longitud máxima: 500
useCasestringopcional
Requerido con entrada en modo preestablecido. Uno de siete preestablecidos de propiedad del servidor.
Constante: keyword_cluster_fit

amazon_keyword_product_fit

NombreTipoObligatorioDescripción
inputobjectopcional
Requerido con useCase en modo preestablecido. Entrada específica estricta preestablecida. Presets de palabras clave aceptan sólo palabras clave delimitadas, candidato, pruebas SERP y campos de productos y hechos.
input.keywordsarrayobligatorio
Valor de Keywords usado por esta operación de API.
Cantidad mínima de elementos: 1
Cantidad máxima de elementos: 10
input.keywords[]objectobligatorio
Elemento de input keywords.
input.keywords[].idstringobligatorio
Valor de Id usado por esta operación de API.
Patrón: ^[A-Za-z0-9_-]{1,64}$
input.keywords[].keywordstringobligatorio
Valor de Keyword usado por esta operación de API.
Longitud mínima: 1
Longitud máxima: 500
input.marketplacestringobligatorio
Valor de Marketplace usado por esta operación de API.
Permitidos: US, UK, DE, FR, JP, CA, IT, ES, MX, IN
input.productFactsarrayobligatorio
Valor de Product facts usado por esta operación de API.
Cantidad mínima de elementos: 1
Cantidad máxima de elementos: 30
input.productFacts[]objectobligatorio
Elemento de input productFacts.
input.productFacts[].idstringobligatorio
Valor de Id usado por esta operación de API.
Patrón: ^[A-Za-z0-9_-]{1,64}$
input.productFacts[].sourcestringobligatorio
Valor de Source usado por esta operación de API.
Permitidos: title, bullet, attribute, description
input.productFacts[].valuestringobligatorio
Valor de Value usado por esta operación de API.
Longitud mínima: 1
Longitud máxima: 2000
useCasestringopcional
Requerido con entrada en modo preestablecido. Uno de siete preestablecidos de propiedad del servidor.
Constante: amazon_keyword_product_fit

Custom mode

Respuesta de ejemplo

Estructura de respuesta de la plataforma. code 0 indica éxito o aceptación; data contiene el resultado de negocio.

{
  "code": 0,
  "data": {
    "checks": {},
    "decision": "pass",
    "model": "<resolved model>",
    "policyVersion": "jev-evaluation-v1",
    "reasonCodes": [
      "no_rule_triggered"
    ],
    "result": {},
    "useCase": "response_guardrails"
  },
  "msg": "success"
}

Campos de respuesta

Nexscope la respuesta del sobre para la evaluación preestablecida o personalizada. API o acción editorial.

NombreTipoObligatorioDescripción
codeintegerobligatorio
Zero on success; non-zero for validation, access, quota, or availability errors.
dataobjectobligatorio
Fixed server policies cover response safety, IP triage, SEO relevance, evidence checks, business-keyword relevance, keyword same-page clustering, and Amazon product-keyword fit. Keyword presets return bounded rows keyed only by caller-supplied IDs.
data.checksobjectobligatorio
Empty in custom mode; answers are in result.answers. Fixed Noul, Score, or Choice checks for the preset: response risks and severity; IP signals, risk_type, severity, and insufficient_context; supplied SEO dimensions; or evidence verdict. Deterministic quote_not_found returns an empty object.
data.decisionstringobligatorio
Presets return pass/review/block. Custom mode returns evaluated, which means answers are available, not that an action is approved.
Permitidos: pass, review, block, evaluated
data.modelstring | nullobligatorio
Resolved model version, or null for deterministic quote_not_found.
data.policyVersionstringobligatorio
jev-evaluation-v1 for original presets; jev-keyword-tools-v1 for keyword presets; jev-custom-v1 for custom questions.
data.reasonCodesarrayobligatorio
Fixed reason codes without submitted text.
data.reasonCodes[]stringobligatorio
Elemento de data reasonCodes.
data.resultobjectobligatorio
Preset-specific bounded result. Keyword presets return result.rows with caller-supplied IDs, fixed labels, confidence, and fixed reason or evidence references.
data.result.answersobjectopcional
Custom mode only. Answers keyed by question ID: noul returns {type, noul}; choice returns {type, choice, confidence, probabilities}; score returns {type, score, confidence, probabilities, legend}. No automatic policy or token usage is returned.
data.result.rowsarrayopcional
Valor de Rows usado por esta operación de API.
Cantidad máxima de elementos: 10
data.result.rows[]anyobligatorio
Elemento de data result rows.
data.useCasestringobligatorio
Valor de Use case usado por esta operación de API.
Permitidos: response_guardrails, ip_risk_triage, seo_relevance, evidence_check, keyword_business_relevance, keyword_cluster_fit, amazon_keyword_product_fit, custom
msgstringobligatorio
Response message.

Business relevance row

NombreTipoObligatorioDescripción
data.result.rows[]objectobligatorio
Elemento de data result rows.
data.result.rows[].confidencenumberobligatorio
Valor de Confidence usado por esta operación de API.
Mínimo: 0
Máximo: 1
data.result.rows[].evidenceRefsarrayobligatorio
Valor de Evidence refs usado por esta operación de API.
data.result.rows[].evidenceRefs[]stringobligatorio
Elemento de data result rows[] evidenceRefs.
data.result.rows[].idstringobligatorio
Valor de Id usado por esta operación de API.
Patrón: ^[A-Za-z0-9_-]{1,64}$
data.result.rows[].labelstringobligatorio
Valor de Label usado por esta operación de API.
Permitidos: relevant, irrelevant, uncertain
data.result.rows[].reasonCodesarrayobligatorio
Valor de Reason codes usado por esta operación de API.
data.result.rows[].reasonCodes[]stringobligatorio
Elemento de data result rows[] reasonCodes.

Keyword cluster fit row

NombreTipoObligatorioDescripción
data.result.rows[]objectobligatorio
Elemento de data result rows.
data.result.rows[].candidateIdstring | nullobligatorio
Valor de Candidate id usado por esta operación de API.
data.result.rows[].confidencenumberobligatorio
Valor de Confidence usado por esta operación de API.
Mínimo: 0
Máximo: 1
data.result.rows[].idstringobligatorio
Valor de Id usado por esta operación de API.
Patrón: ^[A-Za-z0-9_-]{1,64}$
data.result.rows[].labelstringobligatorio
Valor de Label usado por esta operación de API.
Permitidos: same_page, separate_page, uncertain
data.result.rows[].reasonCodesarrayobligatorio
Valor de Reason codes usado por esta operación de API.
data.result.rows[].reasonCodes[]stringobligatorio
Elemento de data result rows[] reasonCodes.
data.result.rows[].samePagebooleanobligatorio
Valor de Same page usado por esta operación de API.
data.result.rows[].sameTopicbooleanobligatorio
Valor de Same topic usado por esta operación de API.

Amazon keyword product fit row

NombreTipoObligatorioDescripción
data.result.rows[]objectobligatorio
Elemento de data result rows.
data.result.rows[].confidencenumberobligatorio
Valor de Confidence usado por esta operación de API.
Mínimo: 0
Máximo: 1
data.result.rows[].evidenceRefsarrayobligatorio
Valor de Evidence refs usado por esta operación de API.
data.result.rows[].evidenceRefs[]stringobligatorio
Elemento de data result rows[] evidenceRefs.
data.result.rows[].idstringobligatorio
Valor de Id usado por esta operación de API.
Patrón: ^[A-Za-z0-9_-]{1,64}$
data.result.rows[].labelstringobligatorio
Valor de Label usado por esta operación de API.
Permitidos: match, partial, conflict, unknown
data.result.rows[].reasonCodesarrayobligatorio
Valor de Reason codes usado por esta operación de API.
data.result.rows[].reasonCodes[]stringobligatorio
Elemento de data result rows[] reasonCodes.

Respuestas

CódigoDescripción
200Respuesta 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.
429Límite de admisión de ejecuciones; respeta Retry-After cuando esté presente.
503La admisión de ejecuciones no está disponible temporalmente; respeta Retry-After cuando esté presente.
OpcionalX-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 una clave API ausente o no válida (code 11209, incluida una copia incompleta o dañada) o una sesión web caducada (code 12001), 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.

Paso 1 de 2 · Conectar tu cliente MCP

MCP

Conecta agentes remotos a través del endpoint HTTP Streamable estándar MCP 2025-11-25. Usa el código de autorización OAuth 2.1 con PKCE, o una clave de API por compatibilidad.

POST https://api.nexscope.ai/mcp
MCP-Protocol-Version: 2025-11-25
Content-Type: application/json
Autenticación

Los clientes OAuth solicitan el ámbito mcp:tools. La respuesta 401 del endpoint anuncia metadatos de recurso protegido para descubrir la autorización.

Paso 2 de 2 · Llamar a la herramienta

Llamar a una herramienta

{
  "jsonrpc": "2.0",
  "id": "tool-call-1",
  "method": "tools/call",
  "params": {
    "name": "nexscope_jev_evaluate",
    "arguments": {
      "input": {
        "content": "Never share passwords. Contact customer support through the official website."
      },
      "useCase": "response_guardrails"
    }
  }
}

¿Qué puedes hacer con esta API?

Datos explicados y casos de uso prácticos

AI Guide

Question

What can JEV Content Evaluation tell me about my text, and when would I use it?

AI answer

JEV evaluates submitted text using a selected preset or your own questions. Presets can flag response risks, assess IP signals, check relevance, or evaluate evidence. The result depends on the selected useCase.

Data categoryDocumented fieldsWhat the values mean
Overall evaluationdata.decision, data.reasonCodesPresets return pass, review, or block with fixed reason codes. In custom mode, evaluated means answers are available; it is not an approval.
Preset checksdata.checksStructured checks for the chosen preset, such as risk severity, IP signals, SEO dimensions, or an evidence verdict. This is empty in custom mode.
Custom answersdata.result.answersAnswers keyed by your question IDs. Depending on question type, they can contain a boolean-like noul, a choice, or a score, with documented confidence or probability values where applicable.
Keyword evaluationsdata.result.rowsUp to 10 bounded rows for keyword presets, keyed by caller-supplied IDs and containing labels, confidence, and reason or evidence references.
  • Screen a proposed response for safety risks and decide which items need human review.
    • Prompt example: “I am researching products for an online store. Could you screen a proposed response for safety risks and decide which items need human review? Show the relevant returned evidence and tell me what input you need from me.”
  • Triage possible IP signals in submitted content while accounting for an insufficient_context finding.
    • Prompt example: “I am researching products for an online store. Could you triage possible IP signals in submitted content while accounting for an insufficient_context finding? Show the relevant returned evidence and tell me what input you need from me.”
  • Check whether supplied text is relevant to specified SEO dimensions or business keywords.
    • Prompt example: “I am researching products for an online store. Could you check whether supplied text is relevant to specified SEO dimensions or business keywords? Show the relevant returned evidence and tell me what input you need from me.”
  • Ask custom, ID-keyed questions and use the returned choices or scores in an editorial review workflow.
    • Prompt example: “I am researching products for an online store. Could you ask custom, ID-keyed questions and use the returned choices or scores in an editorial review workflow? Show the relevant returned evidence and tell me what input you need from me.”
  • Check an evidence claim; a deterministic quote_not_found result has an empty data.checks object.
    • Prompt example: “I am researching products for an online store. Could you check an evidence claim; a deterministic quote_not_found result has an empty data.checks object? Show the relevant returned evidence and tell me what input you need from me.”

API relacionadas