Flipkart Product Scraper

Flipkart Product Scraper creates a structured dataset of products collected from Flipkart. Each dataset item represents one product and can include identifiers, brand, listing title, price and MRP, discount percent, currency, rating, stock status, key specifications, and optional product-page details plus nested customer reviews. Query the source with Flipkart page URLs (startUrls), preset categories, or searchQueries. Control the result limit with maxItems, and retrieve records through the Apify Dataset API or export them as JSON, CSV, Excel, XML, or another supported format.

Dataset at a glance

Property	Value
Source	flipkart.com
Record unit	One Flipkart product, with optional nested reviews
Input methods	startUrls, categories, and/or searchQueries
Main identifiers	productId (recommended), url
Delivery	Apify Dataset and API
Export formats	JSON, CSV, Excel, XML, HTML (Apify dataset exports)
Update model	Fresh records per Actor run
Pricing	Pay-per-event: $0.002 per product (dataset-item); +$0.002 per product for details; +$0.002 per review

Coverage and available records

The Actor collects products from public Flipkart listing, search, and product pages. The three input methods can be combined in one run. At least one is required:

• URL-based: Pass Flipkart category, search, or product page URLs in startUrls (for example https://www.flipkart.com/televisions/pr?sid=ckf,czl or a /p/ product URL).
• Category-based: Select one or more values from the 15-value categories enum. Each value maps to a preset Flipkart browse section (see the input table).
• Search-based: Pass free-text terms in searchQueries (for example samsung tv). No Flipkart URL is required.

Record types and limits:

• Listing-level records are always collected when Flipkart returns a product card or a resolvable product URL: identifiers, name, brand, price, MRP, discount, currency, rating aggregates, stock flag, category, key specs, and source metadata.
• Product detail fields are conditional: description, highlights, features, offers, imageUrls, parameterRatings, and ratingBreakdown appear only when includeProductDetails is enabled.
• Review records are conditional: a reviews array is nested on the product only when includeReviews is enabled. maxReviews caps reviews per product (0 requests all available reviews, hard-capped at 10,000).
• Result cap: maxItems limits products across all seeds (0 means unlimited, the default). Listing pagination stops at 500 pages per seed.

Known exclusions: login-only Flipkart content is not collected; each run captures page state at run time (no historical snapshots); categories outside the enum require a Flipkart URL in startUrls.

Data dictionary

Field names below match dataset record JSON properties exactly. Fields marked conditional appear only when the corresponding input toggle is enabled.

Listing fields

Field	Type	Nullable	Description	Example
productId	string	No	Flipkart product identifier (pid); best stable deduplication key	SHTGNEFMQYHFHXYG
itemId	string	Yes	Item id from the product path (itm…)	itm8db046dcd06e5
listingId	string	Yes	Flipkart listing id when present on the card or URL (lid)	—
name	string	No	Product title	RED TAPE Men Solid Casual Pink Shirt
brand	string	Yes	Brand name	RED TAPE
subtitle	string	Yes	Secondary listing title	Men Regular Fit Solid Button Down Collar Casual Shirt
url	string	No	Product page URL	https://www.flipkart.com/.../p/itm8db046dcd06e5?pid=SHTGNEFMQYHFHXYG
imageUrl	string	Yes	Primary listing image URL	—
price	number	Yes	Current selling price	776.0
mrp	number	Yes	Maximum retail price	4299.0
discountPercent	number	Yes	Discount versus MRP, as a percent	81.0
currency	string	No	ISO currency code for price and mrp	INR
rating	number	Yes	Average customer rating as shown on Flipkart	4.0
ratingCount	integer	Yes	Number of ratings	9236
reviewCount	integer	Yes	Number of reviews	531
inStock	boolean	Yes	Whether the listing is in stock	true
category	string	Yes	Flipkart category label	MensTopwear
subCategory	string	Yes	Flipkart subcategory label	MensShirt
keySpecs	string[]	Yes	Short specification lines from the listing	["Pack of: 1", "Fabric: Cotton Linen"]
sourceType	string	No	Seed that produced the record: search, category, or product	category
sourceQuery	string	Yes	Search term, category label, or product id used as the seed	clothing and accessories
sourceUrl	string	Yes	Seed URL that produced the record	https://www.flipkart.com/clothing-and-accessories/topwear/shirts/pr?sid=clo,ash,axc

Product detail fields (conditional — includeProductDetails)

Field	Type	Nullable	Description	Example
description	string	Yes	Product description text from the product page	—
highlights	string[]	Yes	Highlight lines from the product page	["Pack of: 1", "Fabric: Cotton Linen"]
features	object[]	Yes	Specification rows: {title, description}	—
offers	object[]	Yes	Active offers: {title, value, type}	{"title": "Buy at ₹623", "type": "BANK_TAB"}
imageUrls	string[]	Yes	Product image URLs	—
parameterRatings	object[]	Yes	Aspect ratings: {parameter, rating}	—
ratingBreakdown	object[]	Yes	Star-count histogram: {stars, count}	{"stars": 5, "count": 4659}

Review fields (conditional — includeReviews)

Each product record may include a reviews array. One review object:

Field	Type	Nullable	Description	Example
id	string	Yes	Flipkart review identifier	—
title	string	Yes	Review title	Excellent
text	string	Yes	Review body	Best Quality...
rating	integer	Yes	Star rating on the review	5
author	string	Yes	Reviewer name	vaibhav nikam
certifiedBuyer	boolean	No	Whether Flipkart marks the reviewer a certified buyer	true
created	string	Yes	Review date as rendered on Flipkart	—
location	string	Yes	Reviewer city and state	Kolhapur, Maharashtra
helpfulCount	integer	Yes	Helpful-vote count	37
upvotes	integer	Yes	Upvote count	—
downvotes	integer	Yes	Downvote count	—
imageUrls	string[]	Yes	Reviewer-uploaded image URLs	—

Example dataset record

Real record produced from the men's shirts category URL with product details and reviews enabled. The reviews and ratingBreakdown arrays are truncated to one and two items for readability.

{
  "productId": "SHTGNEFMQYHFHXYG",
  "itemId": "itm8db046dcd06e5",
  "name": "RED TAPE Men Solid Casual Pink Shirt",
  "brand": "RED TAPE",
  "subtitle": "Men Regular Fit Solid Button Down Collar Casual Shirt",
  "url": "https://www.flipkart.com/red-tape-men-solid-casual-pink-shirt/p/itm8db046dcd06e5?pid=SHTGNEFMQYHFHXYG",
  "price": 776.0,
  "mrp": 4299.0,
  "discountPercent": 81.0,
  "currency": "INR",
  "rating": 4.0,
  "ratingCount": 9236,
  "reviewCount": 531,
  "inStock": true,
  "keySpecs": ["Pack of: 1", "Fabric: Cotton Linen", "Sleeve: Full Sleeve", "Pattern: Solid"],
  "category": "MensTopwear",
  "subCategory": "MensShirt",
  "sourceType": "category",
  "sourceQuery": "clothing and accessories",
  "sourceUrl": "https://www.flipkart.com/clothing-and-accessories/topwear/shirts/pr?sid=clo,ash,axc",
  "highlights": ["Pack of: 1", "Fabric: Cotton Linen", "Sleeve: Full Sleeve", "Pattern: Solid"],
  "offers": [{ "title": "Buy at ₹623", "type": "BANK_TAB" }],
  "ratingBreakdown": [
    { "stars": 1, "count": 941 },
    { "stars": 5, "count": 4659 }
  ],
  "reviews": [
    {
      "title": "Excellent",
      "text": "Best Quality...",
      "rating": 5,
      "author": "vaibhav nikam",
      "certifiedBuyer": true,
      "location": "Kolhapur, Maharashtra",
      "helpfulCount": 37
    }
  ]
}

The record above was produced with this input:

{
  "startUrls": [
    { "url": "https://www.flipkart.com/clothing-and-accessories/topwear/shirts/pr?sid=clo,ash,axc" }
  ],
  "maxItems": 5,
  "includeProductDetails": true,
  "includeReviews": true,
  "maxReviews": 5,
  "detailConcurrency": 3,
  "proxyConfiguration": {
    "useApifyProxy": true,
    "apifyProxyGroups": ["RESIDENTIAL"]
  }
}

Query and input reference

Input	Type	Required	Default	Accepted values	Description
startUrls	array (requestListSources)	No*	—	Flipkart category, search, or product URLs	URL-based entry point. Combined with categories and search queries when those are also set
categories	string[]	No*	—	mobiles · laptops · televisions · headphones · mens-shirts · womens-sarees · womens-heels · mens-sports-shoes · watches · refrigerators · washing-machines · air-conditioners · microwave-ovens · books · beauty-and-grooming	Preset Flipkart browse sections
searchQueries	string[]	No*	—	Free-text search terms (e.g. samsung tv)	Product search terms; no URL required
maxItems	integer	No	0	0 or any positive integer	Maximum products across all seeds; 0 = unlimited
includeProductDetails	boolean	No	false	true / false	Collect detail fields (charged as product-details)
includeReviews	boolean	No	false	true / false	Collect nested reviews (charged as product-reviews once per review)
maxReviews	integer	No	10	0 or any positive integer	Reviews per product when includeReviews is enabled; 0 = all available (hard-capped at 10,000)
detailConcurrency	integer	No	5	1–15	Parallel workers used when details or reviews are enabled
proxyConfiguration	object	No	Apify proxy, RESIDENTIAL group	Apify proxy groups or custom proxies	Residential proxies are recommended for reliable Flipkart access

* Provide at least one of startUrls, categories, or searchQueries.

Minimal request:

{ "searchQueries": ["samsung tv"], "maxItems": 10 }

Advanced request (combined seeds with enrichment):

{
  "startUrls": [{ "url": "https://www.flipkart.com/clothing-and-accessories/topwear/shirts/pr?sid=clo,ash,axc" }],
  "categories": ["mobiles", "laptops"],
  "searchQueries": ["samsung tv"],
  "maxItems": 200,
  "includeProductDetails": true,
  "includeReviews": true,
  "maxReviews": 10,
  "detailConcurrency": 5,
  "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": ["RESIDENTIAL"] }
}

