{ "openapi": "3.0.1", "info": { "title": "RE/MAX Turkey Scraper - Listings, Agents, Offices", "description": "Scrape remax.com.tr: homes, commercial property and land for sale or rent in Turkey and Northern Cyprus with price, rooms, area, coordinates, photos, amenities, consultant and office. Agent and office profiles and inventory counts included. No login.", "version": "0.1", "x-build-id": "hrpyLD7TTnVXxnMOx" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/recordsdata~remax-tr-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-recordsdata-remax-tr-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/recordsdata~remax-tr-scraper/runs": { "post": { "operationId": "runs-sync-recordsdata-remax-tr-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/recordsdata~remax-tr-scraper/run-sync": { "post": { "operationId": "run-sync-recordsdata-remax-tr-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": { "mode": { "title": "What to collect", "enum": [ "search", "urls", "catalog", "agents", "offices", "inventory" ], "type": "string", "description": "search = listings for the chosen deal type, property group, types and places. urls = the RE/MAX Turkey addresses and listing codes you list below. catalog = walk the public listing sitemaps, newest first (everything, or only what changed since a date). agents = RE/MAX consultant profiles. offices = RE/MAX office profiles. inventory = how many listings the site shows for each search (counts by property type).", "default": "search" }, "language": { "title": "Language", "enum": [ "en", "tr" ], "type": "string", "description": "Language of the site pages that are read: labels, property type names, heating and deed words, floor names. Titles and descriptions are written by the sellers, mostly in Turkish; where a seller added an English text it is used for English.", "default": "en" }, "maxItems": { "title": "Maximum items", "minimum": 1, "maximum": 1000000, "type": "integer", "description": "Stops after this many rows (all record types together). Free plans are limited to 10 items per run.", "default": 50 }, "operation": { "title": "Deal type", "enum": [ "sale", "rent", "both" ], "type": "string", "description": "Buy, rent or both. Also filters the catalog and the inventory counts.", "default": "sale" }, "propertyGroup": { "title": "Property group", "enum": [ "housing", "commercial", "land", "any" ], "type": "string", "description": "Housing (flats, villas, houses), commercial (shops, offices, hotels, factories) or land (plots and fields). Any reads the three groups one after the other.", "default": "housing" }, "propertyTypes": { "title": "Property types", "type": "array", "description": "Only these types. Empty means every type of the chosen group. A type that exists in several groups (villa, farmhouse, timeshare, mine) is read in each chosen group that owns it.", "items": { "type": "string", "enum": [ "tarim-arazisi", "apart-otel", "daire", "pastane---firin---tatlici", "ahir", "antrepo-izinli", "butik-otel", "bina", "is-hani", "cafe---bar", "kamp-yeri--mocamp", "sinema---konferans-salonu", "muayenehane", "soguk-hava-deposu", "ticari---konut", "ticari", "kooperatif", "mustakil-ev", "yurt", "egitim", "enerji-depolama", "fabrika---uretim-tesisi", "ciftlik", "ciftlik-evi", "tarla", "kat-karsiligi", "akaryakit-istasyonu", "rum-evi", "sera", "pansiyon", "saglik-merkezi", "saglik", "tarihi-yapi", "tatil-koyu", "otel", "konut-imarli", "sanayi", "anaokulu---kres", "kosk---konak", "imalathane", "toplu-konut", "maden-ocagi", "motel", "huzur-evi", "buro---ofis", "zeytinlik", "otopark", "eczane---medikal", "plaza", "plaza-kati", "enerji-santralleri", "sit-alani", "residence", "residence-kati---ofisi", "restoran---lokanta", "okul", "hazir---sanal-ofis", "dukkan---magaza", "avm", "spa--hamam---sauna", "ozel-kullanim", "spor-tesisi", "tas-ev", "yazlik", "devre-mulk", "turizm---ticari", "turizm---konut", "turizm", "veteriner", "villa", "koy", "bag---bahce", "depo---antrepo", "depo", "yali-dairesi", "yali", "komple-bina", "atolye" ], "enumTitles": [ "Agricultural land (land)", "Aparthotel (commercial)", "Apartment (housing)", "Bakery and patisserie (commercial)", "Barn (commercial)", "Bonded warehouse land (land)", "Boutique hotel (commercial)", "Building (housing)", "Business center (commercial)", "Cafe and bar (commercial)", "Camp site (commercial)", "Cinema or conference hall (commercial)", "Clinic (commercial)", "Cold storage (commercial)", "Commercial and housing land (land)", "Commercial land (land)", "Cooperative land (land)", "Detached house (housing)", "Dormitory (commercial)", "Education land (land)", "Energy storage land (land)", "Factory (commercial)", "Farm (commercial)", "Farmhouse (housing / land)", "Field (land)", "Flat-for-land deal (land)", "Gas station (commercial)", "Greek house (housing)", "Greenhouse land (land)", "Guesthouse (commercial)", "Health center (commercial)", "Health land (land)", "Historic building (housing)", "Holiday village (commercial)", "Hotel (commercial)", "Housing zoned land (land)", "Industrial land (land)", "Kindergarten (commercial)", "Mansion (housing)", "Manufacturing workshop (commercial)", "Mass housing land (land)", "Mine (commercial / land)", "Motel (commercial)", "Nursing home (commercial)", "Office (commercial)", "Olive grove (land)", "Parking lot (commercial)", "Pharmacy and medical (commercial)", "Plaza (commercial)", "Plaza floor (commercial)", "Power plant (commercial)", "Protected area land (land)", "Residence (housing)", "Residence floor or office (commercial)", "Restaurant (commercial)", "School (commercial)", "Serviced office (commercial)", "Shop (commercial)", "Shopping mall (commercial)", "Spa, hamam and sauna (commercial)", "Special use land (land)", "Sports facility (commercial)", "Stone house (housing)", "Summer house (housing)", "Timeshare (housing / commercial)", "Tourism and commercial land (land)", "Tourism and housing land (land)", "Tourism land (land)", "Veterinary clinic (commercial)", "Villa (housing / commercial / land)", "Village land (land)", "Vineyard and garden (land)", "Warehouse (commercial)", "Warehouse land (land)", "Waterfront apartment (housing)", "Waterfront mansion (housing)", "Whole building (commercial)", "Workshop (commercial)" ] }, "default": [] }, "cities": { "title": "Provinces", "type": "array", "description": "Provinces to search, by the site path name. Istanbul is split in two (European and Anatolian side); the six Northern Cyprus districts are listed too. Empty means all of Turkey.", "items": { "type": "string", "enum": [ "adana", "adiyaman", "afyonkarahisar", "agri", "aksaray", "amasya", "ankara", "antalya", "ardahan", "artvin", "aydin", "balikesir", "bartin", "batman", "bayburt", "bilecik", "bingol", "bitlis", "bolu", "burdur", "bursa", "canakkale", "cankiri", "corum", "denizli", "diyarbakir", "duzce", "edirne", "elazig", "erzincan", "erzurum", "eskisehir", "gaziantep", "giresun", "girne--k-k-t-c", "gumushane", "guzelyurt--k-k-t-c", "hakkari", "hatay", "igdir", "iskele--k-k-t-c", "isparta", "istanbul-anadolu", "istanbul-avrupa", "izmir", "kahramanmaras", "karabuk", "karaman", "kars", "kastamonu", "kayseri", "kilis", "kirikkale", "kirklareli", "kirsehir", "kocaeli", "konya", "kutahya", "lefke--k-k-t-c", "lefkosa--k-k-t-c", "magosa--k-k-t-c", "malatya", "manisa", "mardin", "mersin", "mugla", "mus", "nevsehir", "nigde", "ordu", "osmaniye", "rize", "sakarya", "samsun", "sanliurfa", "siirt", "sinop", "sirnak", "sivas", "tekirdag", "tokat", "trabzon", "tunceli", "usak", "van", "yalova", "yozgat", "zonguldak" ], "enumTitles": [ "Adana", "Adiyaman", "Afyonkarahisar", "Agri", "Aksaray", "Amasya", "Ankara", "Antalya", "Ardahan", "Artvin", "Aydin", "Balikesir", "Bartin", "Batman", "Bayburt", "Bilecik", "Bingol", "Bitlis", "Bolu", "Burdur", "Bursa", "Canakkale", "Cankiri", "Corum", "Denizli", "Diyarbakir", "Duzce", "Edirne", "Elazig", "Erzincan", "Erzurum", "Eskisehir", "Gaziantep", "Giresun", "Girne (Kyrenia, Northern Cyprus)", "Gumushane", "Guzelyurt (Morphou, Northern Cyprus)", "Hakkari", "Hatay", "Igdir", "Iskele (Northern Cyprus)", "Isparta", "Istanbul Anatolian side", "Istanbul European side", "Izmir", "Kahramanmaras", "Karabuk", "Karaman", "Kars", "Kastamonu", "Kayseri", "Kilis", "Kirikkale", "Kirklareli", "Kirsehir", "Kocaeli", "Konya", "Kutahya", "Lefke (Northern Cyprus)", "Lefkosa (Nicosia, Northern Cyprus)", "Magosa (Famagusta, Northern Cyprus)", "Malatya", "Manisa", "Mardin", "Mersin", "Mugla", "Mus", "Nevsehir", "Nigde", "Ordu", "Osmaniye", "Rize", "Sakarya", "Samsun", "Sanliurfa", "Siirt", "Sinop", "Sirnak", "Sivas", "Tekirdag", "Tokat", "Trabzon", "Tunceli", "Usak", "Van", "Yalova", "Yozgat", "Zonguldak" ] }, "default": [] }, "town": { "title": "Town (district)", "type": "string", "description": "One district inside the single province you chose, for example beyoglu or Beşiktaş. The actor writes it the way the site does. Needs exactly one province.", "default": "" }, "neighborhood": { "title": "Neighborhood", "type": "string", "description": "One neighborhood inside the town, for example \"Küçük Piyale Mah.\" or kucuk-piyale-mah. Needs a town.", "default": "" }, "minPrice": { "title": "Minimum price", "minimum": 0, "type": "integer", "description": "Keep listings at or above this price, in the currency of the listing (almost always Turkish lira). Listings with a hidden price are left out when a price filter is set. Applied by the actor, not by the site." }, "maxPrice": { "title": "Maximum price", "minimum": 0, "type": "integer", "description": "Keep listings at or below this price (rent listings use the monthly rent)." }, "minBedrooms": { "title": "Minimum bedrooms", "minimum": 0, "type": "integer", "description": "Keep listings with at least this many bedrooms. The first number of the Turkish room layout counts: 3+1 means 3 bedrooms and 1 living room." }, "maxBedrooms": { "title": "Maximum bedrooms", "minimum": 0, "type": "integer", "description": "Keep listings with at most this many bedrooms." }, "minArea": { "title": "Minimum area (m2)", "minimum": 0, "type": "integer", "description": "Keep listings with at least this gross area in square metres (land plots use the plot size)." }, "maxArea": { "title": "Maximum area (m2)", "minimum": 0, "type": "integer", "description": "Keep listings with at most this area in square metres." }, "keywords": { "title": "Keywords", "type": "array", "description": "Keep listings whose title, description or neighborhood contains at least one of these words (accents and capitals are ignored), one per line. Turkish texts need Turkish words, for example deniz manzarali.", "default": [], "items": { "type": "string" } }, "onlyAvailable": { "title": "Hide deposit-taken and rented listings", "type": "boolean", "description": "On: skip listings that the site marks as deposit taken, rented or sold. Off: they are delivered with status set to deposit-taken, rented or sold.", "default": false }, "includeDetails": { "title": "Read the full listing page", "type": "boolean", "description": "On: one extra request per listing for amenities, view, nearby places, the consultant and the office with licence data (listing-detail record). Off: only the search-card data (listing record), much faster, without amenities and office data.", "default": true }, "includeContactDetails": { "title": "Include consultant and office contact data", "type": "boolean", "description": "Adds the phone numbers, email and photo of the listing consultant, and phone and email of agent and office records. Only business contacts of licensed RE/MAX offices are published on the site. Turn on only if you have a lawful reason to process personal data.", "default": false }, "includeListings": { "title": "Also deliver the listings of agents and offices", "type": "boolean", "description": "In agents, offices and urls mode: after each agent or office record, also deliver that agent or office listings as listing records (same filters, same maximum). Off: only the agent or office record.", "default": false }, "startUrls": { "title": "RE/MAX Turkey addresses", "type": "array", "description": "Used in urls mode. Listing pages (/tr/portfoy/P..., /en/property/P...), search pages (/tr/konut/satilik/istanbul-avrupa/...), consultant pages (/tr/danisman/...) and office pages (/tr/ofis/detay/...). Several kinds can be mixed.", "default": [], "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "propertyCodes": { "title": "Listing codes", "type": "array", "description": "Used in urls mode. Listing codes such as P21816843, one per line.", "default": [], "items": { "type": "string" } }, "updatedSince": { "title": "Updated since", "type": "string", "description": "Catalog mode: only listings whose sitemap date is on or after this day (YYYY-MM-DD). Empty means all, newest first.", "default": "" }, "agentQuery": { "title": "Consultant name contains", "type": "string", "description": "Agents mode: keep only consultants whose page name contains this text (for example yasin or acikgoz). Empty means every consultant.", "default": "" }, "officeQuery": { "title": "Office name contains", "type": "string", "description": "Offices mode: keep only offices whose page name contains this text (for example pro or city). Empty means every office.", "default": "" }, "inventoryByProvince": { "title": "Inventory for every province", "type": "boolean", "description": "Inventory mode with no province chosen: one inventory record for each of the 88 provinces instead of one for all of Turkey.", "default": false }, "onlyNew": { "title": "Only new records", "type": "boolean", "description": "Skips records delivered by an earlier run of the same search. Nothing skipped is charged. Search pages are not sorted by date: for monitoring use catalog mode with this switch.", "default": false }, "trackPriceChanges": { "title": "Also report price changes", "type": "boolean", "description": "With Only new records on: a listing seen before comes back as a changed-listing record when its price differs from the last delivered price, with the previous price and the change in percent.", "default": false }, "stateKey": { "title": "Monitor name", "type": "string", "description": "Optional label to keep several monitors with identical filters apart.", "default": "" }, "resetSeen": { "title": "Forget what was delivered", "type": "boolean", "description": "Clears the memory of this search before the run, so everything counts as new.", "default": false }, "maxPages": { "title": "Maximum pages per search", "minimum": 1, "maximum": 1200, "type": "integer", "description": "Cap on the number of result pages (36 listings each) read for one search combination, or for one agent or office. The whole site is about 1,040 pages.", "default": 40 }, "maxRuntimeSeconds": { "title": "Time budget (seconds)", "minimum": 30, "maximum": 86400, "type": "integer", "description": "The run stops cleanly after this many seconds and keeps what it delivered.", "default": 1500 }, "maxConcurrency": { "title": "Parallel requests", "minimum": 1, "maximum": 8, "type": "integer", "description": "How many page requests run at the same time.", "default": 4 }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Not needed: the site answers cloud servers without a proxy. If it ever blocks, the actor switches to the Apify datacenter proxy on its own. Choose a proxy here only to force one.", "default": { "useApifyProxy": false } } } }, "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 } } } } } } } } } }