Skip to content

harishdtu/Review-analytics

Folders and files

NameName
Last commit message
Last commit date

Latest commit

ย 

History

8 Commits
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 

Repository files navigation

๐Ÿง  ReviewIQ โ€” Amazon Review Intelligence Platform

ReviewIQ is a full-stack web application that analyzes Amazon product reviews and converts them into actionable insights using AI. It helps users quickly understand what customers love, hate, and expect improvements on โ€” without manually reading hundreds of reviews.


๐Ÿš€ Live Features

Vercel:https://review-analytics-beta.vercel.app/ render: https://review-analytics-j59q.onrender.com

๐Ÿ” 1. Single Product Analysis

  • Input: Amazon product URL

  • Output:

    • โญ Average Rating

    • ๐Ÿ“Š Sentiment Breakdown (Positive / Neutral / Negative)

    • ๐Ÿ’ก AI-generated insights:

      • Why customers buy
      • Common complaints
      • Suggested improvements

๐Ÿ“Š 2. AI-Powered Insights

  • Uses Groq API (LLMs like Mixtral / GPT-OSS)
  • Converts raw reviews โ†’ structured JSON:
{
  "buyReasons": [],
  "complaints": [],
  "improvements": []
}

๐ŸŽฏ 3. Sentiment Analysis

  • Derived from ratings:

    • โญ 4โ€“5 โ†’ Positive
    • โญ 3 โ†’ Neutral
    • โญ 1โ€“2 โ†’ Negative
  • Displayed using:

    • Doughnut chart (Chart.js)
    • Progress bars

๐Ÿ–ฅ๏ธ 4. Modern Dashboard UI

  • Clean dark UI
  • Product scorecard
  • Insight cards
  • Interactive charts

๐Ÿ—๏ธ Tech Stack

Frontend

  • โš›๏ธ React (Vite + TypeScript)
  • ๐Ÿ“Š Chart.js
  • ๐ŸŽจ Custom CSS (dark theme)

Backend

  • ๐ŸŸข Node.js + Express
  • ๐ŸŒ REST API

AI

  • ๐Ÿค– Groq SDK (LLM-based analysis)

Scraping

  • ๐Ÿ•ท๏ธ Playwright / Cheerio / Apify (earlier iterations)

  • Extracts:

    • Product title
    • Reviews
    • Ratings

โš™๏ธ Project Architecture

review-analytics/
โ”‚
โ”œโ”€โ”€ backend/
โ”‚   โ”œโ”€โ”€ server.js        # Express server
โ”‚   โ”œโ”€โ”€ scrape.js        # Review + product scraping
โ”‚   โ”œโ”€โ”€ ai.js            # Groq AI integration
โ”‚   โ””โ”€โ”€ .env             # API keys
โ”‚
โ”œโ”€โ”€ frontend/
โ”‚   โ”œโ”€โ”€ src/
โ”‚   โ”‚   โ”œโ”€โ”€ App.tsx
โ”‚   โ”‚   โ”œโ”€โ”€ Dashboard.tsx
โ”‚   โ”‚   โ”œโ”€โ”€ components/
โ”‚   โ”‚   โ””โ”€โ”€ styles/
โ”‚   โ””โ”€โ”€ index.html

๐Ÿ”„ Workflow

  1. User enters Amazon product URL

  2. Backend:

    • Extracts ASIN
    • Scrapes product title + reviews
    • Computes sentiment
    • Sends reviews to AI
  3. AI:

    • Generates structured insights
  4. Frontend:

    • Displays analytics dashboard

๐Ÿ“ก API Endpoints

POST /analyze

Request:

{
  "url": "https://www.amazon.in/dp/XXXX"
}

Response:

{
  "productName": "...",
  "avgRating": 4.5,
  "reviewsCount": 10,
  "sentiment": {
    "positive": 80,
    "neutral": 10,
    "negative": 10
  },
  "insights": {
    "buyReasons": [],
    "complaints": [],
    "improvements": []
  }
}

๐Ÿ› ๏ธ Setup Instructions

1๏ธโƒฃ Clone Repo

git clone https://github.com/yourusername/reviewiq.git
cd reviewiq

2๏ธโƒฃ Backend Setup

cd backend
npm install

Create .env:

GROQ_API_KEY=your_api_key

Run server:

node server.js

3๏ธโƒฃ Frontend Setup

cd frontend
npm install
npm run dev

โš ๏ธ Challenges Faced

โŒ API Limitations

  • Apify free tier memory limits (8192MB)
  • Paid actor restrictions
  • Service downtime (junglee maintenance)

โœ… Solutions

  • Reduced API dependency
  • Implemented fallback scraping
  • Optimized API calls

๐Ÿ’ก Key Learnings

  • Real-world scraping โ‰  stable APIs
  • Need for fallback mechanisms
  • Data pipelines require multiple sources
  • AI works best with structured prompts

๐Ÿ”ฎ Future Improvements

  • ๐Ÿ”ฅ Competitor comparison dashboard
  • ๐Ÿ“ˆ Revenue estimation
  • ๐Ÿง  Keyword extraction (battery, camera, etc.)
  • โšก Caching results (reduce API cost)
  • ๐ŸŒ Deploy as SaaS

๐Ÿง‘โ€๐Ÿ’ป Author

Harish Vasamsetti

  • Full Stack Developer
  • Passionate about AI + Product Building

โญ Why This Project Matters

Most users:

โŒ Read hundreds of reviews manually

ReviewIQ:

โœ… Converts reviews โ†’ insights instantly


๐Ÿ Conclusion

ReviewIQ is a step toward building:

๐Ÿง  AI-powered decision tools for e-commerce

It demonstrates:

  • Full-stack engineering
  • AI integration
  • Real-world problem solving

๐Ÿ“ฌ Feedback

Feel free to contribute or suggest improvements ๐Ÿš€

About

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors