{ "openapi": "3.0.1", "info": { "title": "Falabella Scraper - Products, Prices & Seller Leads", "description": "Scrape Falabella (Chile, Peru, Colombia) — products by keyword, category or URL with live prices, discounts, ratings, specs, variants, images & stock, plus buyer reviews and marketplace seller leads. Keyless, no browser. Monitor price drops & restocks.", "version": "0.1", "x-build-id": "QQpuv1FdTZCAF1rJw" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/scrapesage~falabella-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-scrapesage-falabella-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/scrapesage~falabella-scraper/runs": { "post": { "operationId": "runs-sync-scrapesage-falabella-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/scrapesage~falabella-scraper/run-sync": { "post": { "operationId": "run-sync-scrapesage-falabella-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": { "market": { "title": "Country / market", "enum": [ "cl", "pe", "co" ], "type": "string", "description": "Which Falabella marketplace to scrape. cl = Chile (falabella.com), pe = Peru (falabella.com.pe), co = Colombia (falabella.com.co). Prices and currency are localized per market.", "default": "cl" }, "searchQueries": { "title": "Search queries (keywords)", "type": "array", "description": "Keywords to search, e.g. \"laptop\", \"zapatillas running\", \"smart tv\". Each query is paginated up to Max results. Leave empty if you use Category URLs or Start URLs instead.", "items": { "type": "string" } }, "categoryUrls": { "title": "Category URLs", "type": "array", "description": "Full Falabella category page URLs to browse, e.g. https://www.falabella.com/falabella-cl/category/cat70057/Notebooks . Every product on the category (paginated) is collected.", "items": { "type": "string" } }, "startUrls": { "title": "Start URLs (search or category)", "type": "array", "description": "Paste any Falabella search or category URL. The page type and the market are auto-detected from the URL (.com / .com.pe / .com.co).", "items": { "type": "string" } }, "sort": { "title": "Sort order", "enum": [ "relevance", "priceLowToHigh", "priceHighToLow", "topRated", "discount" ], "type": "string", "description": "Result ordering. relevance = Falabella's default ranking. priceLowToHigh / priceHighToLow are applied by Falabella; topRated and discount are applied to the collected results.", "default": "relevance" }, "minPrice": { "title": "Min price", "minimum": 0, "type": "integer", "description": "Only keep products whose current price is at or above this value (in the market's currency). Leave empty for no minimum." }, "maxPrice": { "title": "Max price", "minimum": 0, "type": "integer", "description": "Only keep products whose current price is at or below this value (in the market's currency). Leave empty for no maximum." }, "onlyDiscounted": { "title": "Only discounted products", "type": "boolean", "description": "Keep only products that currently have a discount (a crossed-out original price or a discount badge).", "default": false }, "outputSellerLeads": { "title": "Also output seller leads", "type": "boolean", "description": "Emit one deduped marketplace-seller lead per unique seller found (seller name & ID, first-party vs third-party, listing count, brands & categories sold, price range, average rating, 0-100 lead score). Great for competitor monitoring and marketplace seller prospecting.", "default": false }, "maxResults": { "title": "Max results (products)", "minimum": 1, "maximum": 50000, "type": "integer", "description": "Overall cap on the number of products collected for this run. Seller leads are emitted in addition to this cap.", "default": 100 }, "monitorMode": { "title": "Monitor mode (only new / changed)", "type": "boolean", "description": "Remember what was emitted in previous runs (in a named key-value store) and output only NEW products and PRICE changes (drops & rises). Perfect for scheduled price-watch alerts. Each record carries a monitorReason field. Works alongside Apify Schedules (this controls WHAT is emitted; Schedules control WHEN the actor runs).", "default": false }, "monitorKey": { "title": "Monitor key", "type": "string", "description": "Namespace for monitor memory. Use a distinct key per saved search so separate watch lists don't share state.", "default": "default" }, "maxConcurrency": { "title": "Max concurrency", "minimum": 1, "maximum": 16, "type": "integer", "description": "Parallel requests. The actor rotates a fresh proxy IP per request; lower this if you hit throttling.", "default": 6 }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Proxy settings. Residential proxies are recommended (and enabled by default) for Falabella. Falabella serves correct localized prices for each market regardless of proxy country, so the default global residential pool is the most reliable choice.", "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 } } }, "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 } } } } } } } } } }