{ "openapi": "3.0.1", "info": { "title": "Flipkart Scraper - Prices, Ratings & Offers from Search", "description": "Scrape Flipkart search and category results: price, MRP, discount, rating, review counts, F-Assured, sponsored flag, offers and key specs. Optional product details (seller, specs, variants, delivery). Price-change and new-product monitoring. No login.", "version": "0.1", "x-build-id": "JQ3vFS343PJIiD2R4" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/rjmacarthy~flipkart-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-rjmacarthy-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/rjmacarthy~flipkart-scraper/runs": { "post": { "operationId": "runs-sync-rjmacarthy-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/rjmacarthy~flipkart-scraper/run-sync": { "post": { "operationId": "run-sync-rjmacarthy-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": { "searchQueries": { "title": "Search queries", "type": "array", "description": "One Flipkart search per line, as typed into the Flipkart search box (e.g. \"wireless earbuds\", \"samsung galaxy s24\", \"running shoes for men\").", "items": { "type": "string" } }, "startUrls": { "title": "Flipkart URLs", "type": "array", "description": "Optional. Any Flipkart search URL (https://www.flipkart.com/search?q=...), category URL (https://www.flipkart.com/mobiles/pr?sid=tyy,4io, filters included) or product URL (https://www.flipkart.com/.../p/itm...?pid=...). Product URLs always get full product details (charged as product-details).", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "maxItems": { "title": "Max products", "minimum": 0, "type": "integer", "description": "Maximum number of products to output in total for the whole run (0 = no limit). In monitor mode (track price changes / only new) it is the number of top results CHECKED per run instead, so each run watches the same products.", "default": 100 }, "maxPagesPerQuery": { "title": "Max pages per query/URL", "minimum": 0, "maximum": 100, "type": "integer", "description": "How many result pages to read per search query or listing URL (24-40 products per page). 0 = until the results end.", "default": 5 }, "sort": { "title": "Sort by", "enum": [ "relevance", "popularity", "price_asc", "price_desc", "recency", "discount" ], "type": "string", "description": "Order of results (Flipkart's own sort options). For URLs that already contain a sort, \"Relevance\" keeps it.", "default": "relevance" }, "minPrice": { "title": "Min price (₹)", "minimum": 0, "type": "integer", "description": "Only products priced at or above this, in rupees. Applied as Flipkart's price filter and re-checked on every product." }, "maxPrice": { "title": "Max price (₹)", "minimum": 0, "type": "integer", "description": "Only products priced at or below this, in rupees." }, "fetchDetails": { "title": "Fetch product details", "type": "boolean", "description": "Also read each product's page: seller name, full specifications, highlights, variants (colour/storage), image gallery, delivery estimate, warranty, return policy and aspect ratings. Slower (Flipkart rate-limits product pages) and charged as an extra product-details event per product that succeeds.", "default": false }, "trackPriceChanges": { "title": "Track price changes", "type": "boolean", "description": "Monitoring mode for scheduled runs: output only products that are new or whose price changed since the previous run of this monitor (changeType, previousPrice, priceChange). The first run outputs everything as the baseline. Unchanged products are skipped and not charged.", "default": false }, "onlyNew": { "title": "Only new products", "type": "boolean", "description": "Output only products this monitor has not output before (ignores price changes). The first run outputs everything as the baseline.", "default": false }, "stateKey": { "title": "Monitor name", "type": "string", "description": "Name of this monitor's memory. Use a different name for each independent schedule/task so they don't share the list of seen products and prices.", "default": "default" }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Usually not needed for search pages. If Flipkart rate-limits the run (HTTP 429, the run summary says so) enable Apify Proxy with automatic (datacenter) proxies: the Actor then retries once on a new IP. Residential proxies are not supported: if you select the RESIDENTIAL group, the Actor uses Apify datacenter proxy instead.", "default": { "useApifyProxy": false } } } }, "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 } } } } } } } } } }