{ "openapi": "3.0.1", "info": { "title": "Magazine Luiza Scraper - Products, Prices, Sellers & Reviews", "description": "Scrape Magazine Luiza (magazineluiza.com.br) by keyword, brand, seller or URL. Extract product names, prices, cash and installment offers, sellers, ratings, stock, badges and attributes. Optional enrichment adds full product details and customer reviews.", "version": "0.1", "x-build-id": "AnJMW1h3RS7A5Ofht" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/abotapi~magazineluiza-com-br-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-abotapi-magazineluiza-com-br-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/abotapi~magazineluiza-com-br-scraper/runs": { "post": { "operationId": "runs-sync-abotapi-magazineluiza-com-br-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/abotapi~magazineluiza-com-br-scraper/run-sync": { "post": { "operationId": "run-sync-abotapi-magazineluiza-com-br-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", "url" ], "type": "string", "description": "Search by keyword, or paste search and category links.", "default": "search" }, "searchTerms": { "title": "Search terms", "type": "array", "description": "One or more product keywords, for example notebook or geladeira. Used only in search mode.", "items": { "type": "string" } }, "sortBy": { "title": "Sort by", "enum": [ "relevance", "priceAsc", "priceDesc", "totalPriceAsc", "shippingTime", "bestSelling", "bestRated", "newest" ], "type": "string", "description": "Result order for search mode.", "default": "relevance" }, "minPrice": { "title": "Minimum price (BRL)", "minimum": 0, "type": "number", "description": "Only products priced at or above this amount, in reais. The store applies it to the cash (Pix) price shown on each product. Leave empty for no minimum." }, "maxPrice": { "title": "Maximum price (BRL)", "minimum": 0, "type": "number", "description": "Only products priced at or below this amount, in reais. The store applies it to the cash (Pix) price shown on each product. Leave empty for no maximum." }, "brands": { "title": "Brand", "type": "array", "description": "Brand names such as Samsung, Lenovo or Apple, written the way the store's brand filter shows them. Every entry is searched separately (each brand adds one search per keyword), so results are not mixed. Leave empty for all brands.", "items": { "type": "string" } }, "sellers": { "title": "Sold by (seller)", "type": "array", "description": "Seller names such as Magalu, Kabum or Lenovo Oficial, written the way the store's Sold by filter shows them. Every entry is searched separately. Leave empty for all sellers. A name the store does not know returns no products and is reported in the log.", "items": { "type": "string" } }, "minRating": { "title": "Minimum rating", "enum": [ "any", "3", "4", "4.5" ], "type": "string", "description": "Only products rated at or above this score out of 5. Products with no rating yet are skipped when a minimum is set. Applied to the rows the store returns, so a strict minimum can return fewer products than Max items.", "default": "any" }, "excludeSponsored": { "title": "Skip sponsored placements", "type": "boolean", "description": "Leave out paid placements and keep organic results only.", "default": false }, "availableOnly": { "title": "Available products only", "type": "boolean", "description": "Skip products shown as unavailable.", "default": false }, "urls": { "title": "Search or category links", "type": "array", "description": "One link per line. Accepted: search pages, category pages, subcategory and brand/model pages, and single product pages (a bare product id also works). Search-mode filters (price, brand, seller) are ignored here; filters and sort set in a link are honored. Pagination walks forward from the page in the link.", "default": [ "https://www.magazineluiza.com.br/busca/notebook/" ], "items": { "type": "string" } }, "maxPages": { "title": "Max pages per search", "minimum": 0, "type": "integer", "description": "Optional. Empty or 0 means no page limit; it does NOT cap the run and defers to Max items. One page holds about 40 products." }, "maxItems": { "title": "Max items", "minimum": 0, "type": "integer", "description": "The single cap on this run: stop after this many products across all searches and links. Set 0 for unlimited.", "default": 20 }, "includeDetails": { "title": "Fetch full product details", "type": "boolean", "description": "Off by default. Turn on to read each product page as well: full description, image gallery, specification sheet, key selling points, variations, dimensions, seller legal name and tax id, rating breakdown and customer reviews. Billed as a detail charge per product returned with details. Product links always include details.", "default": false }, "maxReviews": { "title": "Max reviews per product", "minimum": 0, "maximum": 1000, "type": "integer", "description": "Customer reviews to attach to each product when Fetch full product details is on (and for product links). The store shows the newest reviews on the product page, so a product never returns more than it displays there. Set 0 to skip reviews. Each delivered review is billed as one review charge.", "default": 20 }, "proxy": { "title": "Proxy configuration", "type": "object", "description": "The default standard pool works on every plan. Residential is recommended for the most reliable results, especially on large or frequent runs.", "default": { "useApifyProxy": true } }, "resumeFromRunId": { "title": "Resume from a previous run", "type": "string", "description": "Paste a previous run ID or dataset ID to continue a large crawl without returning or charging for records already collected there. Use this after an interrupted or capped run. For recurring monitoring of the same search, use Incremental mode below instead." }, "incrementalMode": { "title": "Incremental changes for scheduled runs", "type": "boolean", "description": "Turn this on for daily or weekly recurring monitoring of the same search, for example a price watch. The first run returns everything matching as NEW. Later runs normally return only NEW, UPDATED and REAPPEARED records. Price moves, discount changes, stock changes and new reviews ARE reported as UPDATED: on a retail site they are the signal, not noise. Detail fields (description, images, specifications, reviews) are not compared, only the listing and price fields. Turn on Emit unchanged or Emit expired only when you also want those rows returned (and billed). State is kept separately per search, URL and filter setup; use State key to name or deliberately share a monitoring campaign. To continue one specific interrupted run instead, use Resume from a previous run above.", "default": false }, "stateKey": { "title": "State key (optional, incremental mode only)", "type": "string", "description": "Optional. Name this monitoring campaign to keep its state stable, or to deliberately share state across differently configured runs. Leave empty to let the actor derive a key automatically from the search terms, URLs and filters, so two different searches never mix state." }, "emitUnchanged": { "title": "Emit unchanged records (incremental mode only)", "type": "boolean", "description": "Off by default. Turn on to also return records that have not changed since the last run, marked UNCHANGED. This returns, and bills, extra rows you already have, so leave it off unless you specifically want a full snapshot every run.", "default": false }, "emitExpired": { "title": "Emit expired records (incremental mode only)", "type": "boolean", "description": "Off by default. Turn on to also return records that were present in a previous run but are no longer found, marked EXPIRED. Only produced once a run has fully scanned the tracked search: not when Max items capped it, not when Resume was used, and not when the run was refused. This returns, and bills, extra synthetic rows, so leave it off unless you need expiry tracking.", "default": false }, "ignoreFieldsForChanges": { "title": "Ignore fields when detecting changes (incremental mode only)", "type": "array", "description": "Incremental mode only. Extra field names to keep out of the change fingerprint, on top of the built-in list (page, position, search term and sponsored flag). Use this when a field moves on every run without the product changing. Price, discount, stock and rating fields are never ignored: on a retail site they are the signal.", "items": { "type": "string" } }, "mcpConnectors": { "title": "Pipe results into your apps (optional)", "type": "array", "description": "Optionally send results into the apps you already use, via Model Context Protocol (MCP) connectors. Authorize one under Apify, Settings, API and Integrations, then select it here. Notion gets a page per record; other connectors get a best-effort write or digest. Each connector receives a condensed summary per record, not the full record; the complete record always stays in the dataset. Leave empty to skip; this never changes the dataset output. Supported: Notion (https://mcp.notion.com/mcp), Linear (https://mcp.linear.app/sse), Airtable (https://mcp.airtable.com/mcp), Apify (https://mcp.apify.com)." }, "notionParentPageUrl": { "title": "Notion parent page (Notion connector only)", "type": "string", "description": "URL or id of the Notion page under which record pages are created. Required to enable the Notion export; ignored by other connectors." }, "maxNotifyListings": { "title": "Max items to export per connector", "minimum": 1, "maximum": 1000, "type": "integer", "description": "Cap on records written to each connector per run. Does not affect the dataset.", "default": 50 } } }, "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 } } } } } } } } } }