{ "openapi": "3.0.1", "info": { "title": "BG Rentals Properties and Details Scraper", "description": "BG Rentals Properties and Details Scraper — Extract bounded imot.bg rental fields only when applicable data-reuse authorization is confirmed; default runs skip all source requests.", "version": "1.0", "x-build-id": "j0fNg0uzaFbRljPUh" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/realestateapi~bg-rentals-properties-and-details-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-realestateapi-bg-rentals-properties-and-details-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/realestateapi~bg-rentals-properties-and-details-scraper/runs": { "post": { "operationId": "runs-sync-realestateapi-bg-rentals-properties-and-details-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/realestateapi~bg-rentals-properties-and-details-scraper/run-sync": { "post": { "operationId": "run-sync-realestateapi-bg-rentals-properties-and-details-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": { "start_urls": { "title": "imot.bg rental URLs", "minItems": 1, "maxItems": 20, "type": "array", "description": "HTTPS imot.bg rental collection, city/region, pagination, or detail URLs. The default collection is the public all-rentals page.", "items": { "type": "string", "pattern": "^https://(www\\.)?imot\\.bg/" }, "default": [ "https://www.imot.bg/obiavi/naemi" ] }, "max_items": { "title": "Maximum listings", "minimum": 1, "maximum": 500, "type": "integer", "description": "Maximum unique listing records across all supplied sources.", "default": 25 }, "max_list_pages_per_source": { "title": "Pages per source", "minimum": 1, "maximum": 25, "type": "integer", "description": "Maximum pagination pages followed from each start URL.", "default": 2 }, "max_detail_pages": { "title": "Detail pages", "minimum": 0, "maximum": 500, "type": "integer", "description": "Maximum public listing detail pages fetched for enrichment. Set to zero for list-only output.", "default": 25 }, "include_details": { "title": "Enrich details", "type": "boolean", "description": "Fetch each listing's public detail page while respecting max_detail_pages.", "default": true }, "data_use_authorized": { "title": "Applicable data-use authorization confirmed", "type": "boolean", "description": "Required before any source request. Set true only if you already hold permission to collect and reuse the requested imot.bg data. This operator attestation does not grant permission. The current review found no specific data-reuse license.", "default": false }, "request_delay_ms": { "title": "Request delay (ms)", "minimum": 0, "maximum": 5000, "type": "integer", "description": "Polite delay before each public page request.", "default": 250 }, "request_timeout_seconds": { "title": "Request timeout (seconds)", "minimum": 5, "maximum": 90, "type": "integer", "description": "Timeout for each public HTML request.", "default": 30 } } }, "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 }, "PROXY_UNBLOCKER_UNITS": { "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 }, "PROXY_UNBLOCKER_UNITS": { "type": "integer", "example": 0 } } } } } } } } } }