Retrieve the data through the API

The Actor runs on the Apify platform. This is the Apify Actor API, not an official Flipkart API.

1. Start the Actor with a JSON input (console or API).
2. Wait for the run to finish, or use a synchronous endpoint if you want the response inline.
3. Retrieve items from the run's default dataset.
4. Paginate or export the dataset.

Python example:

from apify_client import ApifyClient

client = ApifyClient("YOUR-APIFY-TOKEN")

run_input = {
    "searchQueries": ["samsung tv"],
    "maxItems": 10,
    "includeProductDetails": True,
}

run = client.actor("datascrapers/flipkart-scraper").call(run_input=run_input)
for item in client.dataset(run["defaultDatasetId"]).iterate_items():
    print(item["productId"], item["name"], item["price"])

Apify generates ready-to-run Python, JavaScript, and cURL examples on the Actor's API tab. Do not put a real API token in shared code or URLs.

Data quality and record handling

• Conditional fields: detail and review fields appear only when their input toggle is enabled. Listing-only runs return a leaner record.
• Source changes: Flipkart values can change; unreadable fields are omitted or returned as null rather than fabricated.
• Deduplication: within a run, products are de-duplicated by productId. Across runs, use productId (or url) as the external key.
• Partial enrichment: a failed details or reviews fetch does not drop the listing record.
• Charges: the Actor stops when a spending limit is reached (see run log). Prices, discounts, and rating aggregates are read from Flipkart and stored as the types in the data dictionary. currency is typically INR.

