Marlo Sentiment icon

Marlo Sentiment

Analyze text sentiment using Marlo AI

Overview

This node performs sentiment analysis on provided text using the Marlo AI service. It is designed to evaluate the emotional tone of textual content, returning whether the sentiment is positive, negative, or neutral along with confidence scores. The node supports specifying an industry context to tailor the analysis for more accurate results in different domains such as healthcare, finance, gaming, and more.

Common scenarios:

  • Analyzing customer feedback or reviews to gauge satisfaction.
  • Monitoring social media posts or comments for brand sentiment.
  • Evaluating sentiment in support tickets or emails to prioritize responses.
  • Enhancing chatbots or virtual assistants with sentiment awareness.

Example:
A marketing team could input product review texts and specify the "Retail" industry to get sentiment insights that consider retail-specific language nuances, helping them understand customer opinions better.

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 Collection of optional fields:
• Include Raw Scores: Whether to include detailed sentiment scores in the output (boolean).

Output

The node outputs a JSON object per input item containing:

  • sentiment: The overall sentiment classification (e.g., positive, negative, neutral).
  • confidence: A numeric confidence score indicating the certainty of the sentiment result.
  • 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 if the "Include Raw Scores" option is enabled.

No binary data output is produced by this node.

Dependencies

  • Requires an API key credential for the Marlo AI sentiment analysis service.
  • Uses RapidAPI host configuration for making authenticated HTTP POST requests to the Marlo API endpoint.
  • The node expects network connectivity to the external Marlo API service.

Troubleshooting

  • Error: "Text parameter is required and cannot be empty"
    Occurs if the input text is missing or only whitespace. Ensure the "Text" property is filled with valid content.

  • Error: "Text cannot exceed 5000 characters"
    The node enforces a maximum text length of 5000 characters. Split longer texts into smaller chunks before processing.

  • API Authentication Errors
    If the API key or host is invalid or missing, the request will fail. Verify that the correct API credentials are configured in n8n.

  • Network or Timeout Issues
    Connectivity problems to the Marlo API endpoint can cause failures. Check internet access and API service status.

  • Handling Failures
    The node supports continuing on failure; errors for individual items can be captured in the output JSON under an error field when enabled.

Links and References

Discussion