🛒 Flipkart Product Scraper - API Based

This Apify actor retrieves product data directly through the Flipkart API. Search by keyword or category URL to collect structured product information including name, brand, price, MRP, discount, ratings, reviews, specifications, and images. Perfect for e-commerce research, price monitoring, and market analysis.

✅ Use Cases

• 📊 Monitor competitor pricing and discounts
• 🔍 Track product availability and ratings
• 📈 Conduct e-commerce market research
• 💰 Build price comparison databases
• 📋 Generate product catalogs with specifications

📥 Input Configuration

You can customize the actor using the following input fields:

{
    "searchQuery": "iPhone 15",
    "categoryUrl": "",
    "maxProducts": 50,
    "minPrice": 0,
    "maxPrice": 100000,
    "minRating": 4,
    "sortBy": "relevance"
}

🧾 Fields Explained

Field	Type	Description
searchQuery	string	Search term to query Flipkart products (e.g., "iPhone 15", "Samsung TV")
categoryUrl	string	Direct Flipkart category or search URL. If provided, searchQuery is ignored
maxProducts	number	Maximum number of products to retrieve (1-500)
minPrice	number	Minimum price filter in INR. Set to 0 for no minimum
maxPrice	number	Maximum price filter in INR. Set to 0 for no maximum
minRating	number	Minimum star rating (0-5) to include products
sortBy	string	Sort order: "relevance", "popularity", "price_asc", "price_desc", "recency", "rating"

📤 Output

The actor returns a dataset containing structured product records. Each record includes comprehensive details about the product, suitable for price monitoring, analytics, and market research.

🧩 Sample Output

{
    "widget_id": 8001000,
    "product_id": "MOBGTAGPNRHX7K3H",
    "brand": "APPLE",
    "title": "iPhone 15 (Blue, 128 GB)",
    "subtitle": "128 GB ROM, 6.1 inch Display, 48MP + 12MP Camera",
    "price": 69999,
    "mrp": 79900,
    "discount": 12,
    "rating": 4.6,
    "rating_count": 12453,
    "key_specs": [
        "128 GB ROM",
        "15.49 cm (6.1 inch) Super Retina XDR Display",
        "48MP + 12MP | 12MP Front Camera",
        "A16 Bionic Chip Processor"
    ],
    "min_key_specs": ["6.1 inch Display", "48MP Camera"],
    "warranty": "1 Year Manufacturer Warranty",
    "availability": "In Stock",
    "listing_id": "LSTMOBGTAGPNRHX7K3HXYZABC",
    "item_id": "ITMGTAGPNRHX7K3H",
    "tags": ["Bestseller", "Top Rated"],
    "image_urls": [
        "https://rukminim2.flixcart.com/image/416/416/xif0q/mobile/..."
    ]
}

📋 Output Fields

Field	Type	Description
widget_id	integer	Widget ID from Flipkart API
product_id	string	Unique product identifier
brand	string	Product brand name
title	string	Product title
subtitle	string	Product subtitle with key specs
price	number	Final selling price in INR
mrp	number	Maximum retail price in INR
discount	number	Discount percentage
rating	number	Average product rating (0-5)
rating_count	integer	Number of ratings
key_specs	array	Key product specifications
min_key_specs	array	Minimum key specifications
warranty	string	Warranty information
availability	string	Product availability status
listing_id	string	Unique listing identifier
item_id	string	Item identifier
tags	array	Product tags (Bestseller, etc.)
image_urls	array	Product image URLs

🔍 Data Source

• ✓ Data fetched exclusively via Flipkart API (HTTP POST requests)
• ✓ No HTML scraping or DOM parsing
• ✓ Real-time product 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 your search query or category URL
4. Configure optional filters (price range, minimum rating)
5. Run the actor
6. Download results in JSON, CSV, or Excel format

⚙️ Advanced Input Example

{
    "searchQuery": "smartphones",
    "categoryUrl": "",
    "maxProducts": 100,
    "minPrice": 10000,
    "maxPrice": 50000,
    "minRating": 4,
    "sortBy": "popularity"
}

🛠️ 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 product information

📊 Data Processing Features

• ✓ Automatic duplicate detection using Product IDs
• ✓ Filtering by price range and minimum rating
• ✓ Structured data parsing and normalization
• ✓ Comprehensive logging and error handling
• ✓ Schema validation for all output records
• ✓ Pagination support for large result sets

🔧 Local Development

Installation

$npm install

Running the Actor

$npm start

Validation

Validate all generated datasets against the schema:

$node validate-datasets.js

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
├── validate-datasets.js            # Dataset validator
└── README.md                       # This file

🤝 Support

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