Idealista Agency Scraper — Emails, Phones & Socials

Build Idealista real estate agency lead lists with websites, email addresses, social profiles, phone numbers, addresses, logos, and activity signals.

Looking to scrape property listings instead of agencies? Use igolaizola/idealista-scraper.

🤖 What does Idealista Agency Scraper do?

Idealista Agency Scraper extracts structured real estate agency profiles from Idealista in Spain, Portugal, and Italy. Use it to scrape and download agency contact data for lead generation, CRM enrichment, market mapping, competitor research, and local real estate analysis.

It can return agency records with:

• Emails discovered from agency websites when available
• Social profiles such as Instagram, Facebook, LinkedIn, YouTube, X/Twitter, TikTok, and more
• Phone numbers from Idealista agency details
• Websites, agency names, profile identifiers, addresses, logos, slogans, active-since year, and listing totals

Great for: real estate lead generation, agency prospecting, CRM enrichment, regional market research, and competitor monitoring.

SEO keywords: Idealista agency scraper, scrape Idealista agencies, real estate agency emails, real estate agency phone numbers, Idealista API alternative, Apify actor.

💡 Why scrape Idealista agencies?

• 🎯 Build contact lists — collect agency names, websites, emails, social profiles, and phone numbers by country or province.
• 🤝 Enrich your CRM — add Idealista agency profiles, business websites, social links, and direct contact fields to sales workflows.
• 📍 Map local markets — see which agencies operate in selected Spanish, Portuguese, or Italian provinces.
• 📊 Monitor competitors — track agency branding, slogans, logos, activity year, and property-ad volume.
• 🔎 Find outreach targets — discover agencies with public emails, social channels, and reliable phone details.

🧠 How it works

The actor discovers agencies by country and province, then returns one dataset item per agency. Agency contact records can include three high-value outreach channels: emails, social profiles, and phone numbers.

Coverage:

• Spain — es
• Portugal — pt
• Italy — it
• One or more selected provinces, or all available provinces for the selected country

🚀 Quick start

1. Add the actor — Open Idealista Agency Scraper in Apify Store.
2. Choose a country — Set country to es, pt, or it.
3. Choose locations — Set locations for specific provinces, or leave it empty to scrape all provinces in the selected country.
4. Set your limit — Use maxItems to control how many agencies are saved.
5. Run the actor — Click Run.
6. Download contacts — Export agencies from the Dataset as JSON, CSV, Excel, or through the Apify API.

💳 Pricing

Apify's Free plan includes monthly credits for small tests. For recurring agency lead generation or country-wide runs, use a paid Apify plan with higher usage limits.

📝 Input parameters

Parameter	Type	Required	Description
maxItems	Integer	No	Maximum number of agencies to save. Default is 50. Use 0 for unlimited. Values from 1 to 14 are rounded up to 15.
country	String	No	Country to scrape. Supported values: es · pt · it. Default is es.
locations	Array of strings	No	Province Location IDs to scrape. Leave empty to scrape all known provinces for the selected country. Locations from other countries are skipped.
proxyConfiguration	Object	No	Apify proxy settings. Residential proxies are recommended for stable runs.

Spain — Madrid and Barcelona agency contacts

{
  "maxItems": 200,
  "country": "es",
  "locations": ["0-EU-ES-28", "0-EU-ES-08"],
  "proxyConfiguration": {
    "useApifyProxy": true,
    "apifyProxyGroups": ["RESIDENTIAL"]
  }
}

Portugal — all provinces, larger lead list

{
  "maxItems": 1000,
  "country": "pt",
  "locations": [],
  "proxyConfiguration": {
    "useApifyProxy": true,
    "apifyProxyGroups": ["RESIDENTIAL"]
  }
}

📊 Output results

Each dataset item is one Idealista agency profile. Fields may vary depending on what is publicly available for the agency.

