Idealista Agency Scraper > 🔍 Looking to scrape property listings (not agencies) on Idealista? > Use this actor instead: https://apify.com/igolaizola/idealista-scraper ## 🤖 What does Idealista Agency Scraper do? Idealista Agency Scraper finds real estate agencies operating on idealista.com by first listing property ads for your target operation, property type, country, and location—then extracting the agency data found in those ads. Perfect for lead generation, market mapping, competitor tracking, and CRM enrichment. It can discover agencies from listings for: - 🏘️ Homes and 🏗️ New developments - 🏢 Offices, 🏪 Premises, 🚗 Garages, 🧱 Lands, 📦 Storage rooms, 🏬 Buildings - 🛏️ Bedrooms (only for rent) - 🌍 Spain (es), Portugal (pt), Italy (it) - 🔁 Sale or Rent ## 💡 Typical uses - 🎯 Build a contact list of agencies active in a city or region - 🧭 Map who operates where and in which typologies (homes, offices, etc.) - 📊 Track agency activity (ads volume) and branding (logos, slogans, websites) - 🤝 Feed your CRM with agency names, phones, addresses, and microsite slugs ## 🛠️ How it works 1. Search idealista listings using your operation, propertyType, country, and location. 2. From each ad, extract the agency (microsite) identifiers. 3. De-duplicate agencies across ads. 4. Output one record per agency with contact info, logos, activity year, and more. ## 🚀 Quick start 1. Click Try for free. 2. Set: operation, propertyType, country, and location. - Use the Idealista Location Search Tool to find a Location ID (e.g. 0-EU-ES-28-07-001-079). 3. (Optional) Adjust maxItems (how many listing ads to scan; 0 = unlimited). 4. Click Run. 5. Download your agencies from the Dataset in JSON/CSV. ## ⚠️ Notes & limits - Discovery-based: agencies are found via listing ads. If an agency has no current ads in your scope, it won't appear. - Ordering: results depend on listing retrieval order; agency order is not globally sorted. - Bedrooms: the bedrooms typology exists only for rent. - Coverage: Works with Spain, Portugal, Italy only. ## 💳 Cost Apify gives you $5 free monthly credits on the Free plan—enough to try the actor. For regular use, the $49 Personal plan typically covers frequent runs comfortably. ## 📝 Input parameters You can provide either a city name or an Idealista Location ID for location. Find the Location ID with the Idealista Location Search Tool. ### Required ### Required | Parameter | Options / Example | Description | | -------------- | -------------------------------------------------------------------------------------------------------------- | ------------------------------------------------- | | operation | sale, rent | Listing operation to scan for agencies | | propertyType | homes, newDevelopments, offices, premises, garages, lands, storageRooms, buildings, bedrooms | Typology to search (note: bedrooms = rent only) | | country | es, pt, it | Country | | location | "Madrid" or "0-EU-ES-28-07-001-079" | City name or Idealista Location ID | ### Core options | Parameter | Type / Default | Description | | -------------------- | ----------------------------------------- | ------------------------------------------------------------------------ | | maxItems | Integer, default 50 (0 = unlimited) | Number of listing ads to scan for agencies (not agencies themselves) | | proxyConfiguration | Proxy object | Use Apify Residential proxies for stability and lower blocking | ### Proxy (recommended) Use Apify's proxy editor with: - useApifyProxy: true - apifyProxyGroups: ["RESIDENTIAL"] ✅ > Residential proxies help prevent detection and IP blocking. ## 🧪 Example input json { "maxItems": 200, "operation": "sale", "propertyType": "homes", "country": "es", "location": "0-EU-ES-28-07-001-079", "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": ["RESIDENTIAL"] } } ## 📊 Output You'll get one record per agency discovered in the scanned ads (de-duplicated). Fields typically include slug, name, website, phones, address, logos/images, activeSinceYear, totals, and flags. json [ { "shortName": "acme-realty-bcn", "activeSinceYear": "2001", "commercialName": "ACME Realty Barcelona", "agencyWebUrl": "https://acme-realty.example.com", "slogan": "Especialistas en viviendas singulares en Barcelona. Trato cercano y resultados sobresalientes.", "defaultTypology": "homes", "defaultOperation": "sale", "contactInfo": { "phone": "+34999000123", "contactPhone": { "phoneNumber": "999000123", "formattedPhone": "999 00 01 23", "prefix": "34", "phoneNumberForMobileDialing": "+34999000123", "nationalNumber": true, "formattedPhoneWithPrefix": "+34 999 00 01 23" }, "showContactButton": true, "proAgent": false, "address": { "streetName": "Calle Falsa", "streetNumber": 123, "locationName": "Barcelona", "postalCode": "08001", "latitude": 41.3851, "longitude": 2.1734 } }, "multimedias": { "mainImage": "https://images.example.com/main-acme-realty-bcn.jpg", "brandingLogo": "https://images.example.com/logo-acme-realty-bcn.png" }, "total": 42, "commercialDataId": 999001001, "hasChatEnabled": true, "micrositeLeadAllowed": true, "corporateVideo": { "url": "https://videos.example.com/acme-realty-bcn.mp4", "thumbnail": "https://images.example.com/thumb-acme-realty-bcn.jpg" }, "corporatePhrase": { "text": "Viviendas únicas, servicio honesto y ágil. Tu casa ideal empieza aquí.", "autoTranslated": false } } // more agencies… ] ## 🧭 Tips - For narrower searches, target districts or neighborhoods (use the Location Search Tool for precise IDs). - Increase maxItems to scan more ads → higher chance of discovering more agencies. - Re-run periodically to track new entrants and branding changes (logos, slogans). ## ⚖️ Legal This tool extracts public business information exposed on idealista listings/microsites. Comply with local laws (e.g., GDPR). Avoid collecting or processing personal data without a legal basis. Read more: Is web scraping legal?