{ "openapi": "3.0.1", "info": { "title": "Realting.com Scraper: Property Listings, Prices, 90+ Countries", "description": "Scrape international property listings from Realting.com across 90+ countries. Filter by country, city, listing type, property type, bedrooms, and price. Get price, rooms, bathrooms, area, and GPS coordinates, plus optional full-detail enrichment with photos and address. $1.50 per 1,000 results.", "version": "0.1", "x-build-id": "tjnijeFkXape8wCP0" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/getascraper~realting-property-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-getascraper-realting-property-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/getascraper~realting-property-scraper/runs": { "post": { "operationId": "runs-sync-getascraper-realting-property-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/getascraper~realting-property-scraper/run-sync": { "post": { "operationId": "run-sync-getascraper-realting-property-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", "required": [ "country", "maxItems" ], "properties": { "country": { "title": "Country", "enum": [ "albania", "algeria", "argentina", "armenia", "australia", "austria", "azerbaijan", "bahamas", "belarus", "belgium", "bosnia-and-herzegovina", "botswana", "brazil", "bulgaria", "cambodia", "cameroon", "canada", "cape-verde", "chad", "chile", "colombia", "costa-rica", "croatia", "cyprus", "czech-republic", "dominican-republic", "egypt", "estonia", "finland", "france", "gambia", "georgia", "germany", "ghana", "greece", "grenada", "honduras", "hungary", "indonesia", "iran", "israel", "italy", "ivory-coast", "jordan", "kazakhstan", "kenya", "kyrgyzstan", "latvia", "lebanon", "lithuania", "luxembourg", "macedonia", "madagascar", "malaysia", "maldives", "malta", "mauritius", "mexico", "moldova", "monaco", "montenegro", "morocco", "namibia", "netherlands", "nicaragua", "nigeria", "northern-cyprus", "oman", "palestinian-territory", "panama", "peru", "philippines", "poland", "portugal", "romania", "russia", "saint-kitts-and-nevis", "saudi-arabia", "senegal", "serbia", "seychelles", "slovakia", "slovenia", "south-africa", "south-korea", "spain", "sri-lanka", "sweden", "switzerland", "tanzania", "thailand", "turkey", "uganda", "ukraine", "united-arab-emirates", "united-kingdom", "united-states", "uruguay", "venezuela", "vietnam", "yemen" ], "type": "string", "description": "The country to search on Realting.com. Realting organizes every listing under a country page first, so this is the one field every run needs.", "default": "spain" }, "city": { "title": "City (Optional)", "type": "string", "description": "Restrict the search to one city or region within the country, using Realting's own URL slug for it (for example \"barcelona\" or \"homyel\"). Leave blank to search the whole country. An incorrect slug returns a 404 for that request rather than silently falling back to the whole country.", "default": "" }, "listingType": { "title": "Listing Type", "enum": [ "property", "property-to-rent", "short-term-rental", "new-buildings", "commercial" ], "type": "string", "description": "Which part of Realting.com to search: properties for sale, long-term rentals, short-term (holiday) rentals, new-build developments, or commercial property.", "default": "property" }, "propertyType": { "title": "Property Type (Optional)", "enum": [ "", "apartments", "houses", "villas", "cottages", "townhouses", "studios", "condos", "duplexes", "penthouses", "bungalows", "chalets", "mansions", "castles", "lands" ], "type": "string", "description": "Narrow the search to one property type, such as apartments or villas. Only applies to the For Sale, For Rent, and New Buildings listing types. Leave blank to include every property type in the chosen category.", "default": "" }, "minBedrooms": { "title": "Min Bedrooms (Optional)", "minimum": 0, "maximum": 50, "type": "integer", "description": "Only keep listings with at least this many bedrooms. Applied after the page is fetched, using the bedroom count shown on each listing card, since Realting's own bedroom filter relies on URL query parameters that are blocked by the site's robots.txt." }, "maxBedrooms": { "title": "Max Bedrooms (Optional)", "minimum": 0, "maximum": 50, "type": "integer", "description": "Only keep listings with at most this many bedrooms. Leave blank for no upper limit." }, "minPrice": { "title": "Min Price USD (Optional)", "minimum": 0, "type": "integer", "description": "Only keep listings priced at or above this amount, in US dollars. Realting shows every listing's price in multiple currencies; this filter compares against the USD figure." }, "maxPrice": { "title": "Max Price USD (Optional)", "minimum": 0, "type": "integer", "description": "Only keep listings priced at or below this amount, in US dollars. Leave blank for no upper limit." }, "fetchFullDetails": { "title": "Fetch Full Listing Details", "type": "boolean", "description": "When enabled, visits each listing's own page to add its full description, year built, exact floor size, complete postal address, GPS coordinates, and full photo gallery. This makes one extra request per listing, so it is off by default to keep runs fast and cheap; turn it on when you need more than the summary fields shown on the search results page.", "default": false }, "maxItems": { "title": "Max Items", "minimum": 1, "maximum": 5000, "type": "integer", "description": "The most listings to return in one run. Keep this low for a quick test; raise it once you know the search returns what you expect. Each page of Realting search results holds roughly 20-30 listings.", "default": 20 }, "proxyConfiguration": { "title": "Proxy Configuration", "required": [], "type": "object", "description": "Realting.com is server-rendered and does not gate access by proxy quality, so Apify's shared datacenter proxies work reliably and keep runs cheap. Residential proxies are not needed for this target.", "default": { "useApifyProxy": true } } } }, "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 } } } } } } } } } }