Bazaraki Cyprus Classifieds Scraper

Scrape Bazaraki.com — Cyprus's largest classifieds marketplace, covering real estate, cars & motors, jobs, electronics, and general items across all five districts of Cyprus. Search by keyword, browse all 15 top-level categories directly (no keyword required), drill into Real Estate / Motors subcategories, filter by city and price, or fetch specific listings by URL.

What this actor does

• Two modes: search (keyword + category/subcategory/city/price/sort browsing) and byUrls (fetch specific listing URLs you already have)
• 15 categories, all directly browsable without a keyword: real estate for sale/rent, motors, jobs, phones, electronics, clothing, computers/gaming, home/garden, hobbies/sports, animals, health/beauty, kids' stuff, services, business, or all
• 33 subcategories for Real Estate for Sale/to Rent and Motors (e.g. houses, apartments, cars, motorbikes, boats) for finer-grained browsing than the top-level category
• 5 cities: Nicosia, Limassol, Larnaca, Paphos, Famagusta, or all Cyprus
• 4 sort orders: most relevant, newest, cheapest, most expensive
• Price range filter: min/max in EUR
• Bedrooms filter (Real Estate): studio, 1–5, or 6+
• Condition filter: new or used (Real Estate, Motors, Electronics, and most other categories)
• Full detail enrichment (optional): category breadcrumb path, full description, precise coordinates, full photo gallery
• Empty fields are omitted — every record only contains fields Bazaraki actually published for that listing

Output per listing

• id, title
• price, currencySymbol, currencyCode
• pricePerSquareMeter (real estate listings, requires includeDetails)
• cityName, areaName, location — from the search page; includeDetails refines location/cityName from the listing's own map
• latitude, longitude (requires includeDetails; present when the listing has a map pin)
• categoryPath[], categoryName (breadcrumb, requires includeDetails)
• description (full text, requires includeDetails)
• features[] — raw feature chips from the search card (e.g. bedroom count, area, condition) when Bazaraki shows them; unlabeled by the site itself, see Limitations
• characteristics — full labeled key/value map from the listing's own "characteristics" panel, exactly as Bazaraki labels it for that category (e.g. {"Property area": "77 m²", "Mileage (in km)": "22826 km"}); requires includeDetails
• Promoted typed fields parsed from characteristics when present for that listing's category, requires includeDetails:
  • Real estate: bedrooms, bathrooms, propertyAreaSqm, condition, parking, includedAmenities[], energyEfficiency, itemType, floor, furnishing, constructionYear, airConditioning
  • Motors: year, mileageKm, gearbox, fuelType, bodyType, driveType, enginePower, engineSize, seats, colour, extras[], referenceNumber
  • Other categories (phones, electronics, etc.): condition, kind, itemType when Bazaraki publishes them
• imageUrl, imageUrls[], imageCount
• isFeatured — true for VIP/premium listings
• sourceUrl — the canonical Bazaraki.com listing page
• recordType: "listing", scrapedAt

Input

Field	Type	Default	Description
mode	select	search	search / byUrls
searchQuery	string	–	Free-text keyword (mode=search)
category	select	all	One of 15 categories, or all (mode=search)
subcategory	select	–	One of 33 Real Estate / Motors subcategories (e.g. real-estate-for-sale/houses); overrides category when set (mode=search)
city	select	all	Nicosia / Limassol / Larnaca / Paphos / Famagusta / all (mode=search)
sortBy	select	relevant	relevant / newest / cheapest / expensive (mode=search)
minPrice	int	–	Drop listings priced below this (EUR)
maxPrice	int	–	Drop listings priced above this (EUR)
bedrooms	select	–	studio / 1–5 / 6 (6+), Real Estate categories (mode=search)
condition	select	–	new / used (mode=search)
startUrls	array	–	Direct Bazaraki.com listing URLs (mode=byUrls)
includeDetails	bool	false	Fetch each listing's detail page for extra fields (slower, more complete)
maxItems	int	30	Hard cap on emitted records (1–2000)

Example: iPhones under €800 in Nicosia, cheapest first

{
  "mode": "search",
  "searchQuery": "iphone",
  "city": "nicosia",
  "maxPrice": 800,
  "sortBy": "cheapest",
  "maxItems": 50
}

Example: mobile phones for sale in Limassol, with full details

{
  "mode": "search",
  "category": "telephones",
  "city": "limassol",
  "sortBy": "newest",
  "maxItems": 100,
  "includeDetails": true
}

Example: houses for sale in Paphos, no keyword needed

{
  "mode": "search",
  "subcategory": "real-estate-for-sale/houses",
  "city": "paphos",
  "sortBy": "cheapest",
  "maxItems": 50
}

Example: new 2-bedroom apartments for sale in Limassol

{
  "mode": "search",
  "subcategory": "real-estate-for-sale/apartments-flats",
  "city": "limassol",
  "bedrooms": "2",
  "condition": "new",
  "maxItems": 50
}

Example: fetch specific listing URLs

{
  "mode": "byUrls",
  "startUrls": ["https://www.bazaraki.com/adv/6659275_iphone/"]
}

Use cases

• Vehicle price comparison — monitor used car / motorbike listings
• Price tracking / arbitrage — watch electronics, phones and general items for deals
• Real estate market research — track Cyprus property prices and locations (with includeDetails)
• Job market analysis — pull listings from the Jobs category
• Data aggregation — feed a classifieds-aggregator or price-comparison tool

Limitations

• Real Estate and Motors category pages use a different card layout. real-estate-for-sale, real-estate-to-rent and car-motorbikes-boats-and-parts render their listings in an older card layout than other categories; the actor detects and parses both layouts automatically, so browsing these 3 categories (with or without a keyword, at the top level or via subcategory) returns real listings either way.
• A bare listing ID is not enough to fetch a specific listing. Bazaraki's URL routing requires the listing's own slug — mode=byUrls needs the full URL (e.g. https://www.bazaraki.com/adv/6659275_iphone/), not just the numeric ID.
• features[] values (from the search-results card) are unlabeled. The search page shows small icon-tagged chips (e.g. bedroom count, floor area) without machine-readable labels in the page's own HTML — the actor passes these through as raw text so you can still see them. For labeled equivalents, turn on includeDetails: every listing's own detail page publishes a full labeled characteristics map (and the common ones are promoted to typed top-level fields like bedrooms, mileageKm, fuelType — see "Output per listing").
• No private contact info. Bazaraki requires a logged-in session to reveal seller phone numbers, WhatsApp, and email; the actor only extracts publicly visible listing data.
• sourceUrl is Cloudflare-protected. Bazaraki.com sits behind Cloudflare's bot-management, so sourceUrl (and any other bazaraki.com page link) returns a JS-challenge page to plain curl/non-browser HTTP clients — it opens normally in a real web browser. Image URLs (imageUrl/imageUrls[], served from cdn1.bazaraki.com) are not behind this protection and load directly.

FAQ

What's Bazaraki? Cyprus's largest online classifieds marketplace — comparable to Craigslist, OLX, or Gumtree — covering real estate, vehicles, jobs, services and general items across the whole island.

Which currency are prices in? Euro (EUR) — Cyprus uses the Euro. Both the currency symbol (€) and ISO code (EUR) are included on every priced listing.

Can I search without a keyword? Yes, for all 15 categories — leave searchQuery empty and set category (and/or subcategory, city) to browse unfiltered.

Can I browse a specific property type or vehicle type? Yes — use subcategory (e.g. real-estate-for-sale/apartments-flats, car-motorbikes-boats-and-parts/motorbikes) for finer-grained browsing than the top-level category. It's available for the Real Estate and Motors verticals, Bazaraki's two largest categories.

Why is includeDetails off by default? The search page already returns price, location, image and a feature summary — enough for most use cases. Turning on includeDetails fetches each listing's own page for the category breadcrumb, full description, precise coordinates, and the full photo gallery, at the cost of one extra request per listing.

How many listings can I pull at once? Up to 2000 per run.