Sentiment Analysis API - AI-Powered Text Analysis

API Integration

This actor connects to an external API service. You'll need valid API credentials from the service provider.

---

API Integration

This actor connects to an external API service. You'll need valid API credentials from the service provider.

---

Analyze text sentiment using AI. Detect positive, negative, neutral tones with emotion detection, confidence scores, and key phrase extraction. Features: - Sentiment classification (positive, negative, neutral) - Confidence scores (0-100%) - Emotion detection (joy, anger, sadness, fear, surprise) - Key phrase extraction - Topic detection - Language detection - Batch text processing - Multi-language support Use Cases: - Review analysis - Social media monitoring - Customer feedback - Brand sentiment tracking - Content moderation BYOK Options: - OpenAI API key - Anthropic Claude API key - Google Gemini API key. Built by John Rippy (https://www.linkedin.com/in/johnrippy/ | https://johnrippy.link/).

Features

• Multi-Model Support: Use OpenAI GPT-4o, Claude 3, or built-in rule-based analysis
• Emotion Detection: Identify joy, anger, sadness, fear, surprise, and disgust
• Key Phrase Extraction: Find phrases that influenced the sentiment
• Topic Detection: Automatically detect subjects mentioned in the text
• Batch Processing: Analyze multiple texts in a single run
• Multi-Language: Support for English, Spanish, French, German, and more
• Webhook Integration: Get notified when analysis completes

Quick Start

{
  "input": "your input here"
}

Demo Mode

Set demoMode: true to test with sample data (no charges). When you're ready for real results, set demoMode: false or omit it.

{
  "demoMode": true,
  ...
}

Input Parameters

Parameter	Type	Description
texts	array	Array of texts to analyze (max 100 per run)
text	string	Single text to analyze (use this OR texts array)
includeEmotions	boolean	Detect specific emotions (default: true)
includeKeyPhrases	boolean	Extract key phrases (default: true)
includeTopics	boolean	Detect topics/subjects (default: false)
language	string	Language code or "auto" (default: auto)
openaiApiKey	string	Your OpenAI API key for GPT-4 analysis
anthropicApiKey	string	Your Anthropic API key for Claude analysis
model	string	Model to use: auto, gpt-4o-mini, gpt-4o, claude-3-haiku, claude-3-sonnet, rule-based
webhookUrl	string	URL to receive completion notification
demoMode	boolean	Return sample data for testing

Output Format

The actor outputs a comprehensive analysis object:

{
  "totalTexts": 3,
  "overallSentiment": "mixed",
  "averageScore": 0.07,
  "results": [
    {
      "text": "I love this product! It's amazing.",
      "sentiment": "positive",
      "score": 0.92,
      "confidence": 0.95,
      "magnitude": 0.88,
      "emotions": [
        { "name": "joy", "score": 0.85 },
        { "name": "surprise", "score": 0.15 }
      ],
      "keyPhrases": ["love this product", "amazing"],
      "topics": ["product", "quality"],
      "language": "en",
      "model": "gpt-4o-mini",
      "processingTime": 245
    }
  ],
  "summary": {
    "positive": 1,
    "negative": 1,
    "neutral": 1,
    "mixed": 0
  }
}

Sentiment Scores

• score: -1 (most negative) to 1 (most positive)
• confidence: 0 to 1, how confident the model is
• magnitude: 0 to 1, strength of the sentiment

Sentiment Categories

• positive: Score > 0.2
• negative: Score < -0.2
• neutral: Score between -0.2 and 0.2 with no mixed signals
• mixed: Contains both positive and negative elements

Pricing

This actor uses pay-per-event billing: This actor uses the pay-per-event pricing model:

• Base cost: $0.05 per run
• Per text: $0.002 per text analyzed (rule-based)
• AI models: Additional cost based on API token usage

Example: Analyzing 100 reviews with rule-based = ~$0.25

Use Cases

• Review Analysis: Analyze customer reviews to understand sentiment trends
• Social Media Monitoring: Track sentiment of brand mentions
• Customer Feedback: Categorize support tickets by sentiment
• Content Moderation: Flag negative or toxic content
• Market Research: Analyze survey responses and feedback
• Brand Health: Monitor overall sentiment over time

---

Common Problems & Solutions

"Invalid API key" error

Cause: Your API key is wrong, expired, or doesn't have the right permissions. Fix: Double-check your API key. Make sure you copied it exactly without extra spaces.

"Rate limit exceeded" error

Cause: You've hit the API's rate limits. Fix: Wait a few minutes, then try again. Consider reducing the number of concurrent requests.

Empty or incomplete results

Cause: The target may have anti-scraping protection or the data doesn't exist. Fix:

• Check if the URL/search query is correct
• Try with different parameters
• Some sites may block automated access

Demo data showing instead of real results

Cause: demoMode is still set to true. Fix: Set demoMode: false and provide your API key(s).

---

Built by John Rippy | Actor Arsenal