Gmail Sentiment Scanner - Email Tone & Communication Health Analyzer

Analyze Gmail email sentiment for team and client communications. Get sentiment scores, response time patterns, and communication health insights. Works with Google Workspace.

Features

• Demo Mode: Test the actor without Google credentials
• Smart Filtering: Exclude automated emails, newsletters, notifications
• Client Segmentation: Group analysis by external domain
• Sentiment Keywords: Detects positive, negative, and neutral patterns
• Privacy-First: Only analyzes metadata and snippets, not full email bodies

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

Output Format

Sentiment Overview

{
  "demoMode": false,
  "overview": {
    "emailsAnalyzed": 156,
    "overallSentiment": 62,
    "sentimentLabel": "Positive",
    "dateRange": "last_7_days",
    "internalSentiment": 68,
    "externalSentiment": 58
  },
  "trends": {
    "weekOverWeek": 5,
    "mostPositiveDay": "Tuesday",
    "mostNegativeDay": "Monday"
  }
}

Client Segments

{
  "clientSegments": [
    {
      "domain": "acmecorp.com",
      "emailCount": 12,
      "avgSentiment": 75,
      "sentimentTrend": "improving",
      "topPositiveSubjects": ["Thank you for the quick turnaround!"],
      "topNegativeSubjects": []
    },
    {
      "domain": "troubledclient.com",
      "emailCount": 8,
      "avgSentiment": 32,
      "sentimentTrend": "declining",
      "topPositiveSubjects": [],
      "topNegativeSubjects": ["Urgent: Issue with the latest update"]
    }
  ]
}

Alerts & Recommendations

{
  "alerts": [
    {
      "type": "client_concern",
      "message": "2 client(s) showing declining sentiment",
      "severity": "medium"
    }
  ],
  "recommendations": [
    "Schedule check-in calls with: troubledclient.com, demandingco.com",
    "Client communication sentiment is lower than internal - consider proactive outreach"
  ]
}

Pricing

This actor uses pay-per-event billing:

• data_point: $0.01 per result

Use Cases

• Data collection
• Research
• Automation

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