# Flipkart Product Scraper (`codingfrontend/flipkart-product-scraper`) Actor

An advanced, high-speed e-commerce scraper designed for real-time price monitoring and competitor intelligence. Extracts product titles, current pricing, discounts, stock availability, specifications, images, and seller ratings from Flipkart Product. Perfect for inventory tracking, drop-shipping ...

- **URL**: https://apify.com/codingfrontend/flipkart-product-scraper.md
- **Developed by:** [codingfrontend](https://apify.com/codingfrontend) (community)
- **Categories:** E-commerce, Automation
- **Stats:** 2 total users, 1 monthly users, 0.0% runs succeeded, NaN bookmarks
- **User rating**: No ratings yet

## Pricing

from $4.99 / 1,000 results

This Actor is paid per event and usage. You are charged both the fixed price for specific events and for Apify platform usage.

Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event

## What's an Apify Actor?

Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.
Actors are written with capital "A".

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.
The best way to integrate Actors is as follows.

In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md):

```bash
npm install apify-client
```

In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md):

```bash
pip install apify-client
```

In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md):

````bash
# MacOS / Linux
curl -fsSL https://apify.com/install-cli.sh | bash
# Windows
irm https://apify.com/install-cli.ps1 | iex
```bash

In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md).

If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md).

For usage examples, see the [API](#api) section below.

For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt).


# README

## Flipkart Product Scraper

Scrape products from Flipkart.com by search query, keyword, direct product URL, search results URL, or category URL. Extracts comprehensive product data including pricing, ratings, reviews, images, and seller info.

### Features

- **4 input modes** — search query, product URL, search results URL, category URL
- **Rich product details** — title, brand, SKU, pricing, discount %, ratings, reviews, images
- **Seller info** — seller name, rating, COD availability, return policy
- **Delivery data** — estimated delivery time and SLA details
- **Offers & EMI** — bank offers, no-cost EMI, exchange offers
- **Anti-detection** — stealth mode, user-agent rotation, residential proxy support
- **Pagination** — automatically follows next pages until `maxItems` is reached

### Input

| Field | Type | Description | Default |
|---|---|---|---|
| `mode` | string | `search`, `productUrl`, `searchUrl`, or `categoryUrl` | `search` |
| `searchQuery` | string | Search keyword (used when mode = `search`) | — |
| `productUrl` | string | Direct product page URL (mode = `productUrl`) | — |
| `searchUrl` | string | Full search results URL (mode = `searchUrl`) | — |
| `categoryUrl` | string | Flipkart category page URL (mode = `categoryUrl`) | — |
| `maxItems` | integer | Maximum products to scrape | 50 |
| `sortBy` | string | `relevance`, `popularity`, `price_asc`, `price_desc`, `recency_desc` | `relevance` |
| `minPrice` | integer | Minimum price filter (INR) | — |
| `maxPrice` | integer | Maximum price filter (INR) | — |
| `flipkartAssured` | boolean | Only Flipkart Assured products | false |
| `proxyConfiguration` | object | Proxy settings (residential recommended) | RESIDENTIAL |

#### Example — Search Query

```json
{
  "mode": "search",
  "searchQuery": "smartphone under 20000",
  "maxItems": 50,
  "sortBy": "popularity",
  "maxPrice": 20000,
  "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": ["RESIDENTIAL"], "apifyProxyCountry": "IN" }
}
````

#### Example — Product URL

```json
{
  "mode": "productUrl",
  "productUrl": "https://www.flipkart.com/apple-iphone-15-black-128-gb/p/itm6ac6485515ae4",
  "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": ["RESIDENTIAL"] }
}
```

#### Example — Category URL

```json
{
  "mode": "categoryUrl",
  "categoryUrl": "https://www.flipkart.com/mobiles/pr?sid=tyy,4io&sort=popularity_desc",
  "maxItems": 100,
  "sortBy": "popularity",
  "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": ["RESIDENTIAL"] }
}
```

### Output

#### Product Detail Mode Output (`productUrl`)

