Review Sentiment Analyzer

Scrape product/business reviews and analyze sentiment with keyword extraction.

Features

• Sentiment Analysis: Classifies each review as positive, negative, or neutral with a score from -1 to 1
• Keyword Extraction: Extracts key themes and topics from reviews
• Summary Statistics: Provides aggregate insights including sentiment distribution and top keywords
• AI Summary (Optional): Uses OpenAI GPT to generate actionable business insights

Input

Parameter	Type	Required	Default	Description
reviewsUrl	string	Yes	-	URL of the place to scrape (Google Maps)
maxReviews	integer	No	50	Maximum reviews to analyze (1-500)
includeAISummary	boolean	No	false	Generate AI-powered insights
openaiApiKey	string	No	-	OpenAI API key (required for AI summary)
language	string	No	english	Review language for keyword extraction

Output

Per Review

{
  "id": 1,
  "reviewText": "Amazing food and great service!",
  "rating": 5,
  "date": "2024-01-15",
  "sentiment": "positive",
  "sentimentScore": 0.75,
  "keywords": ["amazing", "food", "great", "service"],
  "positiveWords": ["amazing", "great"],
  "negativeWords": []
}

Summary

{
  "_type": "summary",
  "totalReviews": 50,
  "averageSentiment": 0.32,
  "averageRating": 3.8,
  "positivePercent": 54,
  "negativePercent": 26,
  "neutralPercent": 20,
  "topPositiveKeywords": [
    {"keyword": "service", "count": 15},
    {"keyword": "food", "count": 12}
  ],
  "topNegativeKeywords": [
    {"keyword": "wait", "count": 8},
    {"keyword": "slow", "count": 5}
  ]
}

Usage

Basic

{
  "reviewsUrl": "https://www.google.com/maps/place/...",
  "maxReviews": 100
}

With AI Summary

{
  "reviewsUrl": "https://www.google.com/maps/place/...",
  "maxReviews": 100,
  "includeAISummary": true,
  "openaiApiKey": "sk-..."
}

Limitations

• Google Maps reviews require JavaScript rendering; the actor uses sample reviews for demonstration if scraping fails
• For production use with Google Maps, consider using Apify's Google Maps scraper in combination with this analyzer
• AI summary requires a valid OpenAI API key and incurs API costs

How It Works

1. Scraping: Attempts to fetch reviews from the provided URL
2. Sentiment Analysis: Uses the sentiment npm package to score each review
3. Keyword Extraction: Uses keyword-extractor to identify important terms
4. Statistics: Aggregates results into actionable metrics
5. AI Analysis (optional): Sends review summaries to GPT for deeper insights

Cost Estimation

• Base actor run: ~$0.01 per run (minimal compute)
• AI summary (if enabled): ~$0.001-0.005 per run (GPT-4o-mini tokens)

Support

For issues or feature requests, please open an issue on GitHub.