OLX Bulgaria Classifieds Scraper

Scrape public listings from OLX.bg search, category, and listing pages.

Use this actor to collect Bulgarian classifieds data for price monitoring, resale research, lead generation, inventory tracking, and regional marketplace analysis.

---

What does OLX Bulgaria Classifieds Scraper do?

OLX Bulgaria Classifieds Scraper extracts structured listing data from public OLX.bg pages.

It can start from a keyword search or from exact OLX.bg URLs that already include your category, location, and filter choices.

The actor returns clean rows with listing titles, prices, URLs, locations, seller information, descriptions, attributes, images, and timestamps.

Who is it for?

Resale and arbitrage teams

Track prices for phones, electronics, vehicles, furniture, tools, and other high-volume categories.

Market researchers

Measure supply, pricing ranges, seller behavior, promoted listings, and regional inventory depth.

Lead generation teams

Find public business sellers and listings that match your target category or geography.

Ecommerce operators

Monitor competitor offers and local marketplace prices in Bulgaria.

Data teams

Feed OLX.bg listing data into dashboards, warehouses, alerting systems, and enrichment workflows.

Why use this actor?

• ⚡ Uses fast HTTP scraping instead of a browser when possible.
• 🇧🇬 Designed for OLX Bulgaria pages and Bulgarian category/search URLs.
• 🧾 Produces one clean dataset row per classified listing.
• 🖼️ Captures image URLs for visual review and catalog matching.
• 🏷️ Keeps OLX attributes as structured key-value data.
• 📍 Separates city, region, district, and full location path.
• 💰 Extracts both display price and numeric price value when available.
• 🔁 Supports pagination limits to control run cost.

What data can you extract from OLX.bg?

Field	Description
listingId	OLX listing identifier
title	Listing title
url	Public listing URL
price	Display price shown by OLX.bg
priceValue	Numeric price value when available
currency	Currency code, usually BGN
location	Full OLX location path
city	City name
region	Region name
district	District name when available
postedAt	Original listing creation time
refreshedAt	Last refresh or bump time
category	Category/type metadata
breadcrumbs	Listing breadcrumb labels when detail pages are opened
sellerName	Public seller/contact name
sellerType	Business/private signal when available
sellerProfileUrl	Public seller profile URL
sellerId	OLX seller ID
description	Clean text description
attributes	OLX listing parameters and specs
imageUrls	Listing image URLs
isPromoted	Whether OLX marks the listing as promoted
isHighlighted	Whether the listing is highlighted
isBusiness	Whether OLX marks seller/listing as business
hasPhone	Whether phone contact is publicly indicated
phone	Phone only if visible in public HTML
scrapedAt	Actor scrape timestamp

How much does it cost to scrape OLX Bulgaria classifieds?

This actor uses pay-per-event pricing.

You pay a $0.005 run-start event and a tiered per-result event for each listing saved.

The BRONZE per-listing price is $0.001, with lower prices on higher Apify plan tiers and $0.00115 on the FREE tier.

Use low maxResults values for quick checks and larger limits for production exports.

How to scrape OLX.bg in 5 steps

1. Open OLX.bg in your browser.
2. Search or filter the category you need.
3. Copy the OLX.bg URL into startUrls.
4. Set maxResults to the number of listings you need.
5. Run the actor and export the dataset as JSON, CSV, Excel, or via API.

Input configuration

startUrls

Paste OLX.bg search, category, or listing URLs.

Examples:

• https://www.olx.bg/elektronika/telefoni/q-iphone/
• https://www.olx.bg/nedvizhimi-imoti/
• https://www.olx.bg/avtomobili/

searchQuery

Used only when startUrls is empty.

Example: iphone, velosiped, apartament, or bmw.

maxResults

Maximum number of listings to save.

Use 20 for a quick test and increase it for production runs.

includeDetails

When enabled, the actor opens each listing page.

This can enrich breadcrumbs and detail-only fields, but it is slower.

Leave it off when search-result data is enough.

maxPages

Controls how many paginated result pages are checked for each start URL.

maxRequestRetries

Controls retry attempts for temporary request failures.

Example input

{
  "startUrls": [
    { "url": "https://www.olx.bg/elektronika/telefoni/q-iphone/" }
  ],
  "maxResults": 20,
  "includeDetails": false,
  "maxPages": 2
}

Example output

{
  "listingId": "147598379",
  "title": "Apple iPhone 17 256GB Lavender",
  "url": "https://www.olx.bg/d/ad/example.html",
  "price": "1562.71 лв. / 799 €",
  "priceValue": 1562,
  "currency": "BGN",
  "city": "гр. София",
  "sellerName": "Sweet Deals",
  "imageUrls": ["https://frankfurt.apollo.olxcdn.com/..."],
  "isPromoted": false,
  "scrapedAt": "2026-05-18T09:00:00.000Z"
}

Tips for better results

• Use exact OLX.bg URLs when you need a specific city or category.
• Keep includeDetails disabled for faster monitoring runs.
• Enable includeDetails when breadcrumbs are important.
• Increase maxPages if OLX has many results for your search.
• Export as CSV for quick spreadsheet analysis.
• Export as JSON when you need nested attributes and imageUrls.