```json
{
  "meta": { "scrapedAt": "2026-05-11T09:00:00.000Z", "source": "jsonld" },
  "product": {
    "platform": "flipkart",
    "title": "Apple iPhone 15 (Black, 128 GB)",
    "brand": "APPLE",
    "color": "Black",
    "sku": "MOBGTAGPTB3VS24W",
    "category": { "path": "mobile" }
  },
  "pricing": { "finalPrice": 54900, "currency": "INR", "availability": "In Stock" },
  "ratings": { "average": 4.6, "ratingsCount": 245167, "reviewsCount": 9198 },
  "media": { "images": ["https://rukmini1.flixcart.com/image/..."] },
  "reviews": [
    { "author": "John", "date": "2025-01-26", "title": "Great!", "body": "Awesome phone", "rating": 5 }
  ],
  "url": "https://www.flipkart.com/apple-iphone-15-black-128-gb/p/itm6ac6485515ae4"
}
```

#### Search/Category/Listing Mode Output

```json
{
  "title": "Samsung Galaxy M15 5G (Stone Grey, 6 GB RAM, 128 GB Storage)",
  "price": "₹13,999",
  "originalPrice": "₹18,999",
  "discount": "26% off",
  "rating": "4.1",
  "ratingCount": 11234,
  "reviewCount": 890,
  "productId": "itm...",
  "url": "https://www.flipkart.com/samsung-galaxy-m15-5g/p/...",
  "imageUrl": "https://rukminim2.flixcart.com/...",
  "isFlipkartAssured": false,
  "isSponsored": false,
  "seller": "RetailNet",
  "specifications": ["6 GB RAM", "128 GB Storage", "5G"],
  "deliveryInfo": "Free delivery",
  "exchangeOffer": "",
  "bankOffer": "10% off on SBI Cards"
}
```

### Proxy Recommendation

Flipkart has bot-detection. Residential proxies from India (`apifyProxyCountry: "IN"`) give the best results.

### Use Cases

- **Price monitoring** — track price changes over time
- **Competitive analysis** — compare products across sellers
- **Market research** — analyze product ratings, reviews, trending categories
- **inventory tracking** — monitor product availability

### Contact

For questions or custom scraping: **lakshmanan.w3dev@gmail.com**

- **E-commerce Intelligence**: Gather data for business decisions

### Custom Solutions

Need a custom scraper or dedicated server setup? We offer:

- **On-demand scraper development** for any website
- **Individual server setups** with your own infrastructure
- **Custom modifications** to existing scrapers
- **Priority support** and maintenance

📧 Email: lakshmanan.w3dev@gmail.com\
📱 WhatsApp: +91 6382775774

# Actor input Schema

## `mode` (type: `string`):

Choose how to provide input: search query, product URL, search results URL, or category URL.

## `searchQuery` (type: `string`):

Product search term, e.g. 'smartphone under 20000'. Used when mode is 'search'.

## `productUrl` (type: `string`):

Direct Flipkart product page URL. Used when mode is 'productUrl'. Example: https://www.flipkart.com/apple-iphone-15/p/itm...

## `searchUrl` (type: `string`):

Full Flipkart search results URL. Used when mode is 'searchUrl'.

## `categoryUrl` (type: `string`):

Flipkart category page URL. Used when mode is 'categoryUrl'. Example: https://www.flipkart.com/mobiles/pr?sid=tyy,4io

## `maxItems` (type: `integer`):

Maximum number of products to scrape.

## `sortBy` (type: `string`):

Sort order for search or category results.

## `minPrice` (type: `integer`):

Minimum price filter in INR. Only applied in search mode.

## `maxPrice` (type: `integer`):

Maximum price filter in INR. Only applied in search mode.

## `flipkartAssured` (type: `boolean`):

Filter to Flipkart Assured products only (fast shipping + easy return guarantee).

## `proxyConfiguration` (type: `object`):

Use Apify residential proxies from India for best results. Flipkart has strict bot detection.

## Actor input object example

```json
{
  "mode": "search",
  "maxItems": 50,
  "sortBy": "relevance",
  "flipkartAssured": false,
  "proxyConfiguration": {
    "useApifyProxy": true,
    "apifyProxyGroups": [
      "RESIDENTIAL"
    ],
    "apifyProxyCountry": "IN"
  }
}
```

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "mode": "search",
    "maxItems": 50,
    "sortBy": "relevance",
    "flipkartAssured": false
};

// Run the Actor and wait for it to finish
const run = await client.actor("codingfrontend/flipkart-product-scraper").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {
    "mode": "search",
    "maxItems": 50,
    "sortBy": "relevance",
    "flipkartAssured": False,
}

# Run the Actor and wait for it to finish
run = client.actor("codingfrontend/flipkart-product-scraper").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"])
for item in client.dataset(run["defaultDatasetId"]).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "mode": "search",
  "maxItems": 50,
  "sortBy": "relevance",
  "flipkartAssured": false
}' |
apify call codingfrontend/flipkart-product-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "command": "npx",
            "args": [
                "mcp-remote",
                "https://mcp.apify.com/?tools=codingfrontend/flipkart-product-scraper",
                "--header",
                "Authorization: Bearer <YOUR_API_TOKEN>"
            ]
        }
    }
}

```

## OpenAPI specification

```json
{
    "openapi": "3.0.1",
    "info": {
        "title": "Flipkart Product Scraper",
        "description": "An advanced, high-speed e-commerce scraper designed for real-time price monitoring and competitor intelligence. Extracts product titles, current pricing, discounts, stock availability, specifications, images, and seller ratings from Flipkart Product. Perfect for inventory tracking, drop-shipping ...",
        "version": "1.0",
        "x-build-id": "hGxHtzxiwLP3A0zSb"
    },
    "servers": [
        {
            "url": "https://api.apify.com/v2"
        }
    ],
    "paths": {
        "/acts/codingfrontend~flipkart-product-scraper/run-sync-get-dataset-items": {
            "post": {
                "operationId": "run-sync-get-dataset-items-codingfrontend-flipkart-product-scraper",
                "x-openai-isConsequential": false,
                "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.",
                "tags": [
                    "Run Actor"
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/inputSchema"
                            }
                        }
                    }
                },
                "parameters": [
                    {
                        "name": "token",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Enter your Apify token here"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK"
                    }
                }
            }
        },
        "/acts/codingfrontend~flipkart-product-scraper/runs": {
            "post": {
                "operationId": "runs-sync-codingfrontend-flipkart-product-scraper",
                "x-openai-isConsequential": false,
                "summary": "Executes an Actor and returns information about the initiated run in response.",
                "tags": [
                    "Run Actor"
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/inputSchema"
                            }
                        }
                    }
                },
                "parameters": [
                    {
                        "name": "token",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Enter your Apify token here"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/runsResponseSchema"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/acts/codingfrontend~flipkart-product-scraper/run-sync": {
            "post": {
                "operationId": "run-sync-codingfrontend-flipkart-product-scraper",
                "x-openai-isConsequential": false,
                "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.",
                "tags": [
                    "Run Actor"
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/inputSchema"
                            }
                        }
                    }
                },
                "parameters": [
                    {
                        "name": "token",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Enter your Apify token here"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK"
                    }
                }
            }
        }
    },
    "components": {
        "schemas": {
            "inputSchema": {
                "type": "object",
                "required": [
                    "mode"
                ],
                "properties": {
                    "mode": {
                        "title": "Input Mode",
                        "enum": [
                            "search",
                            "productUrl",
                            "searchUrl",
                            "categoryUrl"
                        ],
                        "type": "string",
                        "description": "Choose how to provide input: search query, product URL, search results URL, or category URL.",
                        "default": "search"
                    },
                    "searchQuery": {
                        "title": "Search Query",
                        "type": "string",
                        "description": "Product search term, e.g. 'smartphone under 20000'. Used when mode is 'search'."
                    },
                    "productUrl": {
                        "title": "Product URL",
                        "type": "string",
                        "description": "Direct Flipkart product page URL. Used when mode is 'productUrl'. Example: https://www.flipkart.com/apple-iphone-15/p/itm..."
                    },
                    "searchUrl": {
                        "title": "Search Results URL",
                        "type": "string",
                        "description": "Full Flipkart search results URL. Used when mode is 'searchUrl'."
                    },
                    "categoryUrl": {
                        "title": "Category URL",
                        "type": "string",
                        "description": "Flipkart category page URL. Used when mode is 'categoryUrl'. Example: https://www.flipkart.com/mobiles/pr?sid=tyy,4io"
                    },
                    "maxItems": {
                        "title": "Max Items",
                        "minimum": 1,
                        "maximum": 500,
                        "type": "integer",
                        "description": "Maximum number of products to scrape.",
                        "default": 50
                    },
                    "sortBy": {
                        "title": "Sort By",
                        "enum": [
                            "relevance",
                            "popularity",
                            "price_asc",
                            "price_desc",
                            "recency_desc"
                        ],
                        "type": "string",
                        "description": "Sort order for search or category results.",
                        "default": "relevance"
                    },
                    "minPrice": {
                        "title": "Minimum Price (₹)",
                        "minimum": 0,
                        "type": "integer",
                        "description": "Minimum price filter in INR. Only applied in search mode."
                    },
                    "maxPrice": {
                        "title": "Maximum Price (₹)",
                        "minimum": 0,
                        "type": "integer",
                        "description": "Maximum price filter in INR. Only applied in search mode."
                    },
                    "flipkartAssured": {
                        "title": "Flipkart Assured Only",
                        "type": "boolean",
                        "description": "Filter to Flipkart Assured products only (fast shipping + easy return guarantee).",
                        "default": false
                    },
                    "proxyConfiguration": {
                        "title": "Proxy Configuration",
                        "type": "object",
                        "description": "Use Apify residential proxies from India for best results. Flipkart has strict bot detection.",
                        "default": {
                            "useApifyProxy": true,
                            "apifyProxyGroups": [
                                "RESIDENTIAL"
                            ],
                            "apifyProxyCountry": "IN"
                        }
                    }
                }
            },
            "runsResponseSchema": {
                "type": "object",
                "properties": {
                    "data": {
                        "type": "object",
                        "properties": {
                            "id": {
                                "type": "string"
                            },
                            "actId": {
                                "type": "string"
                            },
                            "userId": {
                                "type": "string"
                            },
                            "startedAt": {
                                "type": "string",
                                "format": "date-time",
                                "example": "2025-01-08T00:00:00.000Z"
                            },
                            "finishedAt": {
                                "type": "string",
                                "format": "date-time",
                                "example": "2025-01-08T00:00:00.000Z"
                            },
                            "status": {
                                "type": "string",
                                "example": "READY"
                            },
                            "meta": {
                                "type": "object",
                                "properties": {
                                    "origin": {
                                        "type": "string",
                                        "example": "API"
                                    },
                                    "userAgent": {
                                        "type": "string"
                                    }
                                }
                            },
                            "stats": {
                                "type": "object",
                                "properties": {
                                    "inputBodyLen": {
                                        "type": "integer",
                                        "example": 2000
                                    },
                                    "rebootCount": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "restartCount": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "resurrectCount": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "computeUnits": {
                                        "type": "integer",
                                        "example": 0
                                    }
                                }
                            },
                            "options": {
                                "type": "object",
                                "properties": {
                                    "build": {
                                        "type": "string",
                                        "example": "latest"
                                    },
                                    "timeoutSecs": {
                                        "type": "integer",
                                        "example": 300
                                    },
                                    "memoryMbytes": {
                                        "type": "integer",
                                        "example": 1024
                                    },
                                    "diskMbytes": {
                                        "type": "integer",
                                        "example": 2048
                                    }
                                }
                            },
                            "buildId": {
                                "type": "string"
                            },
                            "defaultKeyValueStoreId": {
                                "type": "string"
                            },
                            "defaultDatasetId": {
                                "type": "string"
                            },
                            "defaultRequestQueueId": {
                                "type": "string"
                            },
                            "buildNumber": {
                                "type": "string",
                                "example": "1.0.0"
                            },
                            "containerUrl": {
                                "type": "string"
                            },
                            "usage": {
                                "type": "object",
                                "properties": {
                                    "ACTOR_COMPUTE_UNITS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_WRITES": {
                                        "type": "integer",
                                        "example": 1
                                    },
                                    "KEY_VALUE_STORE_LISTS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_INTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_EXTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_SERPS": {
                                        "type": "integer",
                                        "example": 0
                                    }
                                }
                            },
                            "usageTotalUsd": {
                                "type": "number",
                                "example": 0.00005
                            },
                            "usageUsd": {
                                "type": "object",
                                "properties": {
                                    "ACTOR_COMPUTE_UNITS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_WRITES": {
                                        "type": "number",
                                        "example": 0.00005
                                    },
                                    "KEY_VALUE_STORE_LISTS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_INTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_EXTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_SERPS": {
                                        "type": "integer",
                                        "example": 0
                                    }
                                }
                            }
                        }
                    }
                }
            }
        }
    }
}
```