Export and pipeline examples

Destination	Recommended method	Typical use
PostgreSQL / Supabase	Dataset API poll or webhook consumer	Store catalog prices alongside inventory or PIM records
Google Sheets	Apify Google Sheets integration	Share shortlists for price monitoring
S3 / cloud storage	Scheduled export via Apify scheduler + integration	Archival of marketplace snapshots

Pricing and cost examples

The Actor uses pay-per-event pricing. Event rates are tiered by Apify plan. Listed amounts are the base rates:

Event	Trigger	Rate
Actor start	Once per run	$0.00005
dataset-item	Every product record pushed to the dataset	$0.002 per product ($2.00 per 1,000)
product-details	includeProductDetails enabled, details collected	$0.002 per product ($2.00 per 1,000)
product-reviews	includeReviews enabled, once per review collected	$0.002 per review ($2.00 per 1,000)

Example costs (Actor start omitted; it is $0.00005):

Records	Configuration	Estimated base cost
1,000	Listing only	$2.00
10,000	Listing only	$20.00
1,000	Listing + product details	$4.00
1,000	Listing + 10 reviews each	$22.00
1,000	Listing + details + 10 reviews each	$24.00

Apify paid plans reduce event rates. Compute units and proxy usage are billed by your Apify plan. Estimates depend on the verified pricing model and the options selected for the run.