• shortName (string) — Idealista agency profile identifier
• commercialName (string) — agency display name
• agencyWebUrl (string) — agency website, when available
• emails (array) — public emails discovered from the agency website
• socials (array) — public social media profile URLs discovered from the agency website
• contactInfo.phone (string) — phone number from Idealista details
• contactInfo.contactPhone (object) — formatted phone details, prefix, and dialing variants
• contactInfo.address (object) — street, postal code, city, and coordinates when available
• multimedias (object) — logos and agency images
• slogan (string) — agency tagline or description when available
• activeSinceYear (string) — year the agency has been active on Idealista
• total (number) — visible property-ad count when available
• commercialDataId (number) — Idealista commercial identifier

[
  {
    "shortName": "acme-realty-bcn",
    "commercialName": "ACME Realty Barcelona",
    "agencyWebUrl": "https://acme-realty.example.com",
    "emails": ["hello@acme-realty.example.com", "sales@acme-realty.example.com"],
    "socials": [
      "https://www.instagram.com/acmerealty",
      "https://www.facebook.com/acmerealtybarcelona"
    ],
    "activeSinceYear": "2001",
    "slogan": "Especialistas en viviendas singulares en Barcelona.",
    "contactInfo": {
      "phone": "+34999000123",
      "contactPhone": {
        "phoneNumber": "999000123",
        "formattedPhone": "999 00 01 23",
        "prefix": "34",
        "phoneNumberForMobileDialing": "+34999000123",
        "nationalNumber": true,
        "formattedPhoneWithPrefix": "+34 999 00 01 23"
      },
      "address": {
        "streetName": "Calle Mallorca",
        "locationName": "Barcelona",
        "postalCode": "08008",
        "latitude": 41.3917,
        "longitude": 2.1649
      }
    },
    "multimedias": {
      "mainImage": "https://images.example.com/acme-main.jpg",
      "brandingLogo": "https://images.example.com/acme-logo.png"
    },
    "total": 42,
    "commercialDataId": 999001001
  }
]

🧭 Tips and common recipes

• Country-wide prospecting: leave locations empty and set a higher maxItems.
• Focused outreach: choose specific province Location IDs such as 0-EU-ES-28 for Madrid or 0-EU-ES-08 for Barcelona.
• CRM imports: export CSV and use commercialName, agencyWebUrl, emails, socials, and contactInfo.phone.
• Regional competitor mapping: compare total, activeSinceYear, logos, slogans, and websites across provinces.
• Repeat runs: re-run periodically to discover new agencies and updated contact channels.

🌍 Proxy usage

Residential proxies are recommended for stable scraping and lower blocking risk. In Apify Console, enable Apify Proxy and select the RESIDENTIAL group.

⚖️ Legal and ethical considerations

• Scrape only public business information and use it responsibly.
• Follow Idealista's Terms of Service and applicable laws.
• Handle emails and phone numbers carefully under privacy laws such as GDPR.
• Keep outreach compliant, relevant, and easy to opt out of.
• Avoid excessive traffic and unnecessary repeated runs.
• This actor is independent and is not affiliated with, endorsed by, or sponsored by Idealista. All trademarks belong to their owners.

❓ FAQ

Does the actor return emails? Yes. When an agency website is available, the actor can include public email addresses discovered from that website.

Does the actor return social profiles? Yes. Results can include public social media URLs such as Instagram, Facebook, LinkedIn, YouTube, X/Twitter, TikTok, and other supported profiles.

Are phone numbers included? Yes. Phone numbers come from Idealista agency details and are included under contactInfo.phone and related formatted phone fields when available.

Can I scrape all agencies in a country? Yes. Set country and leave locations empty. Use maxItems: 0 for no item limit.

Why are some emails or socials missing? Not every agency publishes a website or contact channels publicly. Missing fields mean the data was not publicly available or could not be discovered reliably.

🛟 Support

Need a custom field, another country, or a different export format? Contact the developer at https://igolaizola.com/#contact or https://t.me/igolaizola.