{ "openapi": "3.0.1", "info": { "title": "Turkish Real Estate Agency Scraper", "description": "Scrape agency profiles from Emlakjet, Hepsiemlak, and Sahibinden, including office identity, phone, badges, license details, listing volume, and optional portfolio analytics. Ideal for brokerage intelligence, CRM enrichment, and B2B prospecting.", "version": "0.0", "x-build-id": "v47vRLIu5uTGZRmI1" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/seralifatih~turkish-real-estate-api-2/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-seralifatih-turkish-real-estate-api-2", "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/seralifatih~turkish-real-estate-api-2/runs": { "post": { "operationId": "runs-sync-seralifatih-turkish-real-estate-api-2", "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/seralifatih~turkish-real-estate-api-2/run-sync": { "post": { "operationId": "run-sync-seralifatih-turkish-real-estate-api-2", "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": { "platforms": { "title": "Platforms", "type": "array", "description": "Which platforms to scrape. Default is all three supported platforms.", "items": { "type": "string", "enum": [ "emlakjet", "hepsiemlak", "sahibinden" ] }, "default": [ "emlakjet", "hepsiemlak", "sahibinden" ] }, "agencyUrls": { "title": "Agency Profile URLs", "type": "array", "description": "Direct agency profile or store URLs for Emlakjet, Hepsiemlak, or Sahibinden.", "items": { "type": "string" } }, "searchByCity": { "title": "Search By City", "type": "string", "description": "Discover agencies active in a Turkish province. Validated against the official list of 81 provinces." }, "searchByDistrict": { "title": "Search By District", "type": "string", "description": "Optional district filter. Requires Search By City and is validated against the selected province." }, "maxAgencies": { "title": "Max Agencies", "minimum": 1, "maximum": 1000, "type": "integer", "description": "Maximum number of agencies to scrape in one run.", "default": 50 }, "includePortfolio": { "title": "Include Portfolio Analytics", "type": "boolean", "description": "If enabled, also scrapes each agency's active listings and computes a portfolio summary.", "default": false }, "proxyConfig": { "title": "Proxy Configuration", "type": "object", "description": "Apify proxy config. Turkish residential proxies are strongly recommended for Sahibinden.", "default": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ], "countryCode": "TR" } }, "sahibindenCookies": { "title": "Sahibinden Session Cookies", "type": "array", "description": "Optional logged-in session cookies for Sahibinden. Without them, Sahibinden is skipped gracefully.", "items": { "type": "object" }, "default": [] } } }, "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 } } } } } } } } } }