{ "openapi": "3.0.1", "info": { "title": "Immobiliare.it Agency Scraper ā€” Contacts & Listings", "description": "Scrape Immobiliare.it real estate agencies ā€” search agenzie immobiliari by Italian comune, enrich by agency id or URL. Returns phone numbers, agency website, description, geo, portfolio and sold counts, plus full listing portfolios. For lead gen, CRM enrichment, and competitor intel.", "version": "1.0", "x-build-id": "lkVl8LybeYobwcn4W" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/sian.agency~immobiliare-agent-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-sian.agency-immobiliare-agent-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/sian.agency~immobiliare-agent-scraper/runs": { "post": { "operationId": "runs-sync-sian.agency-immobiliare-agent-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/sian.agency~immobiliare-agent-scraper/run-sync": { "post": { "operationId": "run-sync-sian.agency-immobiliare-agent-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": { "searchMode": { "title": "šŸ§­ Search Mode", "enum": [ "search", "lookup", "listings" ], "type": "string", "description": "How to collect data. **search** ā€” find agencies by Italian comune (up to 40 per comune, enriched with phones + website by default). **lookup** ā€” fetch enriched agency profiles directly by agency id or profile URL. **listings** ā€” walk an agency's full listing portfolio (price, address, geo, photos), paginated.", "default": "search" }, "locations": { "title": "šŸ“ Locations (search mode)", "type": "array", "description": "šŸ” **AGENCY DISCOVERY:** One or more Italian comune names (e.g. \"Milano\", \"Roma\", \"Torino\") or numeric comune ids (Milano = 8042). Each comune returns up to 40 agencies ā€” query multiple comuni for wider coverage.\n\nšŸ’” **TIP:** Click \"Bulk edit\" to paste one comune per line.\n\nāš ļø **FREE tier:** 1 location per run.", "items": { "type": "string" }, "default": [ "Milano" ] }, "lookupTargets": { "title": "šŸ”Ž Agency ids or URLs (lookup + listings modes)", "type": "array", "description": "šŸ¢ **DIRECT TARGETS:** Numeric agency ids (e.g. \"44166\", as returned by search mode) or agency profile URLs like `https://www.immobiliare.it/agenzie-immobiliari/44166/`.\n\nšŸ’” **TIP:** Run a comune search first to harvest agency ids, then feed them here for portfolio walks.\n\nāš ļø **FREE tier:** 1 target per run.", "items": { "type": "string" } }, "fetchAgencyDetails": { "title": "šŸ¢ Fetch full agency details", "type": "boolean", "description": "In search mode, enrich each directory row with the full agency profile ā€” **phone numbers, agency website, description, geo location, portfolio + sold counts**. Directory rows alone carry none of these. Adds 1 call per agency. Always on in lookup mode.", "default": true }, "maxAgenciesPerLocation": { "title": "šŸ“Š Max agencies per location", "minimum": 1, "maximum": 40, "type": "integer", "description": "Cap on agency records per comune search. The directory returns at most 40 agencies per comune (upstream cap). FREE tier hard-capped at 5 agencies per run.", "default": 40 }, "maxListingsPerAgency": { "title": "šŸ  Max listings per agency (listings mode)", "minimum": 1, "maximum": 2000, "type": "integer", "description": "Cap on portfolio rows per agency in listings mode (20 listings per page are fetched until this cap or the end of the portfolio). FREE tier hard-capped at 25 listing rows per run.", "default": 100 } } }, "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 } } } } } } } } } }