# KaBuM Scraper (`automation-lab/kabum-scraper`) Actor Scrape KaBuM products, prices, discounts, stock, sellers, ratings, and category data for Brazilian ecommerce intelligence. - **URL**: https://apify.com/automation-lab/kabum-scraper.md - **Developed by:** [Stas Persiianenko](https://apify.com/automation-lab) (community) - **Categories:** E-commerce - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, NaN bookmarks - **User rating**: No ratings yet ## Pricing Pay per event This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event ## What's an Apify Actor? Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases. In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours, and optionally produces a well-defined JSON output, datasets with results, or files in key-value store. In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server. Actors are written with capital "A". ## How to integrate an Actor? If asked about integration, you help developers integrate Actors into their projects. You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready. The best way to integrate Actors is as follows. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md). If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md). For usage examples, see the [API](#api) section below. For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt). # README ## KaBuM Scraper Scrape KaBuM product listings, prices, availability, seller details, ratings, and discount signals from Brazil's major technology and gaming ecommerce store. ### What does KaBuM Scraper do? KaBuM Scraper collects public product data from KaBuM search, category, and product pages. It is designed for ecommerce monitoring, price intelligence, assortment research, and affiliate content workflows. The actor reads KaBuM pages over HTTP and extracts the structured product data embedded in the page. You can start from search terms, direct KaBuM URLs, or a mix of both. ### Who is it for? #### ๐Ÿ›’ Ecommerce and retail teams Use KaBuM Scraper to monitor Brazilian electronics prices, compare first-party and marketplace offers, and keep internal dashboards current without manual checks. Typical workflow: 1. Run daily searches for priority terms such as `notebook`, `ssd`, or `monitor gamer`. 2. Join repeated runs by `productId`. 3. Alert your team when `priceWithDiscount`, `available`, or `sellerName` changes. #### ๐Ÿ“Š Market intelligence and category analysts Track technology categories, brand coverage, discount patterns, and product availability across one of Brazil's most important electronics retailers. Typical workflow: 1. Scrape category or search URLs weekly. 2. Group products by `brand`, `category`, and `sellerName`. 3. Export the dataset to BigQuery, Sheets, or your BI tool for trend reporting. #### ๐Ÿงพ Repricing and assortment operations Use structured price and availability data to compare SKUs, watch competitor movement, and prioritize manual review of fast-changing products. Typical workflow: 1. Provide the KaBuM URLs or product-focused searches your team cares about. 2. Compare `currentPrice`, `priceWithDiscount`, `originalPrice`, and `stockQuantity`. 3. Feed the results into repricing, inventory, or merchandising workflows. #### โœ๏ธ Affiliate publishers and content teams Refresh product comparison tables for electronics, gaming, PC parts, and peripherals with current names, prices, images, and links. Typical workflow: 1. Run a small search for a buying guide topic. 2. Export `name`, `url`, `imageUrl`, prices, rating, and availability. 3. Update articles, product cards, or affiliate research sheets. #### ๐Ÿง‘โ€๐Ÿ’ป Developers and automation builders Call the actor from the Apify API, webhooks, or MCP tools when you need clean KaBuM product data in another app. Typical workflow: 1. Trigger a run from Node.js, Python, cURL, Zapier, Make, or an MCP-compatible assistant. 2. Read the default dataset by API. 3. Store normalized product records in your application. ### Why use this actor? KaBuM is a key retailer for computers, components, peripherals, games, and electronics in Brazil. Manual price checks are slow and hard to repeat. This actor turns those public pages into a structured dataset with product IDs, prices, stock, seller, and rating fields. ### What data can you extract? | Field | Description | | --- | --- | | productId | KaBuM product code | | name | Product title | | url | Product detail URL | | imageUrl | Main product image | | brand | Manufacturer name when available | | category | KaBuM category path | | sellerName | Seller or fulfillment name | | currentPrice | Listed price | | priceWithDiscount | Discount or cash price | | originalPrice | Previous/list price | | primePrice | KaBuM Prime price when available | | discountPercentage | Displayed discount percentage | | maxInstallment | Installment text | | rating | Product rating | | reviewCount | Rating count | | available | Availability flag | | stockQuantity | Quantity exposed by KaBuM | | isMarketplace | Marketplace flag | | isFreeShipping | Free shipping flag | | sourceUrl | Page used for extraction | | searchQuery | Search query inferred from URL | | scrapedAt | Extraction timestamp | ### How much does it cost to scrape KaBuM products? The actor uses pay-per-event pricing. You pay a small run-start fee plus a per-product result fee. The current local pricing configuration is: | Charge | Amount | | --- | ---: | | Run start | $0.005 per run | | Product result, FREE tier | $0.000028343 per product | | Product result, BRONZE tier | $0.000024646 per product | | Product result, SILVER tier | $0.000019224 per product | | Product result, GOLD tier | $0.000014788 per product | | Product result, PLATINUM tier | $0.0000098585 per product | | Product result, DIAMOND tier | $0.0000069009 per product | Example run costs on the FREE tier: | Example run | Formula | Estimated actor charge | | --- | --- | ---: | | First test with 20 products | $0.005 + 20 ร— $0.000028343 | about $0.0056 | | Daily price check with 100 products | $0.005 + 100 ร— $0.000028343 | about $0.0078 | | Category snapshot with 1,000 products | $0.005 + 1,000 ร— $0.000028343 | about $0.0333 | | Large assortment export with 10,000 products | $0.005 + 10,000 ร— $0.000028343 | about $0.2884 | Free-plan estimate: with roughly $5 of Apify platform credits, the actor charge alone would cover about 176,000 FREE-tier product results if you ran one large batch. Real usage can be lower after platform compute, proxy, and storage costs, so keep your first run small with the default `maxItems` value and increase it when the output matches your workflow. ### How to scrape KaBuM search results 1. Open the actor on Apify. 2. Add one or more search terms, for example `notebook`, `ssd`, or `placa de video`. 3. Set `maxItems` to the number of products you need. 4. Run the actor. 5. Export the dataset as JSON, CSV, Excel, or through the API. ### How to scrape KaBuM URLs Paste KaBuM search, category, or product URLs into `startUrls`. You can combine URLs with search terms in the same run. The actor deduplicates products by KaBuM product ID. ### Input configuration #### Search terms Use `queries` for simple keyword monitoring. Examples: - `notebook` - `ssd` - `monitor gamer` - `placa de video` #### Start URLs Use `startUrls` when you already have a KaBuM page URL. Examples include search URLs, category URLs, and product URLs. #### Maximum products Use `maxItems` to control output size and cost. The default prefill is intentionally low for safe first runs. #### Request retries Use `maxRequestRetries` to control retry behavior for temporary network errors. Most users can keep the default value. ### Example input ```json { "queries": ["notebook", "ssd"], "startUrls": [ { "url": "https://www.kabum.com.br/busca/placa-de-video" } ], "maxItems": 50, "maxRequestRetries": 3 } ```` ### Example output ```json { "productId": "952233", "name": "Notebook Acer Aspire 5...", "url": "https://www.kabum.com.br/produto/952233/...", "brand": "Acer", "category": "Computadores/Notebooks/Notebook Acer", "sellerName": "KaBuM!", "currentPrice": 3555.54, "priceWithDiscount": 3199.99, "discountPercentage": 10, "available": true, "stockQuantity": 124, "sourceUrl": "https://www.kabum.com.br/busca/notebook", "searchQuery": "notebook", "scrapedAt": "2026-05-16T00:00:00.000Z" } ``` ### Tips for better results - โœ… Use Portuguese product terms used by Brazilian shoppers. - โœ… Start with broad categories, then add specific searches. - โœ… Use product IDs to deduplicate data across recurring runs. - โœ… Track `priceWithDiscount` for cash/discount price monitoring. - โœ… Track `stockQuantity` and `available` for availability alerts. ### Common use cases #### Price monitoring Run the actor daily and compare `priceWithDiscount` by `productId`. #### Assortment tracking Collect category pages to see which brands and product families are present. #### Affiliate content updates Export product names, prices, image URLs, and links for product comparison pages. #### Competitive intelligence Monitor KaBuM marketplace and first-party seller changes over time. ### Integrations Use the Apify dataset API to send results to your data warehouse. Connect Apify with Make, Zapier, Google Sheets, BigQuery, or your own webhook pipeline. Common workflow patterns: - KaBuM Scraper โ†’ Dataset โ†’ Google Sheets dashboard. - KaBuM Scraper โ†’ Webhook โ†’ repricing alert. - KaBuM Scraper โ†’ BigQuery โ†’ historical price model. - KaBuM Scraper โ†’ API client โ†’ affiliate site refresh. ### API usage with Node.js ```js import { ApifyClient } from 'apify-client'; const client = new ApifyClient({ token: process.env.APIFY_TOKEN }); const run = await client.actor('automation-lab/kabum-scraper').call({ queries: ['notebook'], maxItems: 20 }); console.log(run.defaultDatasetId); ``` ### API usage with Python ```python from apify_client import ApifyClient client = ApifyClient('YOUR_APIFY_TOKEN') run = client.actor('automation-lab/kabum-scraper').call({ 'queries': ['ssd'], 'maxItems': 20, }) print(run['defaultDatasetId']) ``` ### API usage with cURL ```bash curl "https://api.apify.com/v2/acts/automation-lab~kabum-scraper/runs?token=$APIFY_TOKEN" \ -H 'Content-Type: application/json' \ -d '{"queries":["monitor gamer"],"maxItems":20}' ``` ### MCP usage You can run this actor from MCP-compatible tools through Apify MCP. Use this tools URL: `https://mcp.apify.com/?tools=automation-lab/kabum-scraper` Add it to Claude Code with the HTTP transport: ```bash claude mcp add apify-kabum --transport http "https://mcp.apify.com/?tools=automation-lab/kabum-scraper" ``` For Claude Desktop, add this to your MCP server configuration file and restart the app: ```json { "mcpServers": { "apify-kabum": { "type": "http", "url": "https://mcp.apify.com/?tools=automation-lab/kabum-scraper" } } } ``` For Cursor, open Cursor settings, go to MCP servers, choose **Add new global MCP server**, and use this JSON: ```json { "mcpServers": { "apify-kabum": { "type": "http", "url": "https://mcp.apify.com/?tools=automation-lab/kabum-scraper" } } } ``` For VS Code MCP-compatible extensions, create or update the workspace MCP configuration with the same HTTP server entry: ```json { "servers": { "apify-kabum": { "type": "http", "url": "https://mcp.apify.com/?tools=automation-lab/kabum-scraper" } } } ``` Example prompts: - "Run KaBuM Scraper for notebooks and summarize the cheapest Acer models." - "Scrape SSD results from KaBuM and create a price comparison table." - "Check whether the selected product IDs are still available on KaBuM." ### Data quality notes The actor extracts structured data embedded in KaBuM pages. Some fields are optional because KaBuM does not expose every value for every product. For example, Prime prices, free shipping flags, or ratings may be missing on some products. ### Limitations The actor currently focuses on public product data. It does not log in, add products to cart, bypass private user pricing, or access account-only data. Pagination depth depends on the data exposed in the supplied page and the selected `maxItems` value. ### FAQ #### Why did I get fewer products than requested? The source page may expose fewer unique products than your `maxItems` limit, or several inputs may overlap and deduplicate to the same product IDs. #### Why is a price field empty? KaBuM exposes several price variants. Some products may not have Prime prices, original prices, or discounts at the time of scraping. #### Should I use queries or start URLs? Use queries for keyword monitoring and start URLs when you need a specific KaBuM page. ### Legality and ethical use This actor collects publicly available product information. Always review KaBuM's terms, respect applicable laws, and use the data responsibly. Do not use scraped data for spam, fraud, or abusive automation. ### Related scrapers Explore other ecommerce actors from Automation Lab: - https://apify.com/automation-lab/mercadolivre-scraper - https://apify.com/automation-lab/amazon-scraper - https://apify.com/automation-lab/ebay-scraper - https://apify.com/automation-lab/shopify-scraper ### Support If a run fails or returns unexpected data, open an issue from the Apify run page. Include the input, run ID, and a short description of what you expected. ### Changelog #### 0.1 Initial KaBuM product search and URL scraping release. ### Field reference `productId` is the stable key to join repeated runs. `url` points to the KaBuM product page. `sourceUrl` records where the product was found. `scrapedAt` makes recurring monitoring easier. `isMarketplace` helps separate KaBuM first-party and marketplace offers. `stockQuantity` can change quickly and should be treated as point-in-time data. ### Operational recommendations Run small tests before scheduling large recurring jobs. Store historical snapshots if you need price change detection. Export to CSV for manual review or JSON for automated pipelines. Use Apify webhooks when you need alerts after every run. # Actor input Schema ## `queries` (type: `array`): KaBuM search terms to scrape, such as notebook, placa de video, or ssd. ## `startUrls` (type: `array`): KaBuM search, category, or product URLs. Search terms and start URLs can be combined. ## `maxItems` (type: `integer`): Maximum number of product records to save. ## `maxRequestRetries` (type: `integer`): Retry attempts for temporary network or upstream errors. ## Actor input object example ```json { "queries": [ "notebook" ], "startUrls": [ { "url": "https://www.kabum.com.br/busca/ssd" } ], "maxItems": 20, "maxRequestRetries": 3 } ``` # Actor output Schema ## `overview` (type: `string`): No description # API You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup. ## JavaScript example ```javascript import { ApifyClient } from 'apify-client'; // Initialize the ApifyClient with your Apify API token // Replace the '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "queries": [ "notebook" ], "startUrls": [ { "url": "https://www.kabum.com.br/busca/ssd" } ], "maxItems": 20, "maxRequestRetries": 3 }; // Run the Actor and wait for it to finish const run = await client.actor("automation-lab/kabum-scraper").call(input); // Fetch and print Actor results from the run's dataset (if any) console.log('Results from dataset'); console.log(`๐Ÿ’พ Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`); const { items } = await client.dataset(run.defaultDatasetId).listItems(); items.forEach((item) => { console.dir(item); }); // ๐Ÿ“š Want to learn more ๐Ÿ“–? Go to โ†’ https://docs.apify.com/api/client/js/docs ``` ## Python example ```python from apify_client import ApifyClient # Initialize the ApifyClient with your Apify API token # Replace '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "queries": ["notebook"], "startUrls": [{ "url": "https://www.kabum.com.br/busca/ssd" }], "maxItems": 20, "maxRequestRetries": 3, } # Run the Actor and wait for it to finish run = client.actor("automation-lab/kabum-scraper").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print("๐Ÿ’พ Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"]) for item in client.dataset(run["defaultDatasetId"]).iterate_items(): print(item) # ๐Ÿ“š Want to learn more ๐Ÿ“–? Go to โ†’ https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{ "queries": [ "notebook" ], "startUrls": [ { "url": "https://www.kabum.com.br/busca/ssd" } ], "maxItems": 20, "maxRequestRetries": 3 }' | apify call automation-lab/kabum-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=automation-lab/kabum-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "KaBuM Scraper", "description": "Scrape KaBuM products, prices, discounts, stock, sellers, ratings, and category data for Brazilian ecommerce intelligence.", "version": "0.1", "x-build-id": "DnnGPSTLQNaXPlJoS" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/automation-lab~kabum-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-automation-lab-kabum-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/automation-lab~kabum-scraper/runs": { "post": { "operationId": "runs-sync-automation-lab-kabum-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/automation-lab~kabum-scraper/run-sync": { "post": { "operationId": "run-sync-automation-lab-kabum-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": { "queries": { "title": "Search terms", "type": "array", "description": "KaBuM search terms to scrape, such as notebook, placa de video, or ssd.", "items": { "type": "string" } }, "startUrls": { "title": "Start URLs", "type": "array", "description": "KaBuM search, category, or product URLs. Search terms and start URLs can be combined.", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "maxItems": { "title": "Maximum products", "minimum": 1, "maximum": 1000, "type": "integer", "description": "Maximum number of product records to save.", "default": 50 }, "maxRequestRetries": { "title": "Request retries", "minimum": 1, "maximum": 10, "type": "integer", "description": "Retry attempts for temporary network or upstream errors.", "default": 3 } } }, "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 } } } } } } } } } } ```