Common OLX Bulgaria use cases

Price monitoring

Track average asking prices for used electronics, cars, furniture, and property listings.

Inventory monitoring

Watch how many listings appear in a category or region over time.

Seller intelligence

Identify business sellers, repeated sellers, and public seller profiles.

Lead sourcing

Collect public listing signals and route promising opportunities to your CRM.

Market research

Compare regional supply and price differences across Bulgarian cities.

Integrations

You can connect the dataset to many downstream tools.

• 📊 Google Sheets for quick manual review.
• 🧱 Airtable for lightweight marketplace databases.
• 🧮 BigQuery or Snowflake for analytics.
• 🔔 Slack or email alerts when new matching listings appear.
• 🧩 Zapier or Make for no-code workflows.
• 🛒 Ecommerce repricing tools for competitive intelligence.

API usage with Node.js

import { ApifyClient } from 'apify-client';

const client = new ApifyClient({ token: process.env.APIFY_TOKEN });
const run = await client.actor('automation-lab/olx-bulgaria-classifieds-scraper').call({
  startUrls: [{ url: 'https://www.olx.bg/elektronika/telefoni/q-iphone/' }],
  maxResults: 20
});

const { items } = await client.dataset(run.defaultDatasetId).listItems();
console.log(items);

API usage with Python

from apify_client import ApifyClient
import os

client = ApifyClient(os.environ['APIFY_TOKEN'])
run = client.actor('automation-lab/olx-bulgaria-classifieds-scraper').call(run_input={
    'startUrls': [{'url': 'https://www.olx.bg/elektronika/telefoni/q-iphone/'}],
    'maxResults': 20,
})
items = client.dataset(run['defaultDatasetId']).list_items().items
print(items)

API usage with cURL

curl -X POST "https://api.apify.com/v2/acts/automation-lab~olx-bulgaria-classifieds-scraper/runs?token=$APIFY_TOKEN" \
  -H 'Content-Type: application/json' \
  -d '{"startUrls":[{"url":"https://www.olx.bg/elektronika/telefoni/q-iphone/"}],"maxResults":20}'

MCP integration

Use this actor from Claude Desktop, Claude Code, or other MCP-compatible clients through Apify MCP Server.

MCP URL:

https://mcp.apify.com?tools=automation-lab/olx-bulgaria-classifieds-scraper

Claude Code setup:

$claude mcp add --transport http apify "https://mcp.apify.com?tools=automation-lab/olx-bulgaria-classifieds-scraper"

Claude Desktop, Cursor, or VS Code MCP JSON setup:

{
  "mcpServers": {
    "apify": {
      "url": "https://mcp.apify.com?tools=automation-lab/olx-bulgaria-classifieds-scraper"
    }
  }
}

Example prompts:

• "Scrape 30 iPhone listings from OLX Bulgaria and summarize price ranges."
• "Find OLX.bg listings in this category and group them by city."
• "Monitor this OLX.bg URL and tell me which listings are promoted."

Data quality notes

OLX.bg can expose different fields by category.

Some listings include detailed attributes such as model, condition, memory, or delivery options.

Other categories may have different parameter names.

The actor keeps these values in the flexible attributes object.

Phone and contact data

The actor only returns phone data if it is present in public page HTML.

OLX often masks phone numbers or requires interactive reveal flows.

This actor does not bypass login walls or access private data.

Pagination behavior

The actor follows OLX result pages by adding the page query parameter.

It stops when it reaches maxResults, maxPages, or the number of pages reported by OLX.

Duplicate listing IDs are skipped.

Performance

The actor is HTTP-based and normally runs quickly for small and medium jobs.

Opening detail pages increases request count, so use includeDetails only when needed.

FAQ

Troubleshooting

I got fewer results than requested. Why?

The selected OLX URL may have fewer available listings, or maxPages may be too low.

Increase maxPages or use a broader category/search URL.

Why is phone empty?

OLX.bg frequently masks phone numbers. The actor only returns publicly visible phone values.

Why are some attributes missing?

OLX categories have different parameter sets. Missing fields usually mean OLX did not provide that attribute for the listing.

Legality

This actor extracts publicly available information from OLX.bg pages.

You are responsible for using the data in accordance with applicable laws, OLX terms, privacy rules, and Apify policies.

Do not use scraped data for spam, harassment, or prohibited profiling.

Related scrapers

Other automation-lab actors can help with regional marketplace and ecommerce workflows.

• https://apify.com/automation-lab/zillow-scraper
• https://apify.com/automation-lab/pisos-com-real-estate-scraper
• https://apify.com/automation-lab/tradera-scraper
• https://apify.com/automation-lab/facebook-marketplace-scraper

Changelog

0.1

Initial OLX Bulgaria classifieds extraction for public search/category/listing pages.

Support

If a run fails or output looks incomplete, share the run URL and input with support.

Include the OLX.bg URL you expected to scrape and the number of listings you expected.