{ "openapi": "3.0.1", "info": { "title": "Flipkart Scraper — Products, Prices & Reviews (India)", "description": "Scrape Flipkart.com search results, category pages, product pages and reviews: price, MRP, discount, rating, seller, stock, Assured flag, specs. Any keyword or URL.", "version": "0.1", "x-build-id": "V20lgDbOIj7xMD17P" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/tortuga~flipkart-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-tortuga-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/tortuga~flipkart-scraper/runs": { "post": { "operationId": "runs-sync-tortuga-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/tortuga~flipkart-scraper/run-sync": { "post": { "operationId": "run-sync-tortuga-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": { "searchTerms": { "title": "Search terms", "type": "array", "description": "Keywords to search on Flipkart.com, one per line (e.g. \"headphones\", \"iphone 15\"). Each term is searched separately and paginated automatically: one request returns 40 products (24 for phones, laptops and other list-style categories).", "items": { "type": "string" } }, "startUrls": { "title": "Start URLs", "type": "array", "description": "Flipkart URLs instead of (or besides) search terms: search pages (https://www.flipkart.com/search?q=boat), category pages (https://www.flipkart.com/audio-video/headphones-earphones/pr?sid=0pm,fcn), product pages (…/p/itm…?pid=…, saved with full details) or review pages (…/product-reviews/itm…?pid=…, reviews only). Filters set on the site are kept: copy the URL from your browser.", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "maxItems": { "title": "Max items", "minimum": 1, "type": "integer", "description": "Stop after this many dataset items in total. Products and reviews both count, so with reviews on raise it accordingly (50 products with 20 reviews each = 1,050 items). Keeps cost predictable.", "default": 100 }, "maxPagesPerSearch": { "title": "Max pages per search", "minimum": 1, "maximum": 100, "type": "integer", "description": "How many result pages to open per search term or category URL (40 or 24 products each, one request per page). Flipkart stops serving results after a few dozen pages per query.", "default": 5 }, "sortBy": { "title": "Sort by", "enum": [ "relevance", "popularity", "price_asc", "price_desc", "recency_desc" ], "type": "string", "description": "Result order, as in Flipkart's own \"Sort By\" menu. Applies to search terms and to URLs that have no sort of their own.", "default": "relevance" }, "includeSponsored": { "title": "Include sponsored products", "type": "boolean", "description": "Flipkart mixes sponsored cards into the results (about a third of each page). They are saved with isSponsored = true. Turn this off to keep organic results only (recommended for monitoring: ads rotate between visits).", "default": true }, "includeDetails": { "title": "Include product details", "type": "boolean", "description": "Also open every product page for full specifications, description, product highlights, seller name / rating / scores, delivery estimate, return policy, warranty, manufacturer info, category path, aspect ratings and rating breakdown. One extra request and one extra `detail` charge per product.", "default": false }, "includeReviews": { "title": "Include reviews", "type": "boolean", "description": "Also collect customer reviews for every product, as separate items with type = \"review\" (rating, title, text, date, reviewer display name and city as shown, certified buyer flag, helpful votes, photos). Flipkart serves 10 reviews per request.", "default": false }, "maxReviewsPerProduct": { "title": "Max reviews per product", "minimum": 1, "type": "integer", "description": "Cap on reviews per product (also applies to review-page start URLs).", "default": 20 }, "reviewSort": { "title": "Sort reviews", "enum": [ "helpful", "newest", "positive", "negative" ], "type": "string", "description": "Order in which reviews are collected (matters when a cap is set), as on Flipkart's review page. \"Latest\" is best for monitoring; \"Negative first\" surfaces complaints.", "default": "helpful" }, "reviewsNewerThan": { "title": "Only reviews newer than", "type": "string", "description": "Only reviews newer than: a date (YYYY-MM-DD) or a period such as '7 days' or '24 hours'. Reviews are then read latest first and reading stops at the first review page that is entirely older. Flipkart dates reviews as '3 days ago' / 'Jun, 2025', so the cut is day- or month-accurate. Applies when reviews are collected." }, "onlyNewOrChanged": { "title": "Only new or changed items", "type": "boolean", "description": "Remember what earlier runs of this search returned and output only new items or items whose price/status changed. Use with a Schedule; unchanged items are not charged. Price, MRP and stock status are compared (with reviews on, the review count too, and only unseen reviews are output). Max items is then the watched window: the first products of the listing.", "default": false }, "monitoringKey": { "title": "Monitoring key", "type": "string", "description": "Name for this watch, so several schedules on the same search stay separate; defaults to a key derived from the search input." }, "proxyConfiguration": { "title": "Proxy", "type": "object", "description": "Flipkart serves its pages to Apify's datacenter proxy (the default), so no residential or Unblocker traffic is needed. Each request loads one search page (24-40 products), one product page or 10 reviews; failed requests are retried on a new IP.", "default": { "useApifyProxy": true } } } }, "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 } } } } } } } } } }