{ "openapi": "3.0.1", "info": { "title": "Flipkart Product Price & Specs Scraper", "description": "Pull Flipkart products by keyword, category URL or exact product link, with current price, original MRP, discount percentage, rating, key specifications and seller name. Filter by price range and minimum rating.", "version": "2.0", "x-build-id": "gjSnDGaHdVZmVZwuO" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/nimbryxo-studio~flipkart-product-price-and-specs-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-nimbryxo-studio-flipkart-product-price-and-specs-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/nimbryxo-studio~flipkart-product-price-and-specs-scraper/runs": { "post": { "operationId": "runs-sync-nimbryxo-studio-flipkart-product-price-and-specs-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/nimbryxo-studio~flipkart-product-price-and-specs-scraper/run-sync": { "post": { "operationId": "run-sync-nimbryxo-studio-flipkart-product-price-and-specs-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": "Mode", "enum": [ "search", "byCategory", "byUrl" ], "type": "string", "description": "How to find products on Flipkart.", "default": "search" }, "searchQuery": { "title": "Search Query", "type": "string", "description": "Keyword(s) to search on Flipkart. (mode=search)" }, "categoryUrl": { "title": "Category URL", "type": "string", "description": "Full Flipkart category or browse URL, e.g. https://www.flipkart.com/laptops/pr?sid=6bo%2Cb5g (mode=byCategory)" }, "startUrls": { "title": "Product URLs", "type": "array", "description": "Flipkart product URLs. (mode=byUrl)", "items": { "type": "object", "properties": { "url": { "title": "URL", "type": "string", "description": "Flipkart product URL." } } }, "default": [] }, "productIds": { "title": "Product IDs", "type": "array", "description": "Flipkart product IDs (the pid from a URL) or product URLs. (mode=byUrl)", "default": [], "items": { "type": "string" } }, "sortBy": { "title": "Sort By", "enum": [ "relevance", "popularity", "price_asc", "price_desc", "recency_desc" ], "type": "string", "description": "Sort order for search/category results.", "default": "relevance" }, "minPrice": { "title": "Minimum Price (INR)", "minimum": 0, "maximum": 10000000, "type": "integer", "description": "Minimum price filter in Indian Rupees." }, "maxPrice": { "title": "Maximum Price (INR)", "minimum": 0, "maximum": 10000000, "type": "integer", "description": "Maximum price filter in Indian Rupees." }, "minRating": { "title": "Minimum Rating", "minimum": 1, "maximum": 5, "type": "number", "description": "Minimum product rating (1.0-5.0)." }, "brand": { "title": "Brand", "type": "string", "description": "Only products from this brand, e.g. Samsung. Use the exact brand name shown on Flipkart." }, "minDiscount": { "title": "Minimum Discount", "enum": [ "0", "10", "20", "30", "40", "50" ], "type": "string", "description": "Only products with at least this discount percentage.", "default": "0" }, "fAssuredOnly": { "title": "Flipkart Assured Only", "type": "boolean", "description": "Only products marked Flipkart Assured.", "default": false }, "includeDetails": { "title": "Include Full Product Details", "type": "boolean", "description": "Open each product page for specifications, variants, offers, seller, images and warranty. Product URLs and IDs always return full details.", "default": true }, "includeReviews": { "title": "Include Reviews", "type": "boolean", "description": "Add buyer review records for each product.", "default": false }, "maxReviewsPerProduct": { "title": "Max Reviews per Product", "minimum": 0, "maximum": 200, "type": "integer", "description": "Maximum reviews to collect per product when reviews are enabled.", "default": 20 }, "reviewsSort": { "title": "Reviews Sort", "enum": [ "MOST_HELPFUL", "MOST_RECENT", "POSITIVE_FIRST", "NEGATIVE_FIRST" ], "type": "string", "description": "Order of buyer reviews.", "default": "MOST_HELPFUL" }, "certifiedBuyersOnly": { "title": "Certified Buyers Only", "type": "boolean", "description": "Only reviews marked as certified buyer.", "default": false }, "maxItems": { "title": "Max Items", "minimum": 1, "maximum": 500, "type": "integer", "description": "Maximum number of products to scrape (1-500).", "default": 50 }, "maxPages": { "title": "Max Pages", "minimum": 1, "maximum": 30, "type": "integer", "description": "Maximum search/category result pages to read (1-30).", "default": 30 } } }, "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 } } } } } } } } } }