Njuskalo Listing Extractor

A premium, production grade classified ads scraper built specifically for Croatia's largest online marketplace, Njuskalo.hr. This actor extracts and structures publicly available listing data from search results and category pages in real time, delivering clean datasets for automobiles, real estate, electronics, jobs, and more.

Equipped with a built-in smart network routing layer and autonomous browser simulation, this extractor automatically handles geo-blocking, anti-bot protections, and rate limits. This means you do not need to purchase, configure, or manage your own proxy subscriptions.

---

Key Features

• Multi URL Category Queuing: Scrape multiple search results or category listing URLs in a single run.
• High Speed Extraction: Bypasses deep detail page fetches, scanning search results cards directly. This results in up to 10 times faster crawling speeds and significantly reduced execution costs.
• Built-In Smart Proxies: Seamlessly routes requests through localized connections to bypass Croatia-only geo-restrictions and anti-bot systems.
• Adaptive Pagination: Intelligent page detection automatically clicks through results until your specified limit is met or there are no more listings.
• Pristine Data Cleanups: Automatically removes empty or null values (including location, descriptions, and badges) to deliver a perfectly compact, ready to analyze dataset.
• Per URL Limit Control: Set custom maximum limits per category link, giving you precise control over your budget and data volume.

---

Use Cases

• Automotive Market Analysis: Monitor listings in the vehicle category to analyze price trends, age distribution, and popularity across brands.
• Real Estate Monitoring: Track apartments, houses, and commercial property prices across Zagreb and other Croatian regions to spot high-yield investment opportunities.
• Competitor Intelligence: Keep continuous track of newly posted ads in your business niche and get immediate market supply updates.
• Lead Generation: Scan jobs, services, and local trade listings to discover active service providers and business entities.

---

Extracted Data Fields

The extractor collects all key listing parameters displayed on the search result cards. To maintain maximum data efficiency, optional fields that are not present or populated on a specific listing are completely removed from the output record.

The following fields are extracted and structured:

Output Field	Type	Description
listingId	string	Unique classified ad identifier on Njuskalo.
listingTitle	string	Full public title of the classified ad.
price	string	Displayed price string including currency formatting.
currency	string	Normalized currency code (such as EUR or HRK).
location	string	Listed city, neighborhood, or region (removed if empty).
postedDate	string	Raw timestamp or text indicating when the listing was posted or bumped.
url	string	Permanent direct link to the listing.
thumbnailUrl	string	URL of the primary listing image.
category	string	Direct category or breadcrumb path (removed if empty).
badges	array	Promoted tags like "Top", "Istaknuto", or "Provjereno" (removed if empty).
scrapedAt	string	ISO timestamp of when the record was processed.

Sample Output Record

{
  "listingId": "41526374",
  "listingTitle": "Audi A4 Avant 2.0 TDI, S-line, 2019. g, izvrsno stanje",
  "price": "21.400 €",
  "currency": "EUR",
  "location": "Grad Zagreb, Črnomerec",
  "postedDate": "2026-06-02T15:30:00Z",
  "url": "https://www.njuskalo.hr/auti/audi-a4-avant-2.0-tdi-oglas-41526374",
  "thumbnailUrl": "https://img.njuskalo.hr/image-w920x690/auti/audi-a4-avant-2.0-tdi-slika-12345.jpg",
  "category": "Osobni automobili",
  "badges": [
    "Istaknuti oglas",
    "Provjereno"
  ],
  "scrapedAt": "2026-06-03T15:00:24.123Z"
}

---

Input Configuration

To run the extractor, provide your desired search or category links from Njuskalo.hr.

Configuration Properties

Parameter	Type	Default	Description
startUrls	array	Required	One or more Njuskalo.hr category, search, or filtered result page URLs.
maxItems	integer	25	Maximum number of listings to extract per start URL.
requestTimeoutSecs	integer	30	Network request timeout in seconds. Increase for slow connections.

Sample Input JSON

{
  "startUrls": [
    "https://www.njuskalo.hr/auti/abarth",
    "https://www.njuskalo.hr/iznajmljivanje-stanova/zagreb"
  ],
  "maxItems": 50,
  "requestTimeoutSecs": 30
}

---

How It Works Under the Hood

1. URL Validation: The actor parses and normalizes each input link, validating that they belong to the njuskalo.hr domain and filtering out invalid links.
2. Croatian Traffic Routing: It sends GET requests to pages using a built-in proxy layer that routes connections through Croatian IP addresses, completely bypassing geo-fencing.
3. Card Detection: It reads the page HTML and parses classified cards (regular, promoted, and featured listings).
4. Data Compaction: Any of the optional fields (such as category, location, or badges) that are null, empty, or empty lists are stripped out of the listing object before pushing.
5. Page Navigation: The extractor checks the pagination container for active next-page elements. If more listings are available and the per-URL limit is not reached, it constructs the next page URL (by appending ?page=X) and continues.
6. Dataset Storage: Records are saved immediately to your default Apify dataset during the run.

---

FAQ and Troubleshooting

Why does the scraper require specialized connection routing?

Njuskalo.hr uses strict geo-blocking. Requests from outside Croatia, or from generic data centers, are blocked or presented with impossible CAPTCHAs. This actor has localized connection routing built directly into its core, allowing it to crawl the marketplace smoothly without requiring any custom proxy setup from you.

Is there a limit on how many items can be extracted?

You can scrape hundreds of items in a single run. However, we recommend setting a reasonable limit (like 25 to 100 items per URL) to ensure your runs remain fast, cost-effective, and safe from site changes.

Can this actor extract seller telephone numbers?

No. Njuskalo hides telephone numbers behind dynamic buttons that require a verified user login and manual browser interaction. To protect your privacy and ensure compliance, this actor only extracts public, search-level classified ad data.

What should I do if a run returns fewer items than maxItems?

This occurs if the search or category you entered has fewer total listings available than your limit, or if you have reached the end of the available pages. The actor will log a message and cleanly exit when no further pages are found.