# OLX.ro Scraper & Price-Drop Monitor (`opaline_loggerhead/olx-ro-monitor`) Actor

OLX.ro scraper for any search or category: get only NEW ads & PRICE DROPS since your last run. Price, location, seller type, photos, details. 🇷🇴 Anunțuri OLX.ro: doar anunțuri noi și scăderi de preț de la ultima rulare.

- **URL**: https://apify.com/opaline_loggerhead/olx-ro-monitor.md
- **Developed by:** [Osirus Jack](https://apify.com/opaline_loggerhead) (community)
- **Features:** Limited permissions
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $1.50 / 1,000 listings

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.

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

## OLX.ro Scraper & Price-Drop Monitor 🏷️📉

**🇬🇧 English** · [🇷🇴 Română](#pe-românește)

Scrape any search or category on **[olx.ro](https://www.olx.ro)**, Romania's largest classifieds site (phones, cars, real estate, furniture, jobs and more), and **get only what changed since your last run: new ads and price drops.**

Instead of refreshing OLX all day, schedule this Actor and get a short list of fresh ads and price cuts by email, Slack or Google Sheets. Perfect for resellers, deal hunters and anyone tracking a market.

### Who is it for?

- **Resellers & flippers:** be first to message when an underpriced item appears.
- **Small businesses:** watch competitors' prices and new stock.
- **Buyers:** track one model (e.g. "iPhone 15 Pro") and get pinged on price drops.
- **Analysts & AI agents:** clean JSON with price, location, seller type and item details.

### What you get per listing

| Field | Meaning |
|---|---|
| `changeType` | `new`, `price_drop`, `price_increase`, `unchanged` |
| `price`, `currency`, `priceLabel`, `negotiable` | price as shown on OLX |
| `previousPrice`, `priceChangePct` | old price and % change (monitor mode) |
| `city`, `district`, `region`, `latitude`, `longitude` | approximate location |
| `isBusiness`, `sellerName` | private seller or business |
| `params` | category details, e.g. model, condition, memory, area |
| `title`, `description`, `url`, `imageUrls` | ad text, link and photos |
| `createdAt`, `refreshedAt`, `validTo`, `firstSeenAt` | dates |

Export as JSON, CSV or Excel, or pull it through the Apify API.

### How to use

1. Go to olx.ro, run your search with any filters, and copy the URL from your browser. Examples:
   - `https://www.olx.ro/electronice-si-electrocasnice/telefoane-mobile/q-iphone-15/`
   - `https://www.olx.ro/imobiliare/apartamente-garsoniere-de-vanzare/cluj-napoca/`
2. Paste it into **Search URLs**. Add as many searches as you like.
3. Choose a **Mode**:
   - **All listings:** a full snapshot.
   - **Only new listings & price changes:** the monitor. The first run remembers everything; every later run returns only changes.
4. Click **Start**. To monitor, add a **Schedule** (e.g. every morning at 8:00) and connect an integration (email, Slack, Google Sheets, Make or Zapier) to get alerts automatically.

#### Example input

```json
{
  "startUrls": [
    {
      "url": "https://www.olx.ro/electronice-si-electrocasnice/telefoane-mobile/q-iphone-15/"
    }
  ],
  "mode": "changes",
  "priceChangeTypes": "drops",
  "minPriceDropPct": 3,
  "maxItems": 500,
  "maxPagesPerUrl": 10,
  "stateStoreName": "olx-ro-my-watchlist"
}
```

💡 Use a **different `stateStoreName` for each watch-list** you schedule, so they don't mix.

### Pricing

You pay only for results saved: **$1.50 per 1,000 results**. In monitor mode you pay only for the new listings and price changes you receive, not for every listing checked, so daily monitoring stays cheap. The Actor stops automatically when your maximum cost per run is reached.

### Tips

- OLX shows at most **25 pages (about 1,000 ads) per search**. For bigger markets, split your search by price range, region or category and add each URL.
- Promoted ads can appear on several pages; the Actor removes duplicates automatically.
- If runs get blocked, switch the proxy to **RESIDENTIAL** with country **RO**.

***

## 🇷🇴 Pe românește

Extrage orice căutare sau categorie de pe **[olx.ro](https://www.olx.ro)** (telefoane, mașini, imobiliare, mobilă, joburi și altele) și **primește doar ce s-a schimbat de la ultima rulare: anunțuri noi și scăderi de preț.**

**Pentru cine?**

- **Revânzători:** fii primul care scrie când apare un produs sub preț.
- **Firme mici:** urmărește prețurile și stocul concurenței.
- **Cumpărători:** urmărește un model (de exemplu „iPhone 15 Pro”) și află când scade prețul.

**Cum îl folosești**

1. Fă căutarea pe olx.ro cu ce filtre vrei (categorie, preț, oraș, stare…).
2. Copiază linkul din browser și lipește-l în **Search URLs**.
3. Alege **Mode**: *All listings* sau *Only new listings & price changes* (monitorizare).
4. Apasă **Start** și, pentru alerte zilnice, adaugă un **Schedule** și o integrare (email, Slack, Google Sheets).

**Preț:** plătești doar pentru rezultatele salvate.

**Bine de știut:** OLX afișează maximum 25 de pagini (aproximativ 1.000 de anunțuri) pe căutare. Pentru piețe mari, împarte căutarea pe intervale de preț sau pe județe.

***

### Legal

This Actor reads publicly available listing pages, the same ones any visitor sees, without logging in. You are responsible for using the data in line with olx.ro's terms and the GDPR, and for not using personal data (such as private sellers' names) for unsolicited marketing.

# Actor input Schema

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

Run a search on olx.ro with any filters you like, then paste the URL from your browser. Add several URLs to watch several searches at once. Example: https://www.olx.ro/electronice-si-electrocasnice/telefoane-mobile/q-iphone-15/

## `mode` (type: `string`):

'all' returns every listing found. 'changes' returns only listings that are new or whose price changed since the previous run with the same state store, perfect for a daily schedule.

## `priceChangeTypes` (type: `string`):

Which price changes count as a 'change' in monitor mode.

## `minPriceDropPct` (type: `number`):

Ignore tiny price adjustments. Example: 2 = only report drops of at least 2%.

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

Stop after this many results are saved (across all URLs). 0 = no limit.

## `maxPagesPerUrl` (type: `integer`):

How many result pages to read for each search URL. olx.ro shows at most 25 pages per search.

## `stateStoreName` (type: `string`):

Named storage that remembers listings between runs. Use a different name for each separate watch-list you schedule.

## `proxyConfiguration` (type: `object`):

Apify Proxy is recommended. If you get blocked, switch to RESIDENTIAL proxies with country RO.

## Actor input object example

```json
{
  "startUrls": [
    {
      "url": "https://www.olx.ro/electronice-si-electrocasnice/telefoane-mobile/q-iphone-15/"
    }
  ],
  "mode": "all",
  "priceChangeTypes": "drops",
  "minPriceDropPct": 0,
  "maxItems": 200,
  "maxPagesPerUrl": 10,
  "stateStoreName": "olx-ro-monitor-state",
  "proxyConfiguration": {
    "useApifyProxy": true
  }
}
```

# Actor output Schema

## `listings` (type: `string`):

All listings saved by this run, as JSON. Add ?format=csv or ?format=xlsx for a spreadsheet.

# 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 = {
    "startUrls": [
        {
            "url": "https://www.olx.ro/electronice-si-electrocasnice/telefoane-mobile/q-iphone-15/"
        }
    ],
    "proxyConfiguration": {
        "useApifyProxy": true
    }
};

// Run the Actor and wait for it to finish
const run = await client.actor("opaline_loggerhead/olx-ro-monitor").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 = {
    "startUrls": [{ "url": "https://www.olx.ro/electronice-si-electrocasnice/telefoane-mobile/q-iphone-15/" }],
    "proxyConfiguration": { "useApifyProxy": True },
}

# Run the Actor and wait for it to finish
run = client.actor("opaline_loggerhead/olx-ro-monitor").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 '{
  "startUrls": [
    {
      "url": "https://www.olx.ro/electronice-si-electrocasnice/telefoane-mobile/q-iphone-15/"
    }
  ],
  "proxyConfiguration": {
    "useApifyProxy": true
  }
}' |
apify call opaline_loggerhead/olx-ro-monitor --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,opaline_loggerhead/olx-ro-monitor"
        }
    }
}
```

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/dKKQ0AjdMZ7JIP3HL/builds/qgslMkyrMzZcN9KDt/openapi.json
