JEV Evaluate API

Evaluate all three question types together. Each question reads the same state independently. Questions cannot depend on another answer in the same request.

{
  "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"
      ]
    }
  }
}

Checks response risks and severity. Returns pass, review, or block.

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

Flags possible IP concerns. Always returns review; it is not legal clearance.

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

Supply query and at least one of title, metaDescription, or contentExcerpt. Scores relevance, not rankings or search volume.

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

Assesses only sourceText. An optional quote must occur after whitespace normalization; otherwise quote_not_found is returned without a model call.

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

1–10 keywords per call. exclusions is required and may be empty. Optional serpEvidence contains up to 30 supplied excerpts; keywordId must reference a keyword in this request. Labels: 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."
      }
    ]
  }
}

Compare 1–10 keywords with 1–5 candidate representatives. This evaluates topic/page fit; it does not build an entire clustering workflow. Labels: same_page, separate_page, uncertain. candidateId can be null. The candidate ID no_candidate is reserved.

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

Evaluate 1–10 keywords using 1–30 supplied product facts. Fact sources: title, bullet, attribute, description. Labels: match, partial, conflict, unknown. Supported marketplaces: 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"
      }
    ]
  }
}