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

{
  "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.

[
  {
    "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?