# Bolha Scraper - Slovenian Classifieds Data (`studio-amba/bolha-scraper`) Actor Scrape classified listings from Bolha.com, Slovenia's largest marketplace. Search by keyword, category, location, and price range. Extract titles, prices, images, seller info, and more. No login or cookies required. - **URL**: https://apify.com/studio-amba/bolha-scraper.md - **Developed by:** [Studio Amba](https://apify.com/studio-amba) (community) - **Categories:** E-commerce - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing Pay per usage This Actor is paid per platform usage. The Actor is free to use, and you only pay for the Apify platform usage, which gets cheaper the higher subscription plan you have. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-usage ## 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 ## Bolha Scraper Scrape classified listings from [Bolha.com](https://www.bolha.com), Slovenia's largest online marketplace with over 1.2 million active listings. Extract prices, titles, images, locations, seller info, and more from any category or search query. No login or cookies required. ### How to scrape Bolha data 1. Go to the [Bolha Scraper](https://apify.com/studio-amba/bolha-scraper) page on Apify Store. 2. Click **Try for free** to open the actor in Apify Console. 3. Enter your search query in Slovenian (e.g., `telefon`, `prenosnik`, `stanovanje`) or pick a category. 4. Optionally set location, price range, and maximum results. 5. Click **Start** and wait for the run to finish. 6. Download your data in JSON, CSV, Excel, or connect via API. ### Why use this actor? Bolha.com is Slovenia's #1 classifieds platform, similar to Craigslist, Marktplaats, or Leboncoin. It covers everything from electronics and vehicles to real estate, fashion, furniture, and sports equipment. Over 100,000 sellers and buyers use it daily with 5,000+ new ads posted every day. This actor lets you: - **Monitor prices** across product categories to track market trends in Slovenia. - **Lead generation** by extracting seller listings for business outreach. - **Market research** to understand what products are popular and at what price points. - **Competitive analysis** for businesses operating in the Slovenian market. ### Input | Field | Type | Required | Description | |-------|------|----------|-------------| | `searchQuery` | String | No | Search term (e.g., `telefon`, `prenosnik`, `kolo`). Defaults to `telefon` if no category is set. | | `category` | String | No | Browse a specific category (e.g., `elektronika`, `avtomobili`, `nepremicnine`). | | `location` | String | No | Filter by city name (e.g., `Ljubljana`, `Maribor`, `Celje`). | | `priceFrom` | Number | No | Minimum price in EUR. | | `priceTo` | Number | No | Maximum price in EUR. | | `maxResults` | Integer | No | Maximum listings to scrape (default: 100, max: 5000). | | `proxyConfiguration` | Object | No | Proxy settings. Slovenian residential proxies recommended. | ### Output Each result contains: | Field | Type | Example | |-------|------|---------| | `itemTitle` | String | `"Samsung Galaxy S24 Ultra 256GB"` | | `price` | Number | `899.00` | | `currency` | String | `"EUR"` | | `category` | String | `"Elektronika"` | | `location` | String | `"Ljubljana"` | | `condition` | String | `"Rabljeno"` | | `postedDate` | String | `"2026-06-08"` | | `sellerType` | String | `"Zasebni"` | | `imageUrl` | String | Primary listing image URL | | `url` | String | Full URL to the listing on Bolha.com | | `scrapedAt` | String | `"2026-06-09T14:30:00.000Z"` | ### Example output ```json { "itemTitle": "Samsung Galaxy S24 Ultra 256GB", "price": 899.00, "currency": "EUR", "category": "Elektronika", "location": "Ljubljana", "condition": "Rabljeno", "postedDate": "2026-06-08", "sellerType": "Zasebni", "imageUrl": "https://www.bolha.com/image/123456.jpg", "url": "https://www.bolha.com/elektronika/mobilni-telefoni/samsung-galaxy-s24-ultra-oglas123456", "scrapedAt": "2026-06-09T14:30:00.000Z" } ```` ### Available categories The actor supports these Bolha.com categories: - **Elektronika** - Electronics, TVs, audio equipment - **Avtomobili** - Cars and vehicles - **Nepremicnine** - Real estate (apartments, houses, land) - **Dom in Vrt** - Home and garden furniture, decor - **Oblacila in Obutev** - Clothing and shoes - **Sport** - Sports and recreation equipment - **Otroski Svet** - Kids and baby products - **Glasbila** - Musical instruments - **Racunalnistvo** - Computers and software - **Telefoni** - Mobile phones and accessories - **Kolesa** - Bicycles - **Avto Deli** - Car parts and accessories ### Slovenian search tips Bolha.com is primarily in Slovenian. Here are some popular search terms: | Slovenian | English | |-----------|---------| | `telefon` | phone | | `prenosnik` | laptop | | `stanovanje` | apartment | | `avto` | car | | `kolo` | bicycle | | `kavč` | couch | | `televizor` | TV | | `igrača` | toy | ### Cost estimate This actor uses Playwright for browser-based scraping. Approximate costs: - **100 listings**: ~0.05 compute units (~$0.02) - **1,000 listings**: ~0.5 compute units (~$0.25) - **5,000 listings**: ~2.5 compute units (~$1.25) Costs depend on proxy usage and page complexity. ### Integrations Connect Bolha Scraper to your existing tools: - **Google Sheets** - Export results directly to a spreadsheet - **Slack** - Get notifications when new listings match your criteria - **Zapier / Make** - Build automated workflows - **API** - Access results programmatically via the Apify API - **Webhooks** - Trigger actions when a run completes ### Limitations - Bolha.com is primarily in Slovenian. Search queries work best in Slovenian. - Some listings may have incomplete data (no price, no image) depending on what the seller provided. - Very old listings may be archived and unavailable for scraping. - Rate limiting may apply for very large scraping runs. Use residential proxies for best results. - Data is scraped from the public website and may change without notice. ### Privacy and compliance This actor only extracts publicly available data from Bolha.com. It does not: - Access private seller accounts or messages - Require login credentials or cookies - Bypass any authentication mechanisms - Store personal data beyond what is publicly visible on listings Use this actor responsibly and in compliance with applicable laws and Bolha.com's terms of service. # Actor input Schema ## `searchQuery` (type: `string`): Search term in Slovenian or English (e.g., 'telefon', 'prenosnik', 'kolo'). Leave empty to browse a category. ## `category` (type: `string`): Browse a specific Bolha.com category. Used when no search query is provided. ## `location` (type: `string`): Filter by location name in Slovenian (e.g., 'Ljubljana', 'Maribor', 'Celje'). ## `priceFrom` (type: `number`): Minimum price filter in euros. ## `priceTo` (type: `number`): Maximum price filter in euros. ## `maxResults` (type: `integer`): Maximum number of listings to scrape. ## `proxyConfiguration` (type: `object`): Proxy settings. Slovenian residential proxies recommended for best results. ## Actor input object example ```json { "searchQuery": "telefon", "maxResults": 100, "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ], "apifyProxyCountry": "SI" } } ``` # 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 = { "searchQuery": "telefon", "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ], "apifyProxyCountry": "SI" } }; // Run the Actor and wait for it to finish const run = await client.actor("studio-amba/bolha-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 = { "searchQuery": "telefon", "proxyConfiguration": { "useApifyProxy": True, "apifyProxyGroups": ["RESIDENTIAL"], "apifyProxyCountry": "SI", }, } # Run the Actor and wait for it to finish run = client.actor("studio-amba/bolha-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 '{ "searchQuery": "telefon", "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ], "apifyProxyCountry": "SI" } }' | apify call studio-amba/bolha-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=studio-amba/bolha-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Bolha Scraper - Slovenian Classifieds Data", "description": "Scrape classified listings from Bolha.com, Slovenia's largest marketplace. Search by keyword, category, location, and price range. Extract titles, prices, images, seller info, and more. No login or cookies required.", "version": "0.1", "x-build-id": "0ghfxZpfbJIlw11bY" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/studio-amba~bolha-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-studio-amba-bolha-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/studio-amba~bolha-scraper/runs": { "post": { "operationId": "runs-sync-studio-amba-bolha-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/studio-amba~bolha-scraper/run-sync": { "post": { "operationId": "run-sync-studio-amba-bolha-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": { "searchQuery": { "title": "Search Query", "type": "string", "description": "Search term in Slovenian or English (e.g., 'telefon', 'prenosnik', 'kolo'). Leave empty to browse a category." }, "category": { "title": "Category", "enum": [ "elektronika", "avtomobili", "nepremicnine", "dom-in-vrt", "oblacila-in-obutev", "sport", "otroški-svet", "glasbila", "zivali", "storitve", "knjige-in-revije", "racunalnistvo", "telefoni", "kolesa", "avto-deli" ], "type": "string", "description": "Browse a specific Bolha.com category. Used when no search query is provided." }, "location": { "title": "Location", "type": "string", "description": "Filter by location name in Slovenian (e.g., 'Ljubljana', 'Maribor', 'Celje')." }, "priceFrom": { "title": "Minimum Price (EUR)", "minimum": 0, "type": "number", "description": "Minimum price filter in euros." }, "priceTo": { "title": "Maximum Price (EUR)", "minimum": 0, "type": "number", "description": "Maximum price filter in euros." }, "maxResults": { "title": "Max Results", "minimum": 1, "maximum": 5000, "type": "integer", "description": "Maximum number of listings to scrape.", "default": 100 }, "proxyConfiguration": { "title": "Proxy Configuration", "type": "object", "description": "Proxy settings. Slovenian residential proxies recommended for best results." } } }, "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 } } } } } } } } } } ```