# OLX.ba Scraper - Bosnia Classifieds with Phones (`normdata/olx-ba-scraper`) Actor

Track Bosnian prices, spot fresh deals and build seller lead lists. Scrapes OLX.ba, the biggest classifieds site of Bosnia and Herzegovina: cars, real estate, parts, electronics and 330+ categories, with price, city, seller and photos, plus description, phones, email and every characteristic.

- **URL**: https://apify.com/normdata/olx-ba-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)

## 🛒 OLX.ba Scraper - Bosnia Classifieds with Phones

**OLX.ba Scraper** extracts **ads from OLX.ba**, the biggest classifieds site of Bosnia and Herzegovina, with about **6.7 million ads** in **330+ categories**: cars, real estate, vehicle parts, phones, computers, home, jobs, services and everything else. For each ad you get the **title, price in KM, city, canton, seller type, condition, photos and the key facts** of the card (year, mileage, fuel, m², rooms).

Turn on **Details** and every ad also comes with the **full description, the phone numbers and email the seller wrote, every characteristic, model, views, seller name, member since and price history**. Narrow the search with **categories, keyword, offer type, condition, seller type, cantons, cities, car makes and price**, or paste any OLX.ba link. Use it to **track Bosnian prices, spot fresh deals or build dealer and seller lead lists**.

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

### ✨ Why this scraper?

> - **All of OLX.ba, past the 10,000 limit**<br>
>   The site shows only 10,000 ads per search. Bigger searches are read in narrower parts (category, place, price), so you can get them all.
>
> - **Phones and email from the ad**<br>
>   With Details, the numbers the seller wrote in the ad come in +387 format, plus the email.
>
> - **Every characteristic**<br>
>   Gearbox, power, color, heating, floor, equipment… all the facts of the ad page, name → value.
>
> - **All the filters of the site**<br>
>   Categories, keyword, sale or rent, new or used, shops or private sellers, 17 cantons and regions, 138 cities, 137 car makes and price.
>
> - **Fast and easy**<br>
>   No proxy or login: 1,000 ads in about 15 seconds without Details. Or just paste OLX.ba 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 it compares

| | **This scraper** | Other OLX.ba scrapers (from their Store pages) |
| --- | --- | --- |
| Description, phones and email from the ad | ✅ with Details | ❌ |
| Every characteristic (gearbox, power, heating…) | ✅ with Details | ❌ (one only lists property facts) |
| Searches over 10,000 ads | ✅ read in parts | not said |
| Cantons, cities, car makes, seller type filters | ✅ | some |

### 🚀 How to scrape OLX.ba

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

### 💰 Pricing

#### How much does it cost to scrape OLX.ba?

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 | 0.014 | 0.0125 | 0.011 | 0.01 |
| **Details** (add-on): description, phones, email and characteristics of one ad | 0.007 | 0.006 | 0.0055 | 0.005 |

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

### 📦 What data you get

Vehicle fields appear on Vehicles ads and real estate fields on Real estate ads. Fields marked Details come only with the Details add-on.

### ⚙️ Input

**Example: used Volkswagen and Audi cars in Sarajevo canton, 10,000 to 25,000 KM, cheapest first, with phones:**

```json
{
  "categories": ["18"],
  "brands": ["89", "7"],
  "condition": "used",
  "cantons": ["9"],
  "minPrice": 10000,
  "maxPrice": 25000,
  "sort": "cheapest",
  "includeDetails": true
}
```

#### More input examples

**Flats for rent, every day (schedule it):**

```json
{
  "categories": ["23"],
  "offerType": "rent",
  "onlyNew": true,
  "monitorName": "flats-rent"
}
```

**Shops and dealers only, for a lead list:**

```json
{
  "categories": ["18"],
  "sellerType": "shop",
  "includeDetails": true
}
```

**Links (filters are ignored):**

```json
{
  "startUrls": [
    { "url": "https://olx.ba/pretraga?category_id=18&q=passat" },
    { "url": "https://olx.ba/artikal/81069986" }
  ]
}
```

### 🔗 Related scrapers

> - [999.md Scraper](https://apify.com/normdata/md999-scraper): Moldova classifieds with phones.
> - [Tap.az Scraper](https://apify.com/normdata/tap-az-scraper): Azerbaijan classifieds, cars, phones and more.
> - [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 OLX.ba API? Do I need an API key?

> OLX.ba has no public data API for developers. This Actor works as an OLX.ba 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 are Details slower?

> Each ad with Details needs one more call, and OLX.ba allows about 60 calls a minute. Without Details the scraper reads 200 ads per call.

#### Why do some ads have no phone?

> Phones come from what the seller wrote in the ad. The number behind the site's "show phone" button needs a login, so it is not read. Many dealers and private sellers write their number in the text.

#### Why are characteristics in Bosnian?

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

#### Is this an official OLX.ba tool?

> No. It is independent and not affiliated with OLX.ba. It reads only the ads OLX.ba publishes for buyers. Use phone numbers and emails in line with the personal data law of Bosnia and Herzegovina 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 (336, busiest first, with their ad count). Empty = all categories.

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

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

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

Order of results. Default: newest first. Price sorts leave out ads with no price.

## `includeDetails` (type: `boolean`):

Adds the description, the phone numbers and email the seller wrote, every characteristic, model, views, seller name and dates. One extra call per ad: olx.ba allows about 60 a minute, so details are slower and charged per ad.

## `offerType` (type: `string`):

For sale or for rent. Empty = both.

## `condition` (type: `string`):

New or used. Empty = both.

## `sellerType` (type: `string`):

Shops and companies or private sellers. Empty = both.

## `cantons` (type: `array`):

Cantons of the Federation, Republika Srpska and Brčko (17). Empty = whole country.

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

Cities and municipalities (138). A city in a picked canton narrows that canton.

## `brands` (type: `array`):

Car makes (137), for the Cars category (picked for you when no category is set).

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

Only ads from this price, in convertible marks (KM, BAM).

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

Only ads up to this price, in convertible marks (KM, BAM).

## `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`):

OLX.ba search pages with their filters (https://olx.ba/pretraga?category_id=18\&q=golf) or ad pages (https://olx.ba/artikal/81069986).

## Actor input object example

```json
{
  "maxItems": 10,
  "categories": [
    "18"
  ],
  "includeDetails": true
}
```

# 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": [
        "18"
    ],
    "includeDetails": true
};

// Run the Actor and wait for it to finish
const run = await client.actor("normdata/olx-ba-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": ["18"],
    "includeDetails": True,
}

# Run the Actor and wait for it to finish
run = client.actor("normdata/olx-ba-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": [
    "18"
  ],
  "includeDetails": true
}' |
apify call normdata/olx-ba-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,normdata/olx-ba-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/aViCZbMghO3HqfkzA/builds/67k8mIT2WtdPmiNC5/openapi.json
