# Njuskalo Scraper - Croatian Classifieds & Cars (`studio-amba/njuskalo-scraper`) Actor Scrape listings from njuskalo.hr — Croatia's largest classifieds marketplace. Extract cars, real estate, electronics, jobs, and more with prices, photos, seller info, and category-specific attributes. No login required. - **URL**: https://apify.com/studio-amba/njuskalo-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 ## Njuskalo Scraper Scrape classifieds listings from [njuskalo.hr](https://www.njuskalo.hr) -- Croatia's largest online marketplace. Extract cars, real estate, electronics, jobs, mobile phones, and more with structured data including prices, photos, seller information, and category-specific attributes. No login or cookies required. ### What data can you extract from Njuskalo? This scraper extracts structured listing data from all major Njuskalo categories: - **Listing title** -- the headline of each ad - **Price** -- numeric value and original display text (EUR) - **Location** -- city or region in Croatia - **Category** -- the Njuskalo section (cars, apartments, phones, etc.) - **Seller info** -- name and type (private/professional) - **Images** -- primary and all gallery image URLs - **Description** -- short summary text from the listing - **Attributes** -- category-specific details (year, mileage, fuel type for cars; rooms, surface for real estate; brand, model for electronics) - **Listing ID** -- unique Njuskalo ad identifier - **Posted date** -- when the ad was published - **Scraped timestamp** -- ISO 8601 timestamp ### How to scrape Njuskalo data 1. Go to [Apify Console](https://console.apify.com/) and create a new task for the Njuskalo Scraper. 2. Select a **category** (e.g., Cars, Apartments for sale, Mobile phones) or paste a filtered Njuskalo URL directly. 3. Optionally enter a **search query** in Croatian (e.g., "volkswagen golf", "stan Zagreb", "iPhone 15"). 4. Set the **max results** to control how many listings to extract. 5. Keep the default proxy settings -- Croatian residential proxies are required and pre-configured. 6. Click **Start** and wait for the results. 7. Download your data as JSON, CSV, Excel, or connect via API. #### Input example ```json { "category": "auti", "searchQuery": "volkswagen golf", "maxResults": 50, "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": ["RESIDENTIAL"], "apifyProxyCountry": "HR" } } ```` #### Using Start URLs You can also paste one or more Njuskalo URLs directly. This is useful when you want to scrape a specific filtered page -- just apply your filters on njuskalo.hr and copy the URL: ```json { "startUrls": [ { "url": "https://www.njuskalo.hr/auti?brand=volkswagen&model=golf" }, { "url": "https://www.njuskalo.hr/prodaja-stanova/zagreb" } ], "maxResults": 100 } ``` You can also scrape individual listing pages: ```json { "startUrls": [ { "url": "https://www.njuskalo.hr/auti/volkswagen-golf-8-2-0-tdi-oglas-12345678" } ] } ``` ### Supported categories | Category | Slug | Description | |----------|------|-------------| | Cars | `auti` | New and used cars | | Apartments (sale) | `prodaja-stanova` | Apartments for sale | | Apartments (rent) | `iznajmljivanje-stanova` | Apartments for rent | | Houses (sale) | `prodaja-kuca` | Houses for sale | | Mobile phones | `mobiteli` | Smartphones and mobile phones | | IT & Computers | `informatika` | Laptops, desktops, components | | Audio/Video/Photo | `audio-video-foto` | TVs, cameras, audio equipment | | Fashion | `od-glave-do-pete` | Clothing, shoes, accessories | | Home & Garden | `sve-za-dom` | Furniture, appliances, tools | | Jobs | `posao` | Job listings | | Tourist accommodation | `turisticki-smjestaj` | Holiday rentals | | Food & Drinks | `hrana-pice` | Food products and beverages | ### Output example ```json { "listingTitle": "Volkswagen Golf 8 2.0 TDI DSG", "price": 25900, "currency": "EUR", "priceLabel": "25.900 EUR", "location": "Zagreb", "category": "auti", "condition": null, "sellerType": "Professional", "sellerName": "Auto Centar Zagreb", "imageUrl": "https://www.njuskalo.hr/image-bigger/auti/volkswagen-golf-8-slika-12345.jpg", "imageUrls": [ "https://www.njuskalo.hr/image-bigger/auti/volkswagen-golf-8-slika-12345.jpg" ], "url": "https://www.njuskalo.hr/auti/volkswagen-golf-8-2-0-tdi-dsg-oglas-12345678", "listingDescription": "2021. | 45.000 km | Diesel | Automatski", "attributes": { "godina": "2021", "kilometraza": "45.000 km", "gorivo": "Diesel", "mjenjac": "Automatski" }, "listingId": "12345678", "postedDate": null, "scrapedAt": "2026-06-09T12:00:00.000Z" } ``` ### Important: Croatian proxy required Njuskalo.hr **geo-blocks all non-Croatian IP addresses** at the TCP level. Requests from outside Croatia will time out silently. This scraper requires Apify Residential proxies with `apifyProxyCountry` set to `HR` (Croatia). The default proxy configuration is pre-filled correctly. Do not change it unless you have your own Croatian proxy setup. ### How much does it cost to scrape Njuskalo? The cost depends on how many listings you extract. A typical run scraping 100 car listings takes about 2-3 minutes and costs approximately $0.10-0.20 in Apify platform credits (including residential proxy usage). | Listings | Estimated time | Estimated cost | |----------|---------------|---------------| | 20 | ~1 min | ~$0.05 | | 100 | ~3 min | ~$0.15 | | 500 | ~10 min | ~$0.60 | | 1,000 | ~20 min | ~$1.20 | Costs may vary depending on proxy usage and the number of retries needed. ### Tips for best results - **Use Croatian keywords** for search queries -- Njuskalo is a Croatian-language site. For example, use "stan" (apartment) not "apartment", "posao" (job) not "job". - **Start with Start URLs** if you need specific filters -- apply filters on njuskalo.hr first, then paste the resulting URL. - **Keep maxResults reasonable** to control costs. Start with 20-50 to test, then scale up. - **Categories have subcategories** -- for more targeted results, browse njuskalo.hr, navigate to the subcategory you want, and use that URL as a Start URL. ### Integration and API access This actor can be called via the Apify API for programmatic access: ```bash curl "https://api.apify.com/v2/acts/studio-amba~njuskalo-scraper/runs" \ -X POST \ -H "Content-Type: application/json" \ -H "Authorization: Bearer YOUR_API_TOKEN" \ -d '{ "category": "auti", "searchQuery": "bmw", "maxResults": 50 }' ``` You can also schedule recurring runs, integrate with webhooks, or connect to Google Sheets, Slack, and other platforms through Apify integrations. ### Limitations - Njuskalo.hr requires Croatian residential proxies (geo-blocking). - The scraper extracts data from search/category listing pages. For full listing details (complete description, all images, seller contact), use individual listing URLs in Start URLs. - Rate limiting may apply for large-scale scraping. The scraper uses conservative concurrency settings to respect the site. - Njuskalo occasionally changes its HTML structure. If you notice missing data, please report it. # Actor input Schema ## `startUrls` (type: `array`): One or more Njuskalo category, search, or listing URLs. Go to njuskalo.hr, apply your filters, and paste the URL(s) here. Overrides category and searchQuery when provided. ## `category` (type: `string`): Njuskalo category to scrape. Used when Start URLs is empty. ## `searchQuery` (type: `string`): Optional keyword to search within the selected category (e.g., 'volkswagen golf', 'stan Zagreb', 'iPhone 15'). Appended as ?keywords=... to the category URL. ## `maxResults` (type: `integer`): Maximum number of listings to return. ## `proxyConfiguration` (type: `object`): REQUIRED: Njuskalo geo-blocks non-Croatian IPs. Use Apify Residential proxy with Croatia (HR) country. The default prefill is correct. ## Actor input object example ```json { "startUrls": [ { "url": "https://www.njuskalo.hr/auti" } ], "category": "auti", "searchQuery": "volkswagen golf", "maxResults": 20, "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ], "apifyProxyCountry": "HR" } } ``` # 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 = { "startUrls": [ { "url": "https://www.njuskalo.hr/auti" } ], "category": "auti", "searchQuery": "volkswagen golf", "maxResults": 20, "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ], "apifyProxyCountry": "HR" } }; // Run the Actor and wait for it to finish const run = await client.actor("studio-amba/njuskalo-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 = { "startUrls": [{ "url": "https://www.njuskalo.hr/auti" }], "category": "auti", "searchQuery": "volkswagen golf", "maxResults": 20, "proxyConfiguration": { "useApifyProxy": True, "apifyProxyGroups": ["RESIDENTIAL"], "apifyProxyCountry": "HR", }, } # Run the Actor and wait for it to finish run = client.actor("studio-amba/njuskalo-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 '{ "startUrls": [ { "url": "https://www.njuskalo.hr/auti" } ], "category": "auti", "searchQuery": "volkswagen golf", "maxResults": 20, "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ], "apifyProxyCountry": "HR" } }' | apify call studio-amba/njuskalo-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=studio-amba/njuskalo-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Njuskalo Scraper - Croatian Classifieds & Cars", "description": "Scrape listings from njuskalo.hr — Croatia's largest classifieds marketplace. Extract cars, real estate, electronics, jobs, and more with prices, photos, seller info, and category-specific attributes. No login required.", "version": "0.1", "x-build-id": "Mp2VkIQprOc4FOfsJ" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/studio-amba~njuskalo-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-studio-amba-njuskalo-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~njuskalo-scraper/runs": { "post": { "operationId": "runs-sync-studio-amba-njuskalo-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~njuskalo-scraper/run-sync": { "post": { "operationId": "run-sync-studio-amba-njuskalo-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": { "startUrls": { "title": "Start URLs", "type": "array", "description": "One or more Njuskalo category, search, or listing URLs. Go to njuskalo.hr, apply your filters, and paste the URL(s) here. Overrides category and searchQuery when provided.", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "category": { "title": "Category", "enum": [ "auti", "prodaja-stanova", "iznajmljivanje-stanova", "prodaja-kuca", "mobiteli", "informatika", "audio-video-foto", "od-glave-do-pete", "sve-za-dom", "posao", "turisticki-smjestaj", "hrana-pice" ], "type": "string", "description": "Njuskalo category to scrape. Used when Start URLs is empty.", "default": "auti" }, "searchQuery": { "title": "Search Query", "type": "string", "description": "Optional keyword to search within the selected category (e.g., 'volkswagen golf', 'stan Zagreb', 'iPhone 15'). Appended as ?keywords=... to the category URL." }, "maxResults": { "title": "Max Results", "minimum": 1, "maximum": 10000, "type": "integer", "description": "Maximum number of listings to return.", "default": 100 }, "proxyConfiguration": { "title": "Proxy Configuration", "type": "object", "description": "REQUIRED: Njuskalo geo-blocks non-Croatian IPs. Use Apify Residential proxy with Croatia (HR) country. The default prefill is correct." } } }, "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 } } } } } } } } } } ```