7666b7aea2
- Replace non-working Google Maps embed iframe with animated location preview - Add "Open in Google Maps" button to open location in new tab - Add scraper type selection dropdown fetching from /api/admin/scrapers - Show selected scraper info with formatted labels (Google Reviews v1.0.0) - Include scraper_version and scraper_variant in job submission Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
Google Reviews Scraper - Testing Interface
A Next.js web interface for testing the containerized Google Reviews Scraper API.
Features
- 🎯 URL Input - Paste any Google Maps business URL
- 📊 Real-time Status - Live job tracking with polling
- ⚡ Performance Metrics - Reviews count, time, speed
- 📱 Review Display - Beautiful UI for scraped reviews
- 💾 Export JSON - Download reviews as JSON
Quick Start
1. Start the Scraper API
First, make sure the containerized scraper is running:
cd ..
docker-compose -f docker-compose.production.yml up -d
The API should be running at http://localhost:8000
2. Start the Web Interface
npm install
npm run dev
Usage
-
Paste a Google Maps URL
https://www.google.com/maps/place/Business+Name/... -
Click "Scrape"
- Job is submitted to the API
- Status updates in real-time
- Reviews appear when complete
-
View Results
- See all scraped reviews
- Export as JSON
- View performance metrics
Environment Variables
Create .env.local if you need to customize:
# API URL (default: http://localhost:8000)
NEXT_PUBLIC_API_URL=http://localhost:8000
API Endpoints Used
This interface connects to:
POST /scrape- Submit scraping jobGET /jobs/{job_id}- Get job statusGET /jobs/{job_id}/reviews- Get reviews
Tech Stack
- Next.js 15 - React framework
- TypeScript - Type safety
- Tailwind CSS - Styling
- API Proxy - Next.js API routes proxy to scraper API
Development
npm run dev # Start dev server
npm run build # Build for production
npm run start # Start production server
npm run lint # Run ESLint
Notes
- The interface polls job status every 2 seconds
- Polling stops when job completes or fails
- Reviews are fetched with a limit of 1000 by default
- Export button downloads reviews as formatted JSON