{ "openapi": "3.0.1", "info": { "title": "Idealista Agency Scraper", "description": "Discover real estate agencies by scanning Idealista listings (sale or rent) in Spain, Portugal, and Italy. Outputs de-duplicated agency profiles with phones, websites, logos, slogans, activity year, and ad totals. Provide a city or Location ID and get clean JSON/CSV.", "version": "0.0", "x-build-id": "dV6bQgjGR8rnlleco" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/igolaizola~idealista-agency-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-igolaizola-idealista-agency-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/igolaizola~idealista-agency-scraper/runs": { "post": { "operationId": "runs-sync-igolaizola-idealista-agency-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/igolaizola~idealista-agency-scraper/run-sync": { "post": { "operationId": "run-sync-igolaizola-idealista-agency-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", "proxyConfiguration" ], "properties": { "maxItems": { "title": "Max Items", "minimum": 0, "type": "integer", "description": "Maximum number of agencies to scrape (0 for unlimited). Values from 1 to 14 are rounded up to 15 agencies.", "default": 50 }, "country": { "title": "Country", "enum": [ "es", "pt", "it" ], "type": "string", "description": "Select country.", "default": "es" }, "locations": { "title": "Locations (leave empty to scrape all provinces)", "uniqueItems": true, "type": "array", "description": "Province locations to scrape. Leave empty to scrape all provinces for the selected country. Locations from other countries are skipped.", "items": { "type": "string", "enum": [ "0-EU-ES-01", "0-EU-ES-02", "0-EU-ES-03", "0-EU-ES-04", "0-EU-ES-05", "0-EU-ES-06", "0-EU-ES-07", "0-EU-ES-08", "0-EU-ES-09", "0-EU-ES-10", "0-EU-ES-11", "0-EU-ES-12", "0-EU-ES-13", "0-EU-ES-14", "0-EU-ES-15", "0-EU-ES-16", "0-EU-ES-17", "0-EU-ES-18", "0-EU-ES-19", "0-EU-ES-20", "0-EU-ES-21", "0-EU-ES-22", "0-EU-ES-23", "0-EU-ES-24", "0-EU-ES-25", "0-EU-ES-26", "0-EU-ES-27", "0-EU-ES-28", "0-EU-ES-29", "0-EU-ES-30", "0-EU-ES-31", "0-EU-ES-32", "0-EU-ES-33", "0-EU-ES-34", "0-EU-ES-35", "0-EU-ES-36", "0-EU-ES-37", "0-EU-ES-38", "0-EU-ES-39", "0-EU-ES-40", "0-EU-ES-41", "0-EU-ES-42", "0-EU-ES-43", "0-EU-ES-44", "0-EU-ES-45", "0-EU-ES-46", "0-EU-ES-47", "0-EU-ES-48", "0-EU-ES-49", "0-EU-ES-50", "0-EU-ES-51", "0-EU-ES-52", "0-EU-ES-53", "0-EU-ES-54", "0-EU-ES-55", "0-EU-ES-56", "0-EU-IT-AG", "0-EU-IT-AL", "0-EU-IT-AN", "0-EU-IT-AO", "0-EU-IT-AP", "0-EU-IT-AQ", "0-EU-IT-AR", "0-EU-IT-AT", "0-EU-IT-AV", "0-EU-IT-AZ", "0-EU-IT-BA", "0-EU-IT-BG", "0-EU-IT-BI", "0-EU-IT-BL", "0-EU-IT-BN", "0-EU-IT-BO", "0-EU-IT-BR", "0-EU-IT-BS", "0-EU-IT-BT", "0-EU-IT-BZ", "0-EU-IT-CA", "0-EU-IT-CB", "0-EU-IT-CE", "0-EU-IT-CH", "0-EU-IT-CL", "0-EU-IT-CN", "0-EU-IT-CO", "0-EU-IT-CR", "0-EU-IT-CS", "0-EU-IT-CT", "0-EU-IT-CZ", "0-EU-IT-EN", "0-EU-IT-FC", "0-EU-IT-FE", "0-EU-IT-FG", "0-EU-IT-FI", "0-EU-IT-FM", "0-EU-IT-FR", "0-EU-IT-GE", "0-EU-IT-GO", "0-EU-IT-GR", "0-EU-IT-IM", "0-EU-IT-IS", "0-EU-IT-KR", "0-EU-IT-LC", "0-EU-IT-LE", "0-EU-IT-LI", "0-EU-IT-LO", "0-EU-IT-LT", "0-EU-IT-LU", "0-EU-IT-MB", "0-EU-IT-MC", "0-EU-IT-ME", "0-EU-IT-MI", "0-EU-IT-MN", "0-EU-IT-MO", "0-EU-IT-MS", "0-EU-IT-MT", "0-EU-IT-NA", "0-EU-IT-NO", "0-EU-IT-NU", "0-EU-IT-OR", "0-EU-IT-PA", "0-EU-IT-PC", "0-EU-IT-PD", "0-EU-IT-PE", "0-EU-IT-PG", "0-EU-IT-PI", "0-EU-IT-PN", "0-EU-IT-PO", "0-EU-IT-PR", "0-EU-IT-PT", "0-EU-IT-PU", "0-EU-IT-PV", "0-EU-IT-PZ", "0-EU-IT-RA", "0-EU-IT-RC", "0-EU-IT-RE", "0-EU-IT-RG", "0-EU-IT-RI", "0-EU-IT-RM", "0-EU-IT-RN", "0-EU-IT-RO", "0-EU-IT-SA", "0-EU-IT-SI", "0-EU-IT-SM", "0-EU-IT-SO", "0-EU-IT-SP", "0-EU-IT-SR", "0-EU-IT-SS", "0-EU-IT-SU", "0-EU-IT-SV", "0-EU-IT-TA", "0-EU-IT-TE", "0-EU-IT-TI", "0-EU-IT-TN", "0-EU-IT-TO", "0-EU-IT-TP", "0-EU-IT-TR", "0-EU-IT-TS", "0-EU-IT-TV", "0-EU-IT-UD", "0-EU-IT-VA", "0-EU-IT-VB", "0-EU-IT-VC", "0-EU-IT-VE", "0-EU-IT-VI", "0-EU-IT-VR", "0-EU-IT-VT", "0-EU-IT-VV", "0-EU-PT-01", "0-EU-PT-02", "0-EU-PT-03", "0-EU-PT-04", "0-EU-PT-05", "0-EU-PT-06", "0-EU-PT-07", "0-EU-PT-08", "0-EU-PT-09", "0-EU-PT-10", "0-EU-PT-11", "0-EU-PT-12", "0-EU-PT-13", "0-EU-PT-14", "0-EU-PT-15", "0-EU-PT-16", "0-EU-PT-17", "0-EU-PT-18", "0-EU-PT-31", "0-EU-PT-32", "0-EU-PT-41", "0-EU-PT-42", "0-EU-PT-43", "0-EU-PT-44", "0-EU-PT-45", "0-EU-PT-46", "0-EU-PT-47", "0-EU-PT-48", "0-EU-PT-49" ], "enumTitles": [ "Spain: Álava", "Spain: Albacete", "Spain: Alicante", "Spain: Almería", "Spain: Ávila", "Spain: Badajoz", "Spain: Balears (Illes)", "Spain: Barcelona", "Spain: Burgos", "Spain: Cáceres", "Spain: Cádiz", "Spain: Castellón", "Spain: Ciudad Real", "Spain: Córdoba", "Spain: A Coruña", "Spain: Cuenca", "Spain: Girona", "Spain: Granada", "Spain: Guadalajara", "Spain: Guipúzcoa", "Spain: Huelva", "Spain: Huesca", "Spain: Jaén", "Spain: León", "Spain: Lleida", "Spain: La Rioja", "Spain: Lugo", "Spain: Madrid", "Spain: Málaga", "Spain: Murcia", "Spain: Navarra", "Spain: Ourense", "Spain: Asturias", "Spain: Palencia", "Spain: Las Palmas", "Spain: Pontevedra", "Spain: Salamanca", "Spain: Santa Cruz de Tenerife", "Spain: Cantabria", "Spain: Segovia", "Spain: Sevilla", "Spain: Soria", "Spain: Tarragona", "Spain: Teruel", "Spain: Toledo", "Spain: València", "Spain: Valladolid", "Spain: Vizcaya", "Spain: Zamora", "Spain: Zaragoza", "Spain: Ceuta", "Spain: Melilla", "Spain: Andorra", "Spain: País Vasco Francés", "Spain: Cerdanya Francesa", "Spain: Gibraltar", "Italy: Agrigento", "Italy: Alessandria", "Italy: Ancona", "Italy: Aosta", "Italy: Ascoli Piceno", "Italy: L'Aquila", "Italy: Arezzo", "Italy: Asti", "Italy: Avellino", "Italy: Alpi Marittime - Costa Azzurra", "Italy: Bari", "Italy: Bergamo", "Italy: Biella", "Italy: Belluno", "Italy: Benevento", "Italy: Bologna", "Italy: Brindisi", "Italy: Brescia", "Italy: Barletta-Andria-Trani", "Italy: Bolzano-Bozen", "Italy: Cagliari", "Italy: Campobasso", "Italy: Caserta", "Italy: Chieti", "Italy: Caltanissetta", "Italy: Cuneo", "Italy: Como", "Italy: Cremona", "Italy: Cosenza", "Italy: Catania", "Italy: Catanzaro", "Italy: Enna", "Italy: Forlì-Cesena", "Italy: Ferrara", "Italy: Foggia", "Italy: Firenze", "Italy: Fermo", "Italy: Frosinone", "Italy: Genova", "Italy: Gorizia", "Italy: Grosseto", "Italy: Imperia", "Italy: Isernia", "Italy: Crotone", "Italy: Lecco", "Italy: Lecce", "Italy: Livorno", "Italy: Lodi", "Italy: Latina", "Italy: Lucca", "Italy: Monza-Brianza", "Italy: Macerata", "Italy: Messina", "Italy: Milano", "Italy: Mantova", "Italy: Modena", "Italy: Massa-Carrara", "Italy: Matera", "Italy: Napoli", "Italy: Novara", "Italy: Nuoro", "Italy: Oristano", "Italy: Palermo", "Italy: Piacenza", "Italy: Padova", "Italy: Pescara", "Italy: Perugia", "Italy: Pisa", "Italy: Pordenone", "Italy: Prato", "Italy: Parma", "Italy: Pistoia", "Italy: Pesaro Urbino", "Italy: Pavia", "Italy: Potenza", "Italy: Ravenna", "Italy: Reggio Calabria", "Italy: Reggio Emilia", "Italy: Ragusa", "Italy: Rieti", "Italy: Roma", "Italy: Rimini", "Italy: Rovigo", "Italy: Salerno", "Italy: Siena", "Italy: San Marino", "Italy: Sondrio", "Italy: La Spezia", "Italy: Siracusa", "Italy: Sassari", "Italy: Sud Sardegna", "Italy: Savona", "Italy: Taranto", "Italy: Teramo", "Italy: Canton Ticino", "Italy: Trento", "Italy: Torino", "Italy: Trapani", "Italy: Terni", "Italy: Trieste", "Italy: Treviso", "Italy: Udine", "Italy: Varese", "Italy: Verbano-Cusio-Ossola", "Italy: Vercelli", "Italy: Venezia", "Italy: Vicenza", "Italy: Verona", "Italy: Viterbo", "Italy: Vibo Valentia", "Portugal: Aveiro", "Portugal: Beja", "Portugal: Braga", "Portugal: Bragança", "Portugal: Castelo Branco", "Portugal: Coímbra", "Portugal: Évora", "Portugal: Faro", "Portugal: Guarda", "Portugal: Leiria", "Portugal: Lisboa", "Portugal: Portalegre", "Portugal: Oporto", "Portugal: Santarém", "Portugal: Setúbal", "Portugal: Viana do Castelo", "Portugal: Vila Real", "Portugal: Viseu", "Portugal: Madeira", "Portugal: Porto Santo", "Portugal: Santa Maria", "Portugal: São Miguel", "Portugal: Terceira", "Portugal: Graciosa", "Portugal: São Jorge", "Portugal: Pico", "Portugal: Faial", "Portugal: Flores", "Portugal: Corvo" ] }, "default": [] }, "proxyConfiguration": { "title": "Proxy Configuration", "type": "object", "description": "Proxy settings. Residential proxies are recommended.", "default": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] } } } }, "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 } } } } } } } } } }