---
title: "Run focused sentiment analysis for one text"
method: POST
path: "/api/v1/analyze/sentiment"
---

# Run focused sentiment analysis for one text

`POST /api/v1/analyze/sentiment`

## Request

- Base URL: `https://intencheck.com` (the document declares no server; this is the origin it was published from)
- URL: `https://intencheck.com/api/v1/analyze/sentiment`
- Auth: OAuth 2 (password, token URL `/api/v1/auth/login`)

Return a compact sentiment result with label, score, and explanation. Use this MCP tool when a client only needs the overall emotional polarity of the text instead of the full psychological profile. Requires an IntenCheck API key and consumes a smaller word-balance charge than full analysis.

## Headers

- `x-api-key` string, nullable

## Cookies

- `access_token` string, nullable

## Request body

- AnalyzeRequest
  - `text` string, required: Text to analyze. Use natural-language user text, review text, messages, email copy, support conversations, or other customer-facing copy. The request is billed by word count.
  - `features` string[], nullable: Optional feature families to include. Supported values: metaprograms, emotions, moods, communication_styles, tone_and_posture. Omit this field to run the full analysis.
  - `output_lang` string, nullable: ISO 639-1 language code for labels and explanations in the response, for example 'en', 'lt', 'fr', or 'de'. Defaults to Lithuanian ('lt').

## Response `200`

Successful Response

- AnalyzeSentimentResponse
  - `analysis` SentimentResult, required
    - `sentiment` string, required: Overall sentiment (Positive, Negative, Neutral)
    - `score` integer, required: Score from 1 (very negative) to 10 (very positive)
    - `explanation` string, required: Brief explanation of the sentiment

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/intencheck/apis/intencheck-api.md) · [All operations](https://skmtc.dev/intencheck/apis/intencheck-api/llms.txt) · [OpenAPI document](https://skmtc.dev/intencheck/apis/intencheck-api/revisions/b3b93dff0a81?raw)