Reviews.io Automation

---

📋 Table of Contents

• Overview
• About the Developer
• Key Features
• Technology Stack
• Quick Start
• Configuration
• How It Works
• Best Practices
• License

---

🎯 Overview

The Reviews.io Automation Actor is a professional automation system that submits reviews to the Reviews.io platform with advanced human-like behavior simulation. Built with cutting-edge anti-detection techniques, browser fingerprinting, and intelligent retry logic.

Key capabilities:

• Human-like typing, mouse movements, and scrolling
• Advanced browser fingerprinting and stealth mode
• Residential proxy support with automatic rotation
• Configurable timing and delays
• Smart URL parameter merging
• Optional merchant metrics support
• Automatic screenshot on failures

---

👨‍💻 About the Developer

---

✨ Key Features

Human-like Behavior Simulation

• Realistic Typing: Character-by-character input with random delays and thinking pauses
• Natural Mouse Movement: Bezier curve trajectories with variable speed
• Smooth Scrolling: 60fps frame-by-frame animation with sine wave easing
• Reading Simulation: Random micro-pauses simulating natural reading behavior

Advanced Anti-Detection

• Browser Fingerprinting: Realistic device fingerprints via fingerprint-generator
• Stealth Mode: Playwright Extra with stealth plugins
• Residential Proxies: Apify Proxy integration with rotating IPs
• Random User Agents: Latest Chrome and Firefox user agents

Smart Configuration

• URL Parameter Support: Intelligent merge of URL parameters and input fields
• Configurable Timing: Adjustable typing speed, action delays, and scroll duration
• Merchant Metrics: Support for 7 different merchant rating fields
• Retry Logic: Automatic retry on failures with configurable attempts

Robust Error Handling

• Success Validation: Automatic detection of submission confirmation page
• Screenshot Capture: Automatic screenshots on errors for debugging
• Detailed Logging: Comprehensive error messages and status updates
• Graceful Fallbacks: Handles missing optional fields seamlessly

---

🛠️ Technology Stack

Core Technologies

Technology	Version	Purpose
	5.8+	Type-safe development
	18+	Runtime environment
	1.56+	Browser automation
Apify SDK	3.5+	Actor framework and infrastructure
Crawlee	3.13+	Web scraping and automation toolkit

Anti-Detection & Fingerprinting

Technology	Purpose
fingerprint-generator	Generate realistic browser fingerprints
fingerprint-injector	Inject fingerprints into browser context
playwright-extra	Stealth plugins for Playwright
puppeteer-extra-plugin-stealth	Additional stealth techniques

Other Tools

Technology	Purpose
Zod	Schema validation
ESLint	Code linting
Prettier	Code formatting
tsx	TypeScript execution

---

🚀 Quick Start

Running on Apify Platform

1. Deploy this Actor to your Apify account
2. Configure the input fields (see Configuration below)
3. Run the Actor
4. Monitor the logs and download screenshots if needed

Running Locally

# Clone the repository
git clone <your-repo-url>
cd reviews-io-automation

# Install dependencies
npm install

# Run in development mode
npm run start:dev

# Build for production
npm run build
npm run start:prod

---

⚙️ Configuration

Input Schema

Required Fields

Field	Type	Description
reviewText	string	The complete review text to be submitted

Optional Fields

Field	Type	Default	Description
reviewUrl	string	-	Complete Reviews.io URL with pre-filled parameters (store, user, email, order_id, rating). If provided, parameters are extracted and can be overridden by individual input fields
rating	integer (1-5)	5	Star rating for the review (overrides URL 'rating' param if both provided)
reviewerName	string	-	Name of the person submitting the review (overrides URL 'user' param if both provided)
reviewerEmail	string	-	Email address of the reviewer (overrides URL 'email' param if both provided)
store	string	-	Store domain identifier (overrides URL 'store' param if both provided)
orderId	string	-	Order ID for the review (overrides URL 'order_id' param if both provided)

Store Identification

Option 1: Provide store and orderId directly

• store: www-example-store-com
• orderId: ORDER-12345

Option 2: Provide complete URL with all parameters

• reviewUrl: https://www.reviews.io/store/landing_new_review?store=www-example-store-com&user=John%20Doe&email=john@example.com&order_id=ORDER-12345&rating=5

Option 3: Mix both (input fields override URL parameters)

• reviewUrl: https://www.reviews.io/store/landing_new_review?store=www-example-store-com&order_id=ORDER-12345
• reviewerName: "John Doe"
• reviewerEmail: "john@example.com"

Timing Configuration

Field	Type	Default	Description
minTypingDelay	integer	50	Minimum delay between keystrokes (ms)
maxTypingDelay	integer	150	Maximum delay between keystrokes (ms)
minActionDelay	integer	500	Minimum delay between actions (ms)
maxActionDelay	integer	3000	Maximum delay between actions (ms)
minScrollDuration	integer	1000	Minimum scroll animation duration (ms)
maxScrollDuration	integer	3000	Maximum scroll animation duration (ms)

Optional Merchant Metrics

Available fields:

• deliveryOnTime: "Yes", "No"
• deliveryMethod: "Courier", "Postal Service", "Own Driver"
• itemDamaged: "Yes", "No"
• deliveryDays: "Next Day", "Within 5 Days", "Over 7 Days", "Over a month"
• communicationMethod: "Live Chat", "Email", "Telephone"
• companyReplySpeed: "Under an hour", "2-3 Hours", "3-6 Hours", "6-12 Hours", "Over a week"
• customerServiceRating: 0-5 (0 = skip, 1-5 = stars)

Other Options

Field	Type	Default	Description
submitAnonymously	boolean	false	Submit review anonymously
useProxy	boolean	true	Enable proxy usage
headless	boolean	true	Run browser in headless mode
maxRetries	integer	3	Maximum retry attempts on failure
screenshotOnFailure	boolean	true	Capture screenshot on errors

Example Input

Minimal Input (using reviewUrl with all parameters)

{
  "reviewUrl": "https://www.reviews.io/store/landing_new_review?store=example-store&user=John%20Doe&email=john.doe@example.com&order_id=ORDER-12345&rating=5",
  "reviewText": "Amazing quality! The product exceeded my expectations."
}

Full Input (with all optional fields)

{
  "store": "www-example-store-com",
  "orderId": "ORDER-12345",
  "reviewText": "Amazing quality! The product exceeded my expectations. Fast shipping and great customer service. Will definitely order again.",
  "rating": 5,
  "reviewerName": "John Doe",
  "reviewerEmail": "john.doe@example.com",
  "deliveryOnTime": "Yes",
  "deliveryMethod": "Courier",
  "itemDamaged": "No",
  "deliveryDays": "Within 5 Days",
  "submitAnonymously": false,
  "minTypingDelay": 50,
  "maxTypingDelay": 150,
  "minActionDelay": 500,
  "maxActionDelay": 3000,
  "minScrollDuration": 1000,
  "maxScrollDuration": 3000,
  "useProxy": true,
  "headless": true,
  "maxRetries": 3,
  "screenshotOnFailure": true
}

---

🔧 How It Works

URL Construction

The Actor intelligently merges URL parameters with input fields:

1. Extracts all parameters from reviewUrl (if provided)
2. Overrides with explicit input fields (if provided)
3. Applies defaults for missing required parameters (rating=5, type=company)

Priority: Input fields > URL parameters > Defaults

Example:

• reviewUrl has rating=4
• Input has rating=3
• Result: Uses rating=3 (input overrides URL)

Human-like Behavior Simulation

Typing

• Character-by-character input with random delays
• Occasional thinking pauses between words

Mouse Movement

• Bezier curve trajectories for smooth natural paths
• Random target points within clickable elements
• Variable speed (slower at start/end, faster in middle)

Scrolling

• Ultra-smooth 60fps frame-by-frame animation
• Sine wave easing for natural acceleration/deceleration
• Random micro-pauses simulating reading behavior
• Configurable duration (3-15 seconds)

Clicking

• 10-step validation process before each click
• Ensures element is visible in viewport with 50px safety margin
• Automatic scroll-to-element if needed
• Hover delay before click

Anti-Detection Features

• Browser Fingerprinting: Realistic device fingerprints
• Stealth Mode: Playwright Extra with stealth plugins
• Residential Proxies: Apify Proxy with rotating IPs
• Random User Agents: Latest Chrome and Firefox user agents
• Natural Timing: All delays randomized within configured ranges

Robust Error Handling

• Automatic retry on failures (configurable attempts)
• Screenshot capture on errors
• Detailed error logging
• Graceful fallbacks for missing optional fields

---

📚 Best Practices

1. Use Residential Proxies: Enable useProxy for better success rates
2. Slow Down: Use higher scroll and action delays for maximum human-likeness
3. Vary Timing: Use wide ranges for delays to avoid pattern detection
4. Test First: Run with headless=false locally to verify behavior
5. Monitor Success: Check screenshots and logs for any issues

---

⚠️ Limitations

• Only works with Reviews.io platform
• Requires valid store and order ID
• Some merchant metrics may not be available for all stores
• Rate limiting may apply (use delays appropriately)

---

📝 License

Proprietary License - All Rights Reserved

Copyright © 2026 Rafael Vieira (TechBeme)

❌ Restrictions

• No commercial use
• No modifications or derivative works
• No distribution or sublicensing
• No reverse engineering

✅ Permitted Use

• View source code for educational purposes
• Run for personal, non-commercial use on Apify platform
• Fork for personal study only

📧 Commercial Licensing

For commercial use, custom development, or licensing inquiries, contact: contact@techbe.me

---

🙏 Acknowledgments

Built with Playwright, Apify SDK, Crawlee, and other amazing open-source technologies.

---