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 and province locations 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 in:

• 🌍 Spain (es), Portugal (pt), Italy (it)
• 📍 One or more selected provinces
• 🗺️ All available provinces for a selected country

💡 Typical uses

• 🎯 Build a contact list of agencies active in selected provinces
• 🧭 Map who operates where across a country or region
• 📊 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.
2. Optionally select one or more province locations for that country.
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 country and optionally choose one or more locations.
   • Leave locations empty to scrape all available provinces for the selected country.
   • If locations from another country are selected, they are ignored.
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 locations only when you want specific provinces; leave it empty to cover all available provinces for that country.

Required

Parameter	Options / Example	Description
country	es, pt, it	Country to scrape

Core options

Parameter	Type / Default	Description
maxItems	Integer, default 50 (0 = unlimited)	Number of agencies to save
locations	Array of province Location IDs, optional	Provinces to scrape; empty = all provinces for selected country
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,
  "country": "es",
  "locations": ["0-EU-ES-28", "0-EU-ES-08"],
  "proxyConfiguration": {
    "useApifyProxy": true,
    "apifyProxyGroups": ["RESIDENTIAL"]
  }
}

📊 Output

You'll get agency records discovered from the selected country and province locations. 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 available provinces in a country, leave locations empty.
• For narrower searches, choose one or more province Location IDs such as 0-EU-ES-28 for Madrid or 0-EU-ES-08 for Barcelona.
• Keep country and locations aligned. Locations from other countries are skipped.
• 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?