🛒 Flipkart Review Scraper - API Based

This Apify actor extracts product reviews with user details directly through the Flipkart API. Provide any Flipkart product URL to collect structured review data including author, rating, review text, location, certified buyer status, helpful votes, product attributes, and review images. Perfect for sentiment analysis, product research, and customer feedback analysis.

✅ Use Cases

• 📊 Analyze customer sentiment and feedback
• 🔍 Research product quality and issues
• 📈 Compare reviews across products
• 💬 Build customer feedback databases
• 📋 Generate review reports for market analysis

📥 Input Configuration

You can customize the actor using the following input fields:

{
    "productUrl": "https://www.flipkart.com/samsung-guru-music-2-b310ed/p/itmc77fb727f1cf5?pid=MOBHDFT9GTFDDXP6",
    "maxPages": 10,
    "sortOrder": "MOST_HELPFUL",
    "minRating": 0,
    "includeProductInfo": true
}

🧾 Fields Explained

Field	Type	Description
productUrl	string	Flipkart product URL to scrape reviews from
maxPages	number	Maximum number of review pages to fetch (approx. 10 reviews per page)
sortOrder	string	Sort order: "MOST_HELPFUL", "MOST_RECENT", "POSITIVE_FIRST", "NEGATIVE_FIRST"
minRating	number	Minimum star rating (0-5) to include reviews
includeProductInfo	boolean	Include product information in the output

📤 Output

The actor returns a dataset containing structured review records. Each record includes comprehensive details about the review, suitable for sentiment analysis, research, and customer feedback analysis.

🧩 Sample Output - Review

{
    "type": "review",
    "id": "R1234567890",
    "author": "John Doe",
    "rating": 5,
    "title": "Excellent product!",
    "text": "This product exceeded my expectations. Great quality and fast delivery.",
    "created": "2 months ago",
    "certifiedBuyer": true,
    "location": {
        "city": "Mumbai",
        "state": "Maharashtra"
    },
    "helpfulCount": 42,
    "upvotes": 38,
    "downvotes": 4,
    "productAttributes": [
        {"name": "Color", "value": "Black"},
        {"name": "Storage", "value": "128 GB"}
    ],
    "images": [
        "https://rukminim2.flixcart.com/image/review/..."
    ],
    "reviewUrl": "/review/R1234567890"
}

🧩 Sample Output - Product Info

{
    "type": "product_info",
    "id": "MOBHDFT9GTFDDXP6",
    "title": "Samsung Guru Music 2",
    "superTitle": "Samsung",
    "subtitle": "Feature Phone",
    "rating": {
        "average": 4.1,
        "count": 50234,
        "reviewCount": 3421
    },
    "pricing": {
        "finalPrice": 1999,
        "mrp": 2500,
        "discount": 20
    },
    "availability": "In Stock",
    "keySpecs": ["Dual SIM", "FM Radio", "MP3 Player"],
    "images": ["https://rukminim2.flixcart.com/image/416/416/..."]
}

📋 Review Output Fields

Field	Type	Description
type	string	Record type ("review" or "product_info")
id	string	Unique review identifier
author	string	Review author name
rating	number	Review rating (1-5 stars)
title	string	Review title
text	string	Full review text content
created	string	When the review was posted
certifiedBuyer	boolean	Whether the reviewer is a verified buyer
location	object	Reviewer's city and state
helpfulCount	integer	Number of helpful votes
upvotes	integer	Number of upvotes
downvotes	integer	Number of downvotes
productAttributes	array	Product variant info (color, size, etc.)
images	array	Review image URLs
reviewUrl	string	URL to the review page

🔍 Data Source

• ✓ Data fetched exclusively via Flipkart API (HTTP POST requests)
• ✓ No HTML scraping or DOM parsing
• ✓ Real-time review information directly from Flipkart
• ✓ Automatic filtering and deduplication

🔒 Proxy Configuration

This actor uses standard HTTP headers with optional proxy support for:

• Avoiding IP-based rate limiting or bans
• Accessing location-specific data
• Ensuring stable data retrieval at scale

Configure proxy settings in Apify:

{
  "useApifyProxy": true,
  "apifyProxyGroups": ["RESIDENTIAL"],
  "apifyProxyCountry": "IN"
}

🚀 How to Use

1. Open the actor in Apify Console
2. Click "Try actor" or create a new task
3. Enter the Flipkart product URL
4. Configure optional settings (max pages, sort order, min rating)
5. Run the actor
6. Download results in JSON, CSV, or Excel format

⚙️ Advanced Input Example

{
    "productUrl": "https://www.flipkart.com/apple-iphone-15-blue-128-gb/p/itm6ac6485515ae4?pid=MOBGTAGPNRHX7K3H",
    "maxPages": 50,
    "sortOrder": "MOST_RECENT",
    "minRating": 3,
    "includeProductInfo": true
}

🛠️ Tech Stack

• Apify SDK — actor orchestration and data handling
• Node.js 18+ — runtime environment
• node-fetch — HTTP client for API requests
• Flipkart API — exclusive data source for review information

📊 Data Processing Features

• ✓ Automatic duplicate detection using Review IDs
• ✓ Filtering by minimum rating
• ✓ Structured data parsing and normalization
• ✓ Comprehensive logging and error handling
• ✓ Schema validation for all output records
• ✓ Pagination support for fetching all reviews

🔧 Local Development

Installation

$npm install

Running the Actor

$npm start

Code Quality

Format code:

$npm run format

Check linting:

$npm run lint

📂 Project Structure

.
├── .actor/                          # Actor configuration
│   ├── actor.json                  # Actor metadata
│   ├── input_schema.json           # Input parameters schema
│   ├── dataset_schema.json         # Output dataset schema
│   ├── input.json                  # Default input
│   ├── input-local.json            # Local development input
│   └── input-production.json       # Production input
├── src/
│   └── main.js                     # Main actor script
├── storage/
│   └── datasets/default/           # Generated datasets
├── package.json                    # Dependencies
└── README.md                       # This file

🤝 Support

For issues, questions, or feature requests, please refer to the Apify documentation or contact support.