Sentiments

Sentiment records with their comments, topics and scores, plus the category catalog used to label them. Growth plan or above required.

GET`/sentiments`

List detailed sentiment records with full analysis context. Requires the Growth plan or higher.

Access: Growth plan or higher. Params: project_id (required), model, competitor_id, brand_only, analysis (very_positive/positive/neutral/negative/very_negative), collection_id, prompt (prompt ID), country_code, language_code, from, to, page, per_page.

GET`/dimensions/sentiments`

(Optional) Lists available sentiment categories and their metric keys. Requires the Growth plan or higher.

Access: Growth plan or higher. Params: project_id (required).

Code Examples

Download: OpenAPI Swagger Postman

Ask AI: Open in ChatGPT Open in Claude View as Markdown

Language

Request

curl -X GET -H "Authorization: Bearer YOUR_API_KEY" \
  "https://api.llmpulse.ai/api/v1/sentiments?project_id=PROJECT_ID"

const response = await fetch("https://api.llmpulse.ai/api/v1/sentiments?project_id=PROJECT_ID", {
  headers: { "Authorization": "Bearer YOUR_API_KEY" }
});
const data = await response.json();

import requests

response = requests.get(
    "https://api.llmpulse.ai/api/v1/sentiments?project_id=PROJECT_ID",
    headers={"Authorization": "Bearer YOUR_API_KEY"}
)
data = response.json()

require 'httparty'

response = HTTParty.get(
  "https://api.llmpulse.ai/api/v1/sentiments?project_id=PROJECT_ID",
  headers: { "Authorization" => "Bearer YOUR_API_KEY" }
)
data = response.parsed_response

req, _ := http.NewRequest("GET", "https://api.llmpulse.ai/api/v1/sentiments?project_id=PROJECT_ID", nil)
req.Header.Set("Authorization", "Bearer YOUR_API_KEY")
client := &http.Client{}
resp, _ := client.Do(req)
defer resp.Body.Close()

$client = new GuzzleHttp\Client();
$response = $client->request('GET', 'https://api.llmpulse.ai/api/v1/sentiments?project_id=PROJECT_ID', [
    'headers' => ['Authorization' => 'Bearer YOUR_API_KEY']
]);
$data = json_decode($response->getBody(), true);

HttpRequest request = HttpRequest.newBuilder()
    .uri(URI.create("https://api.llmpulse.ai/api/v1/sentiments?project_id=PROJECT_ID"))
    .header("Authorization", "Bearer YOUR_API_KEY")
    .GET()
    .build();
HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());

Response

{ "project_id":107, "page":1, "per_page":20, "total":441,
  "data":[{
    "id":5001, "prompt_execution_id":748952,
    "prompt_text":"Best AI visibility tools", "model":"chatgpt",
    "analysis":"positive", "score":0.85,
    "comment":"The brand is described as a leader in the space with innovative features",
    "topics":["innovation","market_leadership","features"],
    "competitor_id":null, "competitor_name":null, "is_brand_sentiment":true,
    "executed_at":"2025-12-15T10:00:00Z"
  }],
  "request_id":"..."
}

Request

curl -X GET -H "Authorization: Bearer YOUR_API_KEY" \
  "https://api.llmpulse.ai/api/v1/dimensions/sentiments?project_id=PROJECT_ID"

const response = await fetch("https://api.llmpulse.ai/api/v1/dimensions/sentiments?project_id=PROJECT_ID", {
  headers: { "Authorization": "Bearer YOUR_API_KEY" }
});
const data = await response.json();

import requests

response = requests.get(
    "https://api.llmpulse.ai/api/v1/dimensions/sentiments?project_id=PROJECT_ID",
    headers={"Authorization": "Bearer YOUR_API_KEY"}
)
data = response.json()

require 'httparty'

response = HTTParty.get(
  "https://api.llmpulse.ai/api/v1/dimensions/sentiments?project_id=PROJECT_ID",
  headers: { "Authorization" => "Bearer YOUR_API_KEY" }
)
data = response.parsed_response

req, _ := http.NewRequest("GET", "https://api.llmpulse.ai/api/v1/dimensions/sentiments?project_id=PROJECT_ID", nil)
req.Header.Set("Authorization", "Bearer YOUR_API_KEY")
client := &http.Client{}
resp, _ := client.Do(req)
defer resp.Body.Close()

$client = new GuzzleHttp\Client();
$response = $client->request('GET', 'https://api.llmpulse.ai/api/v1/dimensions/sentiments?project_id=PROJECT_ID', [
    'headers' => ['Authorization' => 'Bearer YOUR_API_KEY']
]);
$data = json_decode($response->getBody(), true);

HttpRequest request = HttpRequest.newBuilder()
    .uri(URI.create("https://api.llmpulse.ai/api/v1/dimensions/sentiments?project_id=PROJECT_ID"))
    .header("Authorization", "Bearer YOUR_API_KEY")
    .GET()
    .build();
HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());

Response

{
  "project_id": 1,
  "sentiments": [
    { "metric":"sentiment_very_positive", "key":"very_positive", "label":"Very positive", "color":"#22c55e" },
    { "metric":"sentiment_positive",      "key":"positive",      "label":"Positive",      "color":"#4ade80" },
    { "metric":"sentiment_neutral",       "key":"neutral",       "label":"Neutral",       "color":"#e5e7eb" },
    { "metric":"sentiment_negative",      "key":"negative",      "label":"Negative",      "color":"#f97316" },
    { "metric":"sentiment_very_negative", "key":"very_negative", "label":"Very negative", "color":"#ef4444" }
  ],
  "request_id":"..."
}

Sentiments

GET/sentiments

GET/dimensions/sentiments

GET`/sentiments`

GET`/dimensions/sentiments`