{ "openapi": "3.0.1", "info": { "title": "Real Estate Global Listings Scraper", "description": "All-in-one global real estate scraper covering MagicBricks (India), Otodom (Poland), Hemnet (Sweden), Imovirtual (Portugal), Property24 (South Africa) and Aqarmap (Egypt). Export price, area, beds, baths, location, images, agency and listing URL as CSV, Excel, JSON or XML.", "version": "0.1", "x-build-id": "ntUXf9OhHX77mXJhi" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/parseforge~real-estate-global-listings-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-parseforge-real-estate-global-listings-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/parseforge~real-estate-global-listings-scraper/runs": { "post": { "operationId": "runs-sync-parseforge-real-estate-global-listings-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/parseforge~real-estate-global-listings-scraper/run-sync": { "post": { "operationId": "run-sync-parseforge-real-estate-global-listings-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": { "query": { "title": "Query / Keyword", "type": "string", "description": "Optional free-text keyword (some sources accept it as a free-text filter; many use the structured filters below instead).", "default": "" }, "sources": { "title": "Sources to include", "uniqueItems": true, "type": "array", "description": "Which underlying sources to query. Leave empty to query all sources in parallel.", "items": { "type": "string", "enum": [ "magicbricks", "otodom", "hemnet", "imovirtual", "property24", "aqarmap" ], "enumTitles": [ "MagicBricks India", "Otodom Poland", "Hemnet Sweden", "Imovirtual Portugal", "Property24 South Africa", "Aqarmap Egypt" ] }, "default": [ "magicbricks", "otodom", "hemnet", "imovirtual", "property24", "aqarmap" ] }, "maxItems": { "title": "Max Items", "minimum": 1, "maximum": 1000000, "type": "integer", "description": "Free users: Limited to 10 items (preview). Paid users: Optional, max 1,000,000" }, "mb_city": { "title": "MagicBricks City", "enum": [ "4320", "2296", "2331", "3327", "3354", "1318", "1290", "3737", "4131", "1639" ], "type": "string", "description": "City ID for MagicBricks (India).", "default": "4320" }, "mb_transaction": { "title": "MagicBricks Transaction", "enum": [ "S", "R" ], "type": "string", "description": "Sale or Rent listings on MagicBricks.", "default": "S" }, "ot_transaction": { "title": "Otodom Transaction", "enum": [ "sprzedaz", "wynajem" ], "type": "string", "description": "Sale or rent on Otodom (Polish slug).", "default": "sprzedaz" }, "ot_estate": { "title": "Otodom Estate Type", "enum": [ "mieszkanie", "dom", "dzialka", "lokal", "garaz" ], "type": "string", "description": "Estate type slug (Polish).", "default": "mieszkanie" }, "ot_location": { "title": "Otodom Location", "type": "string", "description": "Otodom location slug (e.g. cala-polska, mazowieckie/warszawa).", "default": "cala-polska" }, "hm_sort": { "title": "Hemnet Sort", "enum": [ "NEWEST", "PUBLISHED_DESC", "ASKING_PRICE_DESC", "ASKING_PRICE_ASC" ], "type": "string", "description": "Sort order for Hemnet results.", "default": "NEWEST" }, "im_transaction": { "title": "Imovirtual Transaction", "enum": [ "comprar", "arrendar" ], "type": "string", "description": "Buy or rent on Imovirtual (Portuguese slug).", "default": "comprar" }, "im_propertyType": { "title": "Imovirtual Property Type", "enum": [ "apartamento", "moradia", "terreno", "comercial", "quarto" ], "type": "string", "description": "Property type slug (Portuguese).", "default": "apartamento" }, "im_location": { "title": "Imovirtual Location", "type": "string", "description": "Imovirtual location slug (e.g. lisboa, porto, faro).", "default": "lisboa" }, "p24_transaction": { "title": "Property24 Transaction", "enum": [ "for-sale", "to-rent" ], "type": "string", "description": "For-sale or to-rent on Property24.", "default": "for-sale" }, "p24_location": { "title": "Property24 Location", "type": "string", "description": "Property24 location slug (e.g. cape-town/western-cape/432).", "default": "cape-town/western-cape/432" }, "aq_city": { "title": "Aqarmap City", "enum": [ "cairo", "giza", "alexandria", "red-sea", "north-coast" ], "type": "string", "description": "Egyptian city slug.", "default": "cairo" }, "aq_transaction": { "title": "Aqarmap Transaction", "enum": [ "for-sale", "for-rent" ], "type": "string", "description": "For-sale or for-rent on Aqarmap.", "default": "for-sale" }, "aq_propertyType": { "title": "Aqarmap Property Type", "enum": [ "apartment", "villa", "duplex", "penthouse", "townhouse", "chalet" ], "type": "string", "description": "Aqarmap property type slug.", "default": "apartment" } } }, "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 } } } } } } } } } }