API Reference
Get a specific domain sentiment report
GET
header
X-API-Key<token>API Key for programmatic access
domainId*stringUUID of the domain
Format
uuidreportId*stringUUID of the report
Format
uuidDomain sentiment report with detailed results
application/json- response
id*stringUUID of the report
Format
uuiddomainId*stringUUID of the domain
Format
uuidreportDate*stringReport date
Format
date-timemodels*array<string>AI models this report covers. Each scan produces one report per model, so this is normally a single entry.
positivePercentage*numberPercentage of positive sentiment
neutralPercentage*numberPercentage of neutral sentiment
negativePercentage*numberPercentage of negative sentiment
overallScore*numberOverall sentiment score (-100 to 100)
overallSentiment*stringOverall sentiment classification
Value in
"positive""neutral""negative"detailedResults?array<>Detailed results by model and prompt
curl -X GET 'https://api.getmint.ai/api/domains/497f6eca-6276-4993-bfeb-53cbbbba6f08/sentiment/reports/497f6eca-6276-4993-bfeb-53cbbbba6f08'{ "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", "domainId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", "reportDate": "2026-05-25T10:30:00.000Z", "models": [ "chatgpt" ], "positivePercentage": 62, "neutralPercentage": 28, "negativePercentage": 10, "overallScore": 52, "overallSentiment": "positive", "detailedResults": [ { "model": "chatgpt", "promptIndex": 0, "originalPrompt": "How do customers feel about Nike?", "llmResponse": "Customers generally feel very positive about Nike products.", "sentiment": "positive", "usedWebSearch": true, "citations": [ { "url": "https://techcrunch.com/2025/01/10/payment-apis-compared", "title": "Payment APIs Compared", "text": "Stripe continues to lead in developer experience...", "website": "techcrunch.com", "brandMentioned": true, "brandMentionContext": "...Stripe continues to lead..." } ], "toolUsage": [ { "type": "web_search", "parameters": { "query": "Nike customer sentiment 2026" } } ] } ]}