🎨 Review to Image Generator

Transform customer reviews and testimonials into beautiful, shareable images for social media.

LICENSE

Perfect for showcasing social proof, creating marketing content, and building trust with potential customers. Generate professional review images in seconds with customizable themes, colors, and layouts.

---

📋 Table of Contents

• Features
• Output Examples
• Quick Start
• Configuration
• Design Customization
• Supported Platforms
• Pricing
• Output

---

✨ Features

🌍 Platform Support 30+ platforms supported Google, Facebook, Instagram, Twitter/X Trustpilot, Yelp, Amazon, TripAdvisor G2, Capterra, Product Hunt, and more 🎨 Design Options Multiple aspect ratios (Square, Stories, Landscape) Light & Dark themes Gradient & solid colors 4 font size options

⭐ Visual Elements Star ratings (1-5 stars) Author photos with circular crop Platform logos & badges Smart text truncation 🤖 Automation Auto-fetch from Apify scrapers Batch processing multiple reviews High-quality output (PNG, JPEG, WebP)

---

📸 Output Examples

Square Format (1080×1080)

Stories Format (1080×1920)

Landscape Format (1920×1080)

---

🚀 Quick Start

Option 1: Manual Input

Enter your reviews directly in the input:

{
  "inputMode": "manual",
  "reviews": [
    {
      "authorName": "Sarah Johnson",
      "authorTitle": "CEO at TechCorp",
      "reviewText": "This product has completely transformed our workflow. Highly recommended!",
      "rating": 5
    }
  ],
  "source": "google",
  "theme": "light",
  "aspectRatio": "square",
  "fontSize": "medium"
}

Option 2: Auto-Fetch from Scrapers

Automatically import reviews from Apify review scrapers:

{
  "inputMode": "apify_scraper",
  "apifyApiToken": "YOUR_APIFY_API_TOKEN",
  "scraperActorId": "compass/google-maps-reviews-scraper",
  "scraperInput": {
    "startUrls": [{ "url": "https://www.google.com/maps/place/..." }]
  },
  "maxReviewsFromScraper": 5,
  "minRatingFilter": 4
}

---

⚙️ Configuration

Input Parameters

Parameter	Type	Default	Description
inputMode	string	manual	Input method: manual or apify_scraper
theme	string	light	Color theme: light or dark
aspectRatio	string	square	Image dimensions: square, stories, or landscape
fontSize	string	medium	Text size: small, medium, large, or xlarge
colorStyle	string	gradient	Background style: gradient or solid
primaryColor	string	#667eea	Primary/background color (hex code)
secondaryColor	string	#764ba2	Secondary gradient color (hex code)
showRating	boolean	true	Display star rating
showAuthorPhoto	boolean	true	Display author profile picture
showSourceIcon	boolean	true	Display platform logo badge
outputFormat	string	png	Image format: png, jpg, or webp

---

🎨 Design Customization

Font Sizes

Choose from 4 font size options that work with intelligent auto-fitting:

Size	Use Case	Best For
Small	Compact text	Long reviews, detailed testimonials
Medium ⭐	Balanced (default)	Most reviews, general use
Large	Emphasis	Short impactful quotes
Extra Large	Maximum impact	Very short reviews, headlines

💡 Tip: Font size automatically adjusts based on review length to ensure text always fits perfectly.

Platform Branding

Each platform displays its authentic logo and brand color:

🔵 Google - Blue "G" logo 📘 Facebook - "f" logo 📷 Instagram - Camera emoji ⭐ Trustpilot - Star icon 🔴 Yelp - "Y!" logo

🎵 TikTok - Music note ▶️ YouTube - Play button 💬 WhatsApp - Chat bubble 🅰️ Amazon - "a" logo 🔗 LinkedIn - "in" logo

Smart Text Handling

Auto-Adjustment Font size adapts to review length Maintains readability across formats Optimizes for available space

Text Processing Word-wrapping for clean breaks Ellipses (...) for truncation Full space utilization

Color Customization

{
  "colorStyle": "gradient",
  "primaryColor": "#667eea",
  "secondaryColor": "#764ba2",
  "textColor": "",
  "starColor": "#FFD700"
}

💡 Leave textColor empty for automatic selection based on theme.

---

🌐 Supported Platforms

---

💰 Pricing

Pay-Per-Event Model: $0.005 per image generated

Images Generated	Total Cost
10 images	$0.05
100 images	$0.50
1,000 images	$5.00
10,000 images	$50.00

⚠️ Note: When using auto-fetch mode, scraper runs consume additional Apify credits based on the scraper's pricing.

---

🔗 Supported Review Scrapers

Compatible with popular Apify review scrapers:

Scraper	Actor ID	Platform
Google Maps Reviews	compass/google-maps-reviews-scraper	Google Maps
Facebook Reviews	apify/facebook-reviews-scraper	Facebook
Trustpilot Scraper	apify/trustpilot-scraper	Trustpilot
Yelp Scraper	apify/yelp-scraper	Yelp
TripAdvisor Scraper	apify/tripadvisor-scraper	TripAdvisor

💡 You can also use any custom Apify actor that outputs review data.

---

📤 Output

Storage

All generated images are automatically stored in the Apify Key-Value Store with:

• ✅ Direct download URLs
• ✅ Permanent storage
• ✅ Easy sharing and embedding

Dataset Output

Each run produces a dataset with:

• Image URLs and metadata
• Author information
• Review details
• Generation statistics
• Success/failure status

Access Your Images

// Example output
{
  "authorName": "Sarah Johnson",
  "rating": 5,
  "source": "google",
  "imageUrl": "https://api.apify.com/v2/key-value-stores/{storeId}/records/{fileName}",
  "success": true,
  "dimensions": { "width": 1080, "height": 1080 }
}

---

📄 License

Apache-2.0

---