{ "openapi": "3.0.1", "info": { "title": "Flipkart Product Scraper — Prices, Specs, Ratings & Reviews", "description": "Scrape Flipkart product listings by keyword, category URL, or direct product URL. Get titles, prices, MRP, discounts, ratings, key specs, images, availability, warranty, and full product details with specifications, seller info, offers, and variants. JSON or CSV out.", "version": "0.0", "x-build-id": "mGu6ojGvg1DyRErG9" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/memo23~flipkart-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-memo23-flipkart-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/memo23~flipkart-scraper/runs": { "post": { "operationId": "runs-sync-memo23-flipkart-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/memo23~flipkart-scraper/run-sync": { "post": { "operationId": "run-sync-memo23-flipkart-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", "properties": { "keyword": { "title": "Search keyword", "type": "string", "description": "Keyword to search Flipkart for, e.g. 'mobile' or 'wireless earbuds'. Used when startUrls is empty. Keyword takes priority over startUrls for listing pages.", "default": "wireless earbuds" }, "startUrls": { "title": "Flipkart URLs", "type": "array", "description": "One or more Flipkart URLs: product detail pages (e.g. https://www.flipkart.com/poco-x8-5g-frost-white-128-gb/p/itm...), search result pages, or category pages. Product URLs are scraped directly; listing URLs are paginated.", "default": [], "items": { "type": "string" } }, "sort": { "title": "Order of keyword results", "enum": [ "relevance", "popularity", "newest", "price_asc", "price_desc" ], "type": "string", "description": "How Flipkart orders the products of a keyword search, the same choices as its sort menu. relevance (default) is Flipkart's own order. Product and category links keep the order they already have.", "default": "relevance" }, "maxItems": { "title": "Max products", "minimum": 0, "type": "integer", "description": "Maximum number of products to return. Set to 0 for unlimited. Free plan: 5 per run.", "default": 100 }, "maxPages": { "title": "Max pages", "minimum": 0, "type": "integer", "description": "Maximum listing pages to fetch (24 products per page). 0 = no page limit; maxItems still applies.", "default": 0 }, "fetchDetails": { "title": "Fetch full details", "type": "boolean", "description": "Visit each product's detail page to fill description, highlights, full specifications, seller name and rating, offers, and variants. One extra request per product, so runs are slower. Charged as an extra event per product that gets details.", "default": false }, "fetchReviews": { "title": "Fetch product reviews", "type": "boolean", "description": "After collecting products, scrape customer reviews for each one. Reviews are pushed to the same dataset with a 'type' field set to 'review'. Each review includes author, rating, title, text, date, location, helpful votes, and images. Charged per review as a dataset item.", "default": false }, "maxReviewsPerProduct": { "title": "Max reviews per product", "minimum": 0, "type": "integer", "description": "Maximum number of reviews to collect per product. Reviews are paginated (10 per page). 0 = no limit.", "default": 50 }, "maxReviewPages": { "title": "Max review pages per product", "minimum": 0, "type": "integer", "description": "Safety cap for review pagination per product. 10 reviews per page. Increase for products with many reviews.", "default": 20 }, "proxy": { "title": "Proxy", "type": "object", "description": "Default: Apify Residential. Flipkart throttles requests from datacenter addresses, so runs without a residential proxy tend to come back short or empty. Swap in your own proxy URLs if you have residential ones.", "default": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] } } } }, "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 }, "PROXY_UNBLOCKER_UNITS": { "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 }, "PROXY_UNBLOCKER_UNITS": { "type": "integer", "example": 0 } } } } } } } } } }