APIs › Kurdish, Arabic & Text Utilities › Lexicon Sentiment

Lexicon Sentiment

Lexicon-based sentiment scoring with negation and intensifier handling, returning the matched terms so the score is auditable. No model inference involved.

POST /v1/text/lexicon-sentiment $0.01 per call

Specification

Endpoint

POST /v1/text/lexicon-sentiment

Price

$0.01 per call · tier standard_data

Payment

x402 on X Layer (chain 196) · settled in USDG or USDT0 · scheme exact

Data source

Deterministic local computation on caller-supplied text

Timeout

15 seconds

Max request

1 MB

Version

1.0.0

Calling it

The first call returns a 402 with the payment challenge. Retry with a signed authorisation in the X-PAYMENT header — see the payment guide for the exact shape.

curl -i -X POST "https://api.dana-edu.pp.ua/v1/text/lexicon-sentiment" \
  -H "content-type: application/json" \
  -d '{ ... }'

Response

Real output, captured by running this endpoint at build time — not written by hand. Volatile fields such as timestamps are elided. Captured 2026-07-30.

{
  "polarity": "positive",
  "score": 0.25,
  "raw_score": 1.5,
  "matched_term_count": 2,
  "matched_terms": [
    {
      "term": "fast",
      "weight": 1.5,
      "adjusted": 2.25,
      "intensifier": "very",
      "negated": false,
      "position": 4
    },
    {
      "term": "clear",
      "weight": 1,
      "adjusted": -0.75,
      "intensifier": null,
      "negated": true,
      "position": 10
    }
  ],
  "method": "lexicon with negation and intensifier handling; no model inference. Every matched term is returned so the score can be audited."
}

Every response is wrapped in the same envelope: data plus warnings, sources, confidence, informational_only and a measured processing_ms. See the envelope reference.

Related endpoints