🏠 Imot.bg Scraper — Bulgaria Real Estate

Scrape property listings from imot.bg — Bulgaria's #1 real estate portal. Extract prices, area, floor, construction type, year built, full descriptions, agency contacts and all listing photos for both sale and rental properties.

No login or API key required. Optional AI translation of titles, locations and descriptions to English.

---

✨ What it does

• Scrapes for-sale and for-rent listings across any Bulgarian city
• Visits each listing's detail page for full data: description, all photos, floor, construction type, year built, agency contact
• Handles imot.bg's legacy windows-1251 Cyrillic encoding automatically — clean text output, no garbled characters
• Automatic pagination through all result pages
• Optional English translation via Claude AI (requires an ANTHROPIC_API_KEY environment variable on the Actor)

---

📦 Output fields

Field	Description	Example
listingId	imot.bg listing ID	"1b176406197723408"
listingUrl	Full listing URL	"https://www.imot.bg/obiava-..."
title	Listing title (English if translation is on, else Bulgarian)	"2-room apartment, Lozenets"
titleBg	Original Bulgarian title	"2-СТАЕН, Лозенец"
listingType	sale or rent	"sale"
propertyType	apartment / house / land / parking / commercial / studio	"apartment"
price	Numeric price	119000
priceCurrency	EUR or BGN	"EUR"
priceFormatted	Price as shown on the site	"119 000 EUR"
pricePerSqm	Price per m²	1919
area	Area in m²	62
rooms	Room count (from title)	"2-стаен"
floor / totalFloors	Floor and building height	"6" / "8"
constructionType	Construction material	"Тухла" (Brick)
yearBuilt	Year of construction	"2014"
city / cityBg	City	"град София"
neighborhood / neighborhoodBg	Neighborhood / zone	"Лозенец"
address	Full location string	"град София, Лозенец"
description / descriptionBg	Listing description	"Просторен апартамент..."
agencyName	Agency name (null for private sellers)	"Address Real Estate"
agencyPhone	Contact phone	"0877123456"
agencyUrl	Agency profile URL on imot.bg	"https://address.imot.bg"
isPrivateSeller	true if no agency	false
imageUrls	All listing photo URLs	["https://..."]
imageThumbnail	First / cover photo	"https://..."
publishedDate	Publication date (when available)	"5 май 2026"
scrapedAt	ISO scrape timestamp	"2026-05-14T09:42:00.000Z"

When Translate to English is enabled, title, city, neighborhood and description are translated/transliterated; the *Bg fields always keep the Bulgarian originals.

---

🚀 How to use

Simple — use input parameters

{
  "listingType": "sale",
  "city": "sofia",
  "maxListings": 200,
  "scrapeDetails": true
}

Supported city values: sofia, plovdiv, varna, burgas, ruse, stara-zagora, veliko-tarnovo, blagoevgrad, pleven, sliven. Any other value scrapes all of Bulgaria.

Advanced — paste your own search URL

1. Go to imot.bg, apply your filters (city, property type, price range, area)
2. Copy the search results URL
3. Paste it into startUrls

{
  "startUrls": [
    { "url": "https://www.imot.bg/obiavi/prodazhbi/grad-sofiya" },
    { "url": "https://www.imot.bg/obiavi/naemi/grad-varna" }
  ],
  "maxListings": 500,
  "scrapeDetails": true
}

---

⚙️ Input parameters

Parameter	Type	Default	Description
startUrls	array	[]	imot.bg search URLs. If empty, the URL is built from the parameters below.
listingType	string	sale	sale or rent
propertyType	string	apartment	apartment / house / land / commercial / parking / all
city	string	sofia	Bulgarian city (see supported list above)
maxListings	integer	30	Max listings to scrape (0 = unlimited)
scrapeDetails	boolean	true	Visit detail pages for full data
translateToEnglish	boolean	false	AI-translate to English (needs ANTHROPIC_API_KEY env var)
proxyConfiguration	object	disabled	Optional proxy — not required for standard runs

---

💡 Use cases

• Investor research — Bulgaria is one of the fastest-growing real estate markets in the Balkans. Track prices in EUR and BGN across cities.
• Price per m² analysis — compare pricePerSqm across Sofia, Plovdiv, Varna and Burgas neighborhoods.
• Agency database — collect agencyName, agencyPhone and agencyUrl for active Bulgarian real estate agencies.
• New construction tracking — filter by yearBuilt to find recent developments.
• Relocation & expat research — enable English translation to browse listings without reading Bulgarian.

---

⚡ Performance

Mode	Speed
List only (scrapeDetails: false)	very fast — ~30+ listings per page
Full detail (scrapeDetails: true)	~5 listings / min

imot.bg is a static, server-rendered site, so the scraper runs without a browser. A built-in runtime guard flushes results gracefully on long runs so nothing is lost to a timeout.

---

Changelog

• 2026-05-20 — Maintenance pass: reviewed the input schema and default values for a smooth one-click start, and rebuilt the Actor on the latest base image.

Last reviewed: 2026-05-20.