Sentiment Analysis
Analyze the sentiment of any text and get back a positive, negative, or neutral classification with a confidence score and full breakdown.
Overview
Use Cases
- Monitoring customer feedback and support tickets
- Analyzing social media mentions and product reviews
- Preprocessing text for NLP and ML pipelines
- Real-time moderation of user-generated content
Features
Returns positive, negative, or neutral classification
Confidence score between 0.0 and 1.0
Full breakdown showing proportional scores for all three classes
Works on short phrases and long-form text
API Endpoints
Analyze Sentiment
Analyzes the sentiment of the provided text and returns a classification, confidence score, and a full breakdown across all three sentiment classes.
POST
https://requiems.xyz/v1/text/sentiment
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
| text | string |
Required | The text to analyze. |
Try it out
Live DemoRequest
The text to analyze.
Sending request...
Response Fields
| Field | Type | Description |
|---|---|---|
| sentiment | string |
The dominant sentiment class: positive, negative, or neutral |
| score | number |
Confidence score for the dominant sentiment, between 0.0 and 1.0 |
| breakdown.positive | number |
Proportional score for positive sentiment (sums to 1.0 with other classes) |
| breakdown.negative | number |
Proportional score for negative sentiment (sums to 1.0 with other classes) |
| breakdown.neutral | number |
Proportional score for neutral sentiment (sums to 1.0 with other classes) |
Code Examples
curl -X POST https://requiems.xyz/v1/text/sentiment \
-H "requiems-api-key: YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"text": "I absolutely love this product!"}'import requests
url = "https://requiems.xyz/v1/text/sentiment"
headers = {
"requiems-api-key": "YOUR_API_KEY",
"Content-Type": "application/json"
}
payload = {"text": "I absolutely love this product!"}
response = requests.post(url, json=payload, headers=headers)
data = response.json()['data']
print(f"{data['sentiment']} ({data['score']:.2f})")const response = await fetch(
'https://requiems.xyz/v1/text/sentiment',
{
method: 'POST',
headers: {
'requiems-api-key': 'YOUR_API_KEY',
'Content-Type': 'application/json'
},
body: JSON.stringify({ text: 'I absolutely love this product!' })
}
);
const { data } = await response.json();
console.log(`${data.sentiment} (${data.score.toFixed(2)})`);require 'net/http'
require 'json'
uri = URI('https://requiems.xyz/v1/text/sentiment')
request = Net::HTTP::Post.new(uri)
request['requiems-api-key'] = 'YOUR_API_KEY'
request['Content-Type'] = 'application/json'
request.body = { text: 'I absolutely love this product!' }.to_json
response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: true) do |http|
http.request(request)
end
data = JSON.parse(response.body)['data']
puts "#{data['sentiment']} (#{data['score'].round(2)})"Error Responses
422
unprocessable_entity
Analyze Sentiment (Batch)
Analyzes the sentiment of up to 50 texts in a single request. Results are returned in the same order as the input. Each text counts as one unit of usage.
POST
https://requiems.xyz/v1/text/sentiment/batch
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
| texts | array<string> |
Required | The list of texts to analyze. Between 1 and 50 items. |
Try it out
Live DemoRequest
The list of texts to analyze. Between 1 and 50 items.
Sending request...
Response Fields
| Field | Type | Description |
|---|---|---|
| results | array<object> |
Sentiment results for each input text, in the same order as the input. |
| results[].sentiment | string |
The dominant sentiment class: positive, negative, or neutral |
| results[].score | number |
Confidence score for the dominant sentiment, between 0.0 and 1.0 |
| results[].breakdown.positive | number |
Proportional score for positive sentiment (sums to 1.0 with other classes) |
| results[].breakdown.negative | number |
Proportional score for negative sentiment (sums to 1.0 with other classes) |
| results[].breakdown.neutral | number |
Proportional score for neutral sentiment (sums to 1.0 with other classes) |
| total | number |
Total number of results returned. |
Code Examples
curl -X POST https://requiems.xyz/v1/text/sentiment/batch \
-H "requiems-api-key: YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"texts": ["I love this!", "This is terrible.", "The table is there."]}'import requests
url = "https://requiems.xyz/v1/text/sentiment/batch"
headers = {
"requiems-api-key": "YOUR_API_KEY",
"Content-Type": "application/json"
}
payload = {
"texts": [
"I love this!",
"This is terrible.",
"The table is there."
]
}
response = requests.post(url, json=payload, headers=headers)
for item in response.json()['data']['results']:
print(f"{item['sentiment']} ({item['score']:.2f})")const response = await fetch(
'https://requiems.xyz/v1/text/sentiment/batch',
{
method: 'POST',
headers: {
'requiems-api-key': 'YOUR_API_KEY',
'Content-Type': 'application/json'
},
body: JSON.stringify({
texts: ['I love this!', 'This is terrible.', 'The table is there.']
})
}
);
const { data } = await response.json();
data.results.forEach(r => console.log(`${r.sentiment} (${r.score.toFixed(2)})`));require 'net/http'
require 'json'
uri = URI('https://requiems.xyz/v1/text/sentiment/batch')
request = Net::HTTP::Post.new(uri)
request['requiems-api-key'] = 'YOUR_API_KEY'
request['Content-Type'] = 'application/json'
request.body = {
texts: ['I love this!', 'This is terrible.', 'The table is there.']
}.to_json
response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: true) do |http|
http.request(request)
end
JSON.parse(response.body)['data']['results'].each do |r|
puts "#{r['sentiment']} (#{r['score'].round(2)})"
endError Responses
400
bad_request
422
unprocessable_entity
Frequently Asked Questions
The sentiment field returns one of three values β positive, negative, or neutral β based on whichever class has the highest score.
The three breakdown values (positive, negative, neutral) always sum to 1.0. They represent the proportional confidence across all classes, not just the dominant one.
There is no strict character limit enforced at the API level, but very long inputs may be truncated by the underlying model. Aim for inputs under 512 tokens for best accuracy.
Yes. Use the batch endpoint (POST /v1/text/sentiment/batch) to send up to 50 texts in a single request. Results are returned in the same order as the input and each text counts as one unit of usage.