Idealista Agency Scraper

🔍 Looking to scrape property listings (not agencies) on Idealista?
Use this actor instead: 👉 igolaizola/idealista-scraper

🤖 What does Idealista Agency Scraper do?

Idealista Agency Scraper helps you build a structured list of real estate agencies active on Idealista. Choose the country, location, operation, and property type you care about, and the actor returns agency profiles with useful business details such as names, phone numbers, addresses, websites, logos, slogans, and activity signals when available. Perfect for lead generation, market mapping, competitor tracking, and CRM enrichment.

It can discover agencies for:

• 🏘️ Homes and 🏗️ New developments
• 🏢 Offices, 🏪 Premises, 🚗 Garages, 🧱 Lands, 📦 Storage rooms, 🏬 Buildings
• 🛏️ Bedrooms
• 🌍 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, websites, and profile identifiers

🛠️ How it works

1. Select a country and, optionally, a specific city or region.
2. Choose whether you want agencies active in sale or rent, and for which property type.
3. The actor collects matching agencies from Idealista.
4. Download a clean dataset with one row per agency.

🚀 Quick start

1. Click Try for free.

2. Set operation, propertyType, country, and optionally location.

   • Leave location empty to scrape all provinces/districts for the selected country.
   • Use a city name or Idealista Location ID to scrape one location.

3. Adjust maxItems (0 = unlimited).

4. Click Run.

5. Download your agencies from the Dataset in JSON/CSV.

⚠️ Notes & limits

• Discovery-based: agencies are found through Idealista's agency directory for your selected scope.
• Ordering: results depend on directory retrieval order; agency order is not globally sorted.
• 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 $29 Personal plan typically covers frequent runs comfortably.

📝 Input parameters

Choose the country in country. Use location only when you want a specific scope; leave it empty to iterate all provinces/districts for that country.

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
country	es, pt, it	Country to scrape

Core options

Parameter	Type / Default	Description
maxItems	Integer, default 50 (0 = unlimited)	Number of agencies to save
location	String, default empty	City name or Idealista Location ID; empty = all provinces
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

{
  "maxItems": 200,
  "operation": "sale",
  "propertyType": "homes",
  "country": "es",
  "location": "Madrid",
  "proxyConfiguration": {
    "useApifyProxy": true,
    "apifyProxyGroups": ["RESIDENTIAL"]
  }
}

📊 Output

You'll get agency records discovered from the selected country, location, operation, and property type. Fields typically include slug, name, website, phones, address, logos/images, activeSinceYear, totals, and flags.

[
  {
    "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 all provinces/districts in a country, leave location empty.
• For narrower searches, set location to a city name like Barcelona or an Idealista Location ID like 0-EU-ES-08.
• Increase maxItems to save more agencies from the directory pages.
• 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?