AI-Powered Review Scraper - Multi-Platform Aggregation with Claude AI Sentiment Analysis

Aggregate customer reviews from Google Maps, Yelp, Facebook, BBB, TripAdvisor, Trustpilot, and Angi in a single run. Includes Claude AI-powered sentiment analysis with theme extraction, complaint detection, praise patterns, and actionable improvement recommendations. BYOK (Bring Your Own Key) for AI features.

Features

Multi-Platform Aggregation

• Google Maps Reviews - Star ratings, review text, owner responses
• Yelp Reviews - Detailed reviews with business data
• Facebook Recommendations - Social proof from Facebook pages
• BBB Customer Reviews - Better Business Bureau complaints and reviews
• TripAdvisor Reviews - Traveler reviews and bubble ratings
• Trustpilot Reviews - TrustScore and verified reviews
• Angi (Angie's List) Reviews - Home service provider reviews
• Unified Format - All platforms normalized to a consistent schema

AI Analysis (BYOK - Bring Your Own Key)

• Claude AI Sentiment Analysis - Deep analysis using Claude Sonnet
• Theme Extraction - Automatic categorization of feedback themes
• Complaint Detection - Identify recurring issues and pain points
• Praise Patterns - Understand what customers love most
• Competitive Insights - AI-generated competitive positioning analysis
• Actionable Recommendations - Improvement suggestions based on review data
• Sentiment Scoring - 0-100 overall sentiment score

Analytics & Reporting

• Aggregate Ratings - Combined rating across all platforms
• Rating Distribution - 5-star through 1-star breakdown
• Platform Comparison - Performance metrics per platform
• Response Rate Tracking - Owner/business response monitoring
• Date Range Filtering - Focus on specific time periods
• Demo Mode - Test with sample data before going live

Who Should Use This Actor?

Local Business Owners

Get a unified view of your reviews across all platforms. Identify which platforms need attention and track overall reputation trends.

Marketing Agencies

Build comprehensive reputation reports for clients. Aggregate reviews from all platforms in one dashboard-ready dataset.

Reputation Management Companies

Monitor client reviews across all major platforms. Use AI analysis to identify themes and prioritize response strategies.

Multi-Location Brands

Track review performance across locations and platforms. Identify location-specific issues and best practices.

Competitive Intelligence Teams

Compare your review profile against competitors across platforms. Identify competitive advantages and vulnerabilities.

Customer Experience Teams

Analyze feedback themes to improve service delivery. Use AI recommendations to prioritize customer experience improvements.

Quick Start

Demo Mode (Free Test)

{
  "demoMode": true
}

Basic Multi-Platform Scrape

{
  "businessName": "Joe's Pizza",
  "location": "New York, NY",
  "platforms": ["google", "yelp", "facebook"],
  "maxReviewsPerPlatform": 50,
  "demoMode": false
}

With AI Sentiment Analysis

{
  "businessName": "Joe's Pizza",
  "location": "New York, NY",
  "platforms": ["google", "yelp", "facebook", "tripadvisor"],
  "maxReviewsPerPlatform": 100,
  "enableAiAnalysis": true,
  "anthropicApiKey": "sk-ant-your-api-key",
  "demoMode": false
}

Competitive Comparison

{
  "businesses": [
    {"name": "Your Business", "location": "Chicago, IL"},
    {"name": "Competitor A", "location": "Chicago, IL"},
    {"name": "Competitor B", "location": "Chicago, IL"}
  ],
  "platforms": ["google", "yelp"],
  "maxReviewsPerPlatform": 25,
  "enableAiAnalysis": true,
  "anthropicApiKey": "sk-ant-your-api-key",
  "demoMode": false
}

Input Parameters

Parameter	Type	Default	Description
businessName	string	-	Business name to search
businesses	array	-	Multiple businesses for comparison
location	string	-	City, State for business search
businessUrl	string	-	Direct URL to any supported platform
platforms	array	["google"]	Platforms: google, yelp, facebook, bbb, tripadvisor, trustpilot, angi
maxReviewsPerPlatform	number	50	Max reviews per platform
minRating	number	-	Minimum star rating to include
maxRating	number	-	Maximum star rating to include
dateFrom	string	-	Only reviews after this date (YYYY-MM-DD)
dateTo	string	-	Only reviews before this date
includeOwnerResponses	boolean	true	Include business responses to reviews
enableAiAnalysis	boolean	false	Enable Claude AI sentiment analysis
anthropicApiKey	string	-	Your Anthropic API key (for AI features)
proxyConfiguration	object	Residential	Proxy settings
demoMode	boolean	true	Return sample data for testing
webhookUrl	string	-	Webhook URL for results delivery

Output Format

Review Dataset

{
  "reviewId": "google-abc123",
  "platform": "google",
  "businessName": "Joe's Pizza",
  "reviewerName": "John D.",
  "reviewerAvatar": "https://...",
  "rating": 5,
  "text": "Best pizza in NYC! The pepperoni is perfectly crispy...",
  "date": "2025-12-15",
  "ownerResponse": {
    "text": "Thanks John! Glad you loved it!",
    "date": "2025-12-16"
  },
  "helpful": 8,
  "platform": "google"
}

AI Sentiment Report (Key-Value Store)

{
  "overallSentiment": 87,
  "sentimentLabel": "Very Positive",
  "totalReviews": 250,
  "averageRating": 4.6,
  "platformBreakdown": {
    "google": {"avgRating": 4.7, "reviewCount": 120},
    "yelp": {"avgRating": 4.4, "reviewCount": 80},
    "facebook": {"avgRating": 4.8, "reviewCount": 50}
  },
  "positiveThemes": [
    {"theme": "Food Quality", "mentions": 145, "sentiment": 92},
    {"theme": "Customer Service", "mentions": 89, "sentiment": 88}
  ],
  "negativeThemes": [
    {"theme": "Wait Times", "mentions": 23, "sentiment": 35},
    {"theme": "Parking", "mentions": 12, "sentiment": 28}
  ],
  "recommendations": [
    "Consider adding online ordering to reduce wait times",
    "Address parking concerns in Google Maps listing",
    "Leverage strong food quality reviews in marketing"
  ]
}

Pricing (Pay-Per-Event)

Event	Description	Price
review_scraped	Per review scraped	$0.01
platform_scraped	Per platform queried	$0.02

Example costs:

• 50 reviews from 3 platforms: (50 x $0.01) + (3 x $0.02) = $0.56
• 200 reviews from 5 platforms: (200 x $0.01) + (5 x $0.02) = $2.10
• AI analysis is powered by your own Anthropic API key (BYOK)
• Demo mode: $0.00

Common Scenarios

Scenario 1: Monthly Reputation Report

{
  "businessName": "Your Business Name",
  "location": "Your City, ST",
  "platforms": ["google", "yelp", "facebook", "bbb"],
  "maxReviewsPerPlatform": 100,
  "enableAiAnalysis": true,
  "anthropicApiKey": "sk-ant-your-key",
  "demoMode": false
}

Schedule monthly for comprehensive reputation tracking.

Scenario 2: Negative Review Alert

{
  "businessName": "Your Business",
  "location": "Your City, ST",
  "platforms": ["google", "yelp"],
  "maxRating": 3,
  "maxReviewsPerPlatform": 50,
  "webhookUrl": "https://hooks.slack.com/your-webhook",
  "demoMode": false
}

Route negative reviews to Slack for immediate response.

Scenario 3: Competitive Benchmarking

{
  "businesses": [
    {"name": "Your Business", "location": "Denver, CO"},
    {"name": "Competitor 1", "location": "Denver, CO"},
    {"name": "Competitor 2", "location": "Denver, CO"}
  ],
  "platforms": ["google", "yelp"],
  "enableAiAnalysis": true,
  "anthropicApiKey": "sk-ant-your-key",
  "demoMode": false
}

Webhook & Automation Integration

Webhook Configuration

{
  "businessName": "Your Business",
  "platforms": ["google", "yelp"],
  "webhookUrl": "https://your-endpoint.com/webhook"
}

Zapier / Make.com / n8n

1. Create a webhook trigger in your automation platform
2. Copy the webhook URL to webhookUrl
3. Route results to Google Sheets, CRM, Slack, etc.

Popular automations:

• All reviews -> Google Sheets (unified dashboard)
• Negative reviews -> Slack alert (immediate response)
• AI report -> Email to management (monthly digest)
• Competitor data -> Airtable (competitive tracking)

Apify Scheduled Runs

Schedule weekly or monthly runs for ongoing reputation monitoring.

AI Analysis Details

BYOK (Bring Your Own Key)

The AI features use your Anthropic API key. You maintain full control over API costs:

• Claude AI analysis costs are billed directly to your Anthropic account
• Typical cost: ~$0.05-$0.20 per analysis run (depending on review volume)
• Set enableAiAnalysis: false to skip AI features entirely

What the AI Analyzes

1. Sentiment themes - Groups reviews into positive/negative categories
2. Complaint frequency - Identifies most common issues
3. Praise patterns - Highlights consistent strengths
4. Competitive positioning - How you compare to competitors
5. Actionable recommendations - Specific improvement suggestions

FAQ

Q: Do I need accounts on all platforms?

A: No. This scraper uses public data from all supported platforms. No login required.

Q: Do I need an Anthropic API key?

A: Only if you want AI sentiment analysis. The review scraping works without it.

Q: Can I scrape reviews for multiple locations?

A: Yes. Use the businesses array parameter to include multiple business names and locations.

Q: How are reviews deduplicated?

A: Each review includes the source platform. The same review cannot appear from two platforms since reviews are platform-specific.

Q: Can I filter by date range?

A: Yes. Use dateFrom and dateTo parameters to focus on specific time periods.

Common Problems & Solutions

"Business not found on [platform]"

• Not all businesses are listed on all platforms
• Check business name spelling and location
• Try providing a direct URL instead

"AI analysis failed"

• Verify your Anthropic API key is correct
• Ensure your key has sufficient credits
• Try with fewer reviews to reduce AI processing

"Rate limited on a platform"

• Wait 10-15 minutes and retry
• Reduce maxReviewsPerPlatform
• Try removing the problematic platform from platforms array

"Demo data showing"

• Set demoMode: false - no account required for basic scraping

---

📞 Support

• Actor Arsenal: Full Actor Catalog
• Developer: John Rippy

---

Built by John Rippy | Actor Arsenal