Limitations and responsible data use

• The Actor collects publicly accessible data from Flipkart pages only.
• Field availability depends on what Flipkart renders at run time; some values can be null or missing, and site changes can alter fields.
• Listing pagination is capped at 500 pages per seed. Reviews requested as “all” are hard-capped at 10,000 per product.
• The Actor does not provide historical snapshots unless you store them yourself.
• Residential proxies are recommended; coverage may degrade without them.
• You are responsible for compliance with Flipkart's terms of service, applicable privacy law, and any contractual obligations before using the data.

Dataset questions

What does one dataset item represent?

One Flipkart product. Review records are nested inside the product as a reviews array, so a product with 50 reviews still produces a single dataset item.

Which field should I use as a unique identifier?

productId is the stable Flipkart product identifier and is the recommended deduplication key. url is a reasonable secondary key.

Are fields nullable or conditional?

Yes. Detail fields exist only when includeProductDetails is enabled; reviews exists only when includeReviews is enabled. Fields Flipkart does not render are returned as null or omitted.

Can I retrieve the records as CSV or JSON?

Yes. Export JSON, CSV, Excel, XML, or HTML from the Apify Console, or query the Dataset API.

How do I query by category or search term?

Set categories to one or more enum values (for example mobiles) or searchQueries to free-text terms (for example samsung tv). You can also pass Flipkart URLs in startUrls. All three can be combined; maxItems applies across them.

Does the Actor return historical data?

No. Each run captures page state at run time. Schedule repeated runs and store outputs to track price or rating changes.

What counts as a billable result?

Actor start once per run ($0.00005); dataset-item for every product ($0.002); product-details when details are collected ($0.002 per product); and product-reviews for each review ($0.002). A listing-only run incurs Actor start plus dataset-item only.

Related datasets from Data Scrapers

• Amazon Search Scraper — Marketplace product records joinable by title or brand for cross-retailer price comparison.
• Best Buy Product Scraper — Electronics listings for the same price-monitoring pipelines as Flipkart mobiles, laptops, and televisions.
• Etsy Scraper — Product listings with shop and price fields for catalog research alongside Flipkart apparel.
• Costco Product Scraper — Warehouse-club product and discount records for multi-retailer pricing analysis.

Data Scrapers support

Need an additional field, record type, or export workflow? Contact Data Scrapers at stardustspotlight@gmail.com. Include a sample source URL, required fields, expected record volume, and preferred delivery format.