Overview
This node performs sentiment analysis on provided text using the Marlo AI service. It is designed to analyze the emotional tone of text content, which can be useful in scenarios such as customer feedback evaluation, social media monitoring, product review analysis, or any context where understanding sentiment is valuable. By specifying an industry context, the analysis can be tailored for more accurate results relevant to that domain.
Practical examples:
- Analyzing customer reviews in the retail industry to gauge satisfaction.
- Monitoring social media posts about a technology product launch.
- Evaluating patient feedback in healthcare settings for quality improvement.
Properties
| Name | Meaning |
|---|---|
| Text | The text content to analyze for sentiment. |
| Industry | Industry context for more accurate sentiment analysis. Options: General, Healthcare, Technology, Gaming, Finance, Restaurant, Automotive, Real Estate, Fitness, Education, Retail. |
| Additional Fields | Optional additional settings: • Include Raw Scores: Whether to include detailed sentiment scores in the output (boolean). |
Output
The node outputs a JSON object with the following structure:
sentiment: The overall sentiment classification result (e.g., positive, negative, neutral).confidence: A confidence score indicating the certainty of the sentiment prediction.text_length: The length of the analyzed text.original_text: The original input text.industry(optional): The industry context used for analysis, if specified.scores(optional): Detailed raw sentiment scores, included only if the "Include Raw Scores" option is enabled.
If multiple input items are processed, the output is an array of such JSON objects, each paired with its corresponding input item.
Dependencies
- Requires an API key credential for the Marlo AI sentiment analysis service.
- Uses the RapidAPI host endpoint configured via credentials.
- The node makes HTTP POST requests to the Marlo API endpoint
/analyze.
Troubleshooting
Error: "Text parameter is required and cannot be empty"
Occurs if the input text is missing or empty. Ensure the "Text" property is provided and not just whitespace.Error: "Text cannot exceed 5000 characters"
The input text length limit is 5000 characters. Shorten the text to comply with this restriction.API request failures
Check that the API key credential is valid and that the RapidAPI host is correctly configured. Network issues or invalid credentials will cause request errors.Handling multiple inputs
If processing multiple items, enabling "Continue On Fail" allows the node to continue processing subsequent items even if one fails, returning error details per failed item.
Links and References
- Marlo AI Sentiment Analysis API Documentation (example link, replace with actual if available)
- n8n HTTP Request Node Documentation (for understanding underlying request mechanics)