# Oglasnik.hr Scraper - Croatia Classifieds with Phones (`normdata/oglasnik-scraper`) Actor

Track Croatian prices, spot fresh deals and build seller lead lists. Scrapes Oglasnik.hr, a top classifieds site of Croatia: cars, apartments, houses, land, furniture, machines and 600 categories, with price, place, map point, the full description, seller phones, email and every characteristic.

- **URL**: https://apify.com/normdata/oglasnik-scraper.md
- **Developed by:** [Norm Data](https://apify.com/normdata) (community)
- **Categories:** Lead generation, Other
- **Features:** Limited permissions
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $10.00 / 1,000 ads

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.
Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have.

Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes.
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.

Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md.

## 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.

Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.

For examples already wired to this Actor's own input schema, see the [API](#api) section below.

Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).

# README

![Norm Data](https://raw.githubusercontent.com/FabriAV/normdata/refs/heads/main/assets/banner_norm2.png)

## 🇭🇷 Oglasnik.hr Scraper - Croatia Classifieds with Phones

**Oglasnik.hr Scraper** extracts **ads from Oglasnik.hr**, one of the biggest classifieds sites of Croatia, with about **290,000 ads** in **600+ categories**: cars, real estate, vehicle parts, home, electronics, jobs, services and everything else. For each ad you get the **title, price in EUR, county, city, district, coordinates, full description, the seller's phone numbers, email, seller name and type, photos and every attribute** of the ad.

Car ads also come with **make, model, year, mileage, power, engine, fuel and gearbox**, and real estate ads with **area, rooms, floor and build year**. Narrow the search with **categories, keyword, counties, cities, price, car makes, year and mileage**, or paste any Oglasnik.hr link. Use it to **track Croatian prices, spot fresh deals or build dealer and agency lead lists**.

> 👉 **Try it now:** press **Start**. The ready-made input gives you 10 cars with phones in a few seconds.<br>
> 💰 **$0.014 per ad** on the Free plan (10 ads per run), from $0.0125 on paid plans. Phones and description included. [See pricing](#-pricing)

### ✨ Why this scraper?

> - **All of Oglasnik.hr, past the 10,000 limit**<br>
>   The site shows only 10,000 ads per search. Bigger searches are read in narrower parts (category, price, place), so you can get them all.
>
> - **Phones in every row, no add-on**<br>
>   The seller's phone numbers come in +385 format, plus any email written in the ad, with no extra cost.
>
> - **Every attribute**<br>
>   Make, model, mileage, power, area, rooms, floor, equipment… all the facts of the ad, name → value.
>
> - **All the filters of the site**<br>
>   607 categories, keyword, 22 counties, their cities, price, 67 car makes, year and mileage.
>
> - **Fast and easy**<br>
>   No proxy or login: 100 ads per call, 1,000 ads in a few seconds. Or just paste Oglasnik.hr search or ad links.
>
> - **Apify platform**<br>
>   Schedule daily runs, get only new ads, export to Excel or CSV, or connect Google Sheets, Zapier and Make.

### 🚀 How to scrape Oglasnik.hr

1. Create a free Apify account.
2. Pick categories, a keyword and filters, or keep the ready-made input.
3. Click **Start** and download the ads as Excel, CSV or JSON from the **Output** tab.

### 💰 Pricing

#### How much does it cost to scrape Oglasnik.hr?

You pay a one-time **$0.003** per run, plus a price for each ad saved:

| Charged for | Free | Bronze | Silver | Gold+ |
| --- | --- | --- | --- | --- |
| **Ad**: One ad saved to the dataset, with phones and description | 0.014 | 0.0125 | 0.011 | 0.01 |

Example: 1,000 cars with phones cost about **$12.50** on Bronze. No proxy or compute costs on top.

### 📦 What data you get

| Field | Description |
| --- | --- |
| `imageUrl` | Main photo. |
| `id` | Oglasnik.hr ad number. |
| `title` | Ad title. |
| `topCategory`, `category` | Section (in English) and category path. |
| `offerType` | Sale, rent, wanted or offered. |
| `price`, `currency` | Price in euros (empty for "price on request"). |
| `county`, `city`, `district`, `latitude`, `longitude` | County, city or municipality, district and the map point of that place. |
| `description` | The full text of the seller. |
| `email` | Email the seller wrote in the ad. |
| `sellerName`, `sellerId`, `sellerType` | Seller or shop name, seller number and type (shop, company or private). |
| `make`, `model`, `year`, `mileageKm`, `powerKw`, `engineCc`, `fuel`, `gearbox` | Vehicles: make, model, year, mileage, power, engine size, fuel and gearbox. |
| `areaM2`, `rooms`, `floor`, `buildYear` | Real estate: area, rooms, floor and building year. |
| `adPlan`, `photosCount` | Ad package (Basic, Premium, Platinum…) and number of photos. |
| `isPromoted` | Paid placement at the top of the first page. |
| `attributes` | Every characteristic of the ad (body type, color, heating, parking…), name → value. |
| `phones` | Phone numbers of the seller, in +385 format. |
| `images` | Every photo in full size. |
| `url` | Ad link. |
| `sellerUrl` | Seller page with all their ads. |
| `publishedAt`, `expiresAt` | When the ad was published or renewed, and when it expires. |
| `scrapedAt` | When this row was saved. |

Vehicle fields appear on Vehicles and boats ads and real estate fields on Real estate ads.

### ⚙️ Input

| Section | What it's for |
| --- | --- |
| **Maximum results** | Always first, caps the whole run. Empty means no limit. |
| **What to scrape** | Categories, keyword and sort. |
| **Filters** | Counties, cities and municipalities, minimum price (€), maximum price (€), car makes, cars: from year, cars: up to year and cars: maximum mileage (km). |
| **Monitoring** | Only new ads and monitor name. |
| **Links** | Links instead of the fields above. Filters are ignored with links. |

**Example: used Volkswagen and BMW cars from 2018 to 2021, under 100,000 km, 10,000 to 25,000 EUR, cheapest first:**

```json
{
  "makes": ["1206", "88"],
  "minYear": 2018,
  "maxYear": 2021,
  "maxMileage": 100000,
  "minPrice": 10000,
  "maxPrice": 25000,
  "sort": "cheapest"
}
```

#### More input examples

**Flats for sale in Zagreb, every day (schedule it):**

```json
{
  "categories": ["231"],
  "counties": ["7442"],
  "onlyNew": true,
  "monitorName": "zagreb-flats"
}
```

**Keyword over the whole site:**

```json
{
  "keyword": "bicikl",
  "maxItems": 500
}
```

**Links (filters are ignored):**

```json
{
  "startUrls": [
    { "url": "https://oglasnik.hr/stanovi-prodaja?sort=low-price" },
    { "url": "https://oglasnik.hr/prodaja-automobila/cupra-leon-1-5-etsi-dsg-30-400-00-oglas-7195466" }
  ]
}
```

### 🔗 Related scrapers

> - [OLX.ba Scraper](https://apify.com/normdata/olx-ba-scraper): Bosnia classifieds with phones.
> - [999.md Scraper](https://apify.com/normdata/md999-scraper): Moldova classifieds with phones.
> - [Mobile.bg Scraper](https://apify.com/normdata/mobile-bg-scraper): Bulgaria cars.
> - [SS.com Scraper](https://apify.com/normdata/ss-com-scraper): Latvia classifieds.

### ❓ FAQ and troubleshooting

#### Is there an Oglasnik.hr API? Do I need an API key?

> Oglasnik.hr has no public data API for developers. This Actor works as an Oglasnik.hr API alternative: it reads the public ads and gives you clean JSON, CSV or Excel, with no API key, no login and no code to maintain. You can also call it from your own code with the Apify API, or from an AI agent through MCP.

#### Why do I get only 10 ads?

> On the Apify free plan each run saves up to 10 results, so you can try it before paying. Any paid plan removes the limit.

#### Why do some ads have no county or city?

> Some shop feeds (for example big online stores) publish ads with no place. They are still saved, with empty place fields.

#### Why are the first ads marked as promoted?

> Oglasnik.hr shows paid ads at the top of the first page whatever the sort. They are saved with **isPromoted** true, so you can keep or drop them.

#### Why are attributes in Croatian?

> They are written as the site shows them. Numbers like price, year, mileage and area are plain numbers.

#### Is this an official Oglasnik.hr tool?

> No. It is independent and not affiliated with Oglasnik.hr. It reads only the ads Oglasnik.hr publishes for buyers. Dating and personal contact sections are skipped. Use phone numbers and emails in line with the GDPR and do not send spam.

### 📧 Contact

Need a scraper for a different site, or found something wrong with this one? norm.data.scrapers@gmail.com

# Actor input Schema

## `maxItems` (type: `integer`):

Stop after this many ads in total. Leave empty for no limit. The Apify Free plan is always capped at 10.

## `categories` (type: `array`):

Categories (607, busiest first, with their ad count). Empty = every section, one after another.

## `keyword` (type: `string`):

Search words, as in the site search box (for example "golf" or "stan zagreb").

## `sort` (type: `string`):

Order of results inside each category. Default: newest first. Paid promoted ads lead the first page, as on the site (marked isPromoted).

## `counties` (type: `array`):

Croatian counties (22), plus ads from abroad. Empty = whole country.

## `cities` (type: `array`):

Cities and municipalities (593). A city in a picked county narrows that county.

## `minPrice` (type: `integer`):

Only ads from this price, in euros.

## `maxPrice` (type: `integer`):

Only ads up to this price, in euros.

## `makes` (type: `array`):

Car makes (67), for Cars for sale (picked for you when no category is set).

## `minYear` (type: `integer`):

Only cars made in this year or later.

## `maxYear` (type: `integer`):

Only cars made in this year or earlier.

## `maxMileage` (type: `integer`):

Only cars with at most this many kilometres.

## `onlyNew` (type: `boolean`):

Skip ads saved by earlier runs with the same monitor name.

## `monitorName` (type: `string`):

Runs with the same name share their history. Use a different name for each schedule.

## `startUrls` (type: `array`):

Oglasnik.hr category pages with their filters and sort (https://oglasnik.hr/stanovi-prodaja?sort=low-price) or ad pages (https://oglasnik.hr/prodaja-automobila/…-oglas-7195464).

## Actor input object example

```json
{
  "maxItems": 10,
  "categories": [
    "4"
  ]
}
```

# Actor output Schema

## `results` (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 '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "maxItems": 10,
    "categories": [
        "4"
    ]
};

// Run the Actor and wait for it to finish
const run = await client.actor("normdata/oglasnik-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 '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {
    "maxItems": 10,
    "categories": ["4"],
}

# Run the Actor and wait for it to finish
run = client.actor("normdata/oglasnik-scraper").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "maxItems": 10,
  "categories": [
    "4"
  ]
}' |
apify call normdata/oglasnik-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,normdata/oglasnik-scraper"
        }
    }
}
```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/fUrOTlWl3GRfq5YyG/builds/bYKSIFOXNGSBHvTsS/openapi.json
