# Imoti Property Search Scraper (`stealth_mode/imoti-property-search-scraper`) Actor Scrape property listings from Imoti.info — Bulgaria's popular real estate portal. Extract titles, prices, floor info, build year, photos, agency contacts, and more across any search page. Perfect for analysts, agents, and proptech developers. - **URL**: https://apify.com/stealth\_mode/imoti-property-search-scraper.md - **Developed by:** [Stealth mode](https://apify.com/stealth_mode) (community) - **Categories:** Automation, Developer tools, Real estate - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, NaN bookmarks - **User rating**: No ratings yet ## Pricing from $3.00 / 1,000 results 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/platform/actors/running/actors-in-store#pay-per-event ## What's an Apify Actor? Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases. 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. Actors are written with capital "A". ## 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. The best way to integrate Actors is as follows. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md). If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md). For usage examples, see the [API](#api) section below. For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt). # README ## Imoti.info Property Search Scraper: Extract Bulgarian Real Estate Listings --- ### What Is Imoti.info? Imoti.info is a widely-used Bulgarian real estate platform listing properties for sale and rent across the country. It covers apartments, houses, and commercial properties, primarily in Sofia and other major Bulgarian cities. Manually collecting listing data from paginated search results is impractical at scale — the **Imoti.info Property Scraper** automates extraction from any search URL, delivering clean, structured records ready for analysis or integration. --- ### Overview The **Imoti.info Property Search Scraper** targets property listing pages and extracts all key listing attributes per result. It is suited for: - **Real estate agents** monitoring market inventory and pricing - **Property analysts** tracking price trends by location and type - **Proptech developers** feeding listing data into custom platforms - **Investors** researching the Bulgarian property market The scraper supports paginated search URLs, configurable item limits, and fault-tolerant runs via `ignore_url_failures`. --- ### Input Format ```json { "urls": ["https://imoti.info/en/for-sale/grad-sofiya/two-bedroom-apartments/page-2"], "ignore_url_failures": true, "max_items_per_url": 50 } ```` | Field | Type | Description | |---|---|---| | `urls` | `array` | One or more Imoti.info property search/list page URLs. Supports pagination URLs (e.g., `/page-2`). Add multiple URLs for bulk collection across regions or property types. | | `ignore_url_failures` | `boolean` | If `true`, the scraper continues when a URL fails instead of stopping the entire run. Recommended for bulk jobs. Default: `true`. | | `max_items_per_url` | `integer` | Maximum number of listings to collect per URL. Useful for sampling. Default: `20`. Set higher (e.g., `50`) for fuller page coverage. | > **Tip:** To scrape multiple cities or property types, add each filtered search URL as a separate entry in the `urls` array. *** ### Output Format **Sample output** ```json { "id": "1c177822828480548", "ida": "1c177822828480548", "pn": "1", "sell_type": "For Sale", "pubtypetxt": "2 bedroom", "title": "For Sale 2 bedroom Sofia, Belite brezi", "url": "/properties/17924980-for-sale-2-bedroom-grad-sofiya-belite-brezi", "price": "318 000", "currency": "€", "nraions": "Belite brezi, Sofia", "nraions_mob": "Belite brezi, Sofia", "floor": "5th floor ", "ybuild": null, "pictures": [ { "src": "//imotstatic4.focus.bg/imot/photosimotbg/1/548/1c177822828480548_2z.jpg" }, { "src": "//imotstatic4.focus.bg/imot/photosimotbg/1/548/1c177822828480548_J2.jpg" }, { "src": "//imotstatic4.focus.bg/imot/photosimotbg/1/548/1c177822828480548_Bp.jpg" }, { "src": "//imotstatic4.focus.bg/imot/photosimotbg/1/548/1c177822828480548_Za.jpg" }, { "src": "//imotstatic4.focus.bg/imot/photosimotbg/1/548/1c177822828480548_Ag.jpg" }, { "src": "//imotstatic4.focus.bg/imot/photosimotbg/1/548/1c177822828480548_FW.jpg" }, { "src": "//imotstatic4.focus.bg/imot/photosimotbg/1/548/1c177822828480548_j3.jpg" }, { "src": "//imotstatic4.focus.bg/imot/photosimotbg/1/548/1c177822828480548_31.jpg" }, { "src": "//imotstatic4.focus.bg/imot/photosimotbg/1/548/1c177822828480548_ig.jpg" }, { "src": "//imotstatic4.focus.bg/imot/photosimotbg/1/548/1c177822828480548_fE.jpg" }, { "src": "//imotstatic4.focus.bg/imot/photosimotbg/1/548/1c177822828480548_D5.jpg" }, { "src": "//imotstatic4.focus.bg/imot/photosimotbg/1/548/1c177822828480548_N2.jpg" }, { "src": "//imotstatic4.focus.bg/imot/photosimotbg/1/548/1c177822828480548_XU.jpg" } ], "phone": "0885982120", "info": null, "top": 1, "agency": { "id": "a16136660657901262", "name": "REA TSEKOV", "phone": "0895387205", "address": "Sofia, Ul. Moskovska 27, Sofiya", "http": "reatsekov.bg", "slug": "reatsekov", "logo": "//photos.imoti.info/assets/images/logos/reatsekov.webp?1778544000" }, "summary": "100 sq.m, 5th floor " } ``` Each listing returns the following fields: #### Identification | Field | Meaning | |---|---| | `ID` | Internal unique identifier for the listing | | `IDA` | Secondary identifier, likely used for agency-side tracking | | `PN` | Property number or reference code as used on the portal | #### Listing Classification | Field | Meaning | |---|---| | `Sell Type` | Transaction type — typically `for-sale` or `for-rent` | | `Pub Type Txt` | Publication type label (e.g., apartment, house, studio) | | `Top` | Whether the listing has a promoted/top placement | | `Agency` | Whether the listing is posted by an agency (vs. private owner) | #### Listing Content | Field | Meaning | |---|---| | `Title` | Listing headline as displayed on the portal | | `URL` | Direct link to the full listing detail page | | `Summary` | Short description or teaser text for the property | | `Info` | Additional structured property attributes (area, rooms, extras) | #### Pricing | Field | Meaning | |---|---| | `Price` | Listed asking price | | `Currency` | Currency of the price (typically `EUR` or `BGN`) | #### Property Details | Field | Meaning | |---|---| | `Floor` | Floor number or floor range for the property | | `Year Build` | Construction year of the building | | `NRaions` | Neighbourhood or district name (desktop label) | | `NRaions Mob` | Neighbourhood or district name (mobile/shortened label) | | `Pictures` | URLs of listing images | #### Contact | Field | Meaning | |---|---| | `Phone` | Contact phone number for the listing (agent or owner) | *** ### How to Use 1. **Get search URLs** — Run a filtered search on Imoti.info (city, type, transaction). Copy the results page URL, including pagination if needed (e.g., `/page-3`). 2. **Configure input** — Paste URLs into the `urls` array. Set `max_items_per_url` based on how many listings you need per page. 3. **Enable fault tolerance** — Keep `ignore_url_failures: true` for multi-URL runs. 4. **Run and export** — Start the scraper and download results as JSON, CSV, or Excel. **Common issues:** - Ensure the URL is a **list/search results page**, not an individual property detail page. - For full coverage of a search, add each paginated URL (`/page-1`, `/page-2`, etc.) separately. *** ### Use Cases & Business Value - **Market analysis:** Track average prices per district, floor level, or build era - **Inventory monitoring:** Watch new listings appear in target areas - **Lead generation:** Collect agency contact numbers for outreach - **Platform integration:** Sync Bulgarian property data into aggregators or CRMs The scraper replaces hours of manual copy-pasting with a repeatable, automated pipeline — delivering consistent data on every run. *** ### Conclusion The **Imoti.info Property Search Scraper** gives real estate professionals and developers direct access to Bulgarian property market data at scale. With 19 structured fields per listing and flexible URL-based configuration, it covers everything from pricing and location to photos and agent contacts. Run it on any Imoti.info search page to start building your real estate dataset today. # Actor input Schema ## `urls` (type: `array`): Add the URLs of the property list urls you want to scrape. You can paste URLs one by one, or use the Bulk edit section to add a prepared list. ## `ignore_url_failures` (type: `boolean`): If true, the scraper will continue running even if some URLs fail to be scraped. ## `max_items_per_url` (type: `integer`): The maximum number of items to scrape per URL. ## `proxy` (type: `object`): Select proxies to be used by your scraper. ## Actor input object example ```json { "urls": [ "https://imoti.info/en/for-sale/grad-sofiya/two-bedroom-apartments/page-2" ], "ignore_url_failures": true, "max_items_per_url": 20, "proxy": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ], "apifyProxyCountry": "US" } } ``` # 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 '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "urls": [ "https://imoti.info/en/for-sale/grad-sofiya/two-bedroom-apartments/page-2" ], "ignore_url_failures": true, "max_items_per_url": 20, "proxy": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ], "apifyProxyCountry": "US" } }; // Run the Actor and wait for it to finish const run = await client.actor("stealth_mode/imoti-property-search-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 '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "urls": ["https://imoti.info/en/for-sale/grad-sofiya/two-bedroom-apartments/page-2"], "ignore_url_failures": True, "max_items_per_url": 20, "proxy": { "useApifyProxy": True, "apifyProxyGroups": ["RESIDENTIAL"], "apifyProxyCountry": "US", }, } # Run the Actor and wait for it to finish run = client.actor("stealth_mode/imoti-property-search-scraper").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"]) for item in client.dataset(run["defaultDatasetId"]).iterate_items(): print(item) # 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{ "urls": [ "https://imoti.info/en/for-sale/grad-sofiya/two-bedroom-apartments/page-2" ], "ignore_url_failures": true, "max_items_per_url": 20, "proxy": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ], "apifyProxyCountry": "US" } }' | apify call stealth_mode/imoti-property-search-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=stealth_mode/imoti-property-search-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Imoti Property Search Scraper", "description": "Scrape property listings from Imoti.info — Bulgaria's popular real estate portal. Extract titles, prices, floor info, build year, photos, agency contacts, and more across any search page. Perfect for analysts, agents, and proptech developers.", "version": "0.0", "x-build-id": "z9ovy24qFrtNkykP4" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/stealth_mode~imoti-property-search-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-stealth_mode-imoti-property-search-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/stealth_mode~imoti-property-search-scraper/runs": { "post": { "operationId": "runs-sync-stealth_mode-imoti-property-search-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/stealth_mode~imoti-property-search-scraper/run-sync": { "post": { "operationId": "run-sync-stealth_mode-imoti-property-search-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "properties": { "urls": { "title": "URLs of the property list urls to scrape", "type": "array", "description": "Add the URLs of the property list urls you want to scrape. You can paste URLs one by one, or use the Bulk edit section to add a prepared list.", "items": { "type": "string" } }, "ignore_url_failures": { "title": "Continue running even if some URLs fail to be scraped", "type": "boolean", "description": "If true, the scraper will continue running even if some URLs fail to be scraped." }, "max_items_per_url": { "title": "Max items per URL", "type": "integer", "description": "The maximum number of items to scrape per URL." }, "proxy": { "title": "Proxy configuration", "type": "object", "description": "Select proxies to be used by your scraper." } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } } } } } } } } } ```