{ "openapi": "3.0.1", "info": { "title": "Falabella Product Price & Stock Scraper (CL/PE/CO)", "description": "Scrape Falabella products across Chile, Peru and Colombia. Extract title, brand, price, original price, discount, currency, rating, reviews, seller, SKU, stock and variants. Export to JSON, CSV or Excel. No login needed.", "version": "0.1", "x-build-id": "T2Bwmjv0Y2Lfjdf7s" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/scrapers_lat~falabella-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-scrapers_lat-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/scrapers_lat~falabella-scraper/runs": { "post": { "operationId": "runs-sync-scrapers_lat-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/scrapers_lat~falabella-scraper/run-sync": { "post": { "operationId": "run-sync-scrapers_lat-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": { "searchTerms": { "title": "Search Terms", "type": "array", "description": "One or more keywords to search on Falabella. One run searches every term. Combined with Country. Example: [\"zapatillas\", \"notebook\"].", "items": { "type": "string" } }, "startUrls": { "title": "Search / Category URLs", "type": "array", "description": "One or more Falabella search or category result URLs (e.g. https://www.falabella.com/falabella-cl/category/cat2083/Zapatillas). Filters encoded in the URL are respected. The country is auto-detected from each URL.", "items": { "type": "string" } }, "productUrls": { "title": "Product URLs", "type": "array", "description": "One or more direct Falabella product page URLs to scrape (e.g. https://www.falabella.com/falabella-cl/product/882430166/...). These are always returned with full product details.", "items": { "type": "string" } }, "country": { "title": "Country", "enum": [ "cl", "pe", "co" ], "type": "string", "description": "Falabella country site to search when using Search Terms: Chile, Peru or Colombia. (Argentina has no Falabella storefront.)", "default": "cl" }, "priceMin": { "title": "Minimum Price", "minimum": 0, "type": "integer", "description": "Only keep products whose current price is at or above this amount (in the site currency: CLP, PEN or COP). Optional." }, "priceMax": { "title": "Maximum Price", "minimum": 0, "type": "integer", "description": "Only keep products whose current price is at or below this amount (in the site currency: CLP, PEN or COP). Optional." }, "brand": { "title": "Brand Filter", "type": "string", "description": "Only keep products whose brand contains this text (case-insensitive), e.g. \"adidas\". Optional." }, "seller": { "title": "Seller Filter", "type": "string", "description": "Only keep products whose seller name contains this text (case-insensitive), e.g. \"falabella\" for first-party only, or a marketplace seller name. Optional." }, "minRating": { "title": "Minimum Rating", "minimum": 0, "maximum": 5, "type": "integer", "description": "Only keep products with an average rating at or above this value (0-5). Products without a rating are excluded when set. Optional." }, "onlyInStock": { "title": "Only In Stock", "type": "boolean", "description": "When enabled, only products that are currently in stock are returned.", "default": false }, "sortBy": { "title": "Sort Results By", "enum": [ "relevance", "priceAsc", "priceDesc", "ratingDesc", "discountDesc" ], "type": "string", "description": "Order the records returned by this run. 'relevance' keeps Falabella's own ordering.", "default": "relevance" }, "maxProducts": { "title": "Max Products To Scrape", "minimum": 1, "maximum": 1000000, "type": "integer", "description": "Maximum number of products to collect across all searches. Free Apify plans are capped at 10 per run." }, "withDetails": { "title": "Fetch Product Details", "type": "boolean", "description": "When enabled, the actor opens each product page to add description, specifications, breadcrumb, CMR points, the full image gallery and per-size variants with stock. Slower but richer.", "default": true }, "withDescription": { "title": "AI: clean & translate name/description (paid add-on)", "type": "boolean", "description": "Opt-in AI add-on (paid plans only), off by default. Produce a concise clean product name, an English name, and a plain-language English description summary. Charged only when the model returns usable output.", "default": false }, "withAttributes": { "title": "AI: extract attributes & category (paid add-on)", "type": "boolean", "description": "Opt-in AI add-on (paid plans only), off by default. Extract structured product attributes/specs and a broad product category from the title, description and specs. Charged only when the model returns usable output.", "default": false }, "startUrl": { "title": "Search URL (single, legacy)", "type": "string", "description": "A single Falabella search or category results URL. Kept for backward compatibility; prefer Search / Category URLs. Takes precedence over Search Terms + Country." }, "searchTerm": { "title": "Search Term (single, legacy)", "type": "string", "description": "A single keyword to search for. Kept for backward compatibility; prefer Search Terms." } } }, "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 } } } } } } } } } }