Reviews.io Automation Actor

Automated review submission system for Reviews.io platform with advanced human-like behavior simulation, fingerprinting, and anti-detection features.

Features

• ✅ Human-like behavior: Realistic typing, mouse movements, and scrolling patterns
• ✅ Advanced anti-detection: Browser fingerprinting and stealth plugins
• ✅ Configurable timing: Adjustable typing speed, action delays, and scroll duration
• ✅ URL parameter support: Smart merge of URL parameters and input fields
• ✅ Optional merchant metrics: Support for 7 different merchant rating fields
• ✅ Proxy support: Built-in Apify Proxy integration with residential proxies
• ✅ Retry logic: Automatic retry on failures with configurable attempts
• ✅ Success validation: Automatic detection of submission confirmation page

Input Configuration

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)

Need Custom Automation?

Looking for a tailored automation solution for your business?

I specialize in building high-quality, production-ready automation systems like this one. Whether you need web scraping, form automation, data extraction, or custom integrations, I can help bring your project to life.

📬 Contact & Hire Me

• Portfolio & Services: Fiverr - Tech_Be
• Enterprise Projects: Upwork Profile
• GitHub: TechBeme
• Business Email: apify@techbe.me

💡 Get a free quote for your automation needs - from simple scripts to complex enterprise solutions!

License

This Actor is provided as-is for use on the Apify platform.