Get an Idealista agency microsite profile with name, website, contact info and languages
View all Idealista Property Listings API for Spain, Portugal & Italy endpoints →Returns the profile of one agency microsite, identified by micrositeShortName (the slug after /pro/ in the agency's profile address), within the countries given in location (es, pt, it; the documented default is es,pt,it). In the recorded probe (location=es, micrositeShortName=jaime-valcarce-consulting-inmobiliario) the endpoint answered HTTP 200 with a JSON object containing shortName, activeSinceYear, commercialName, agencyWebUrl, slogan, defaultTypology, defaultOperation, contactInfo (phone, a contactPhone object with formatted and dialing variants, showContactButton, proAgent and an address object with street, locality, postal code and coordinates), multimedias (mainImage and brandingLogo), an integer total, a languages array, commercialDataId, hasChatEnabled, micrositeLeadAllowed and corporatePhrase (text and autoTranslated). The profile does not include the agency's property listings.
API Features
Live API Demo
🔒 Sign in to try it live
Log in to call this API with your own API key. New accounts get 100 free credits — no card required.
Log in / Sign upNo active API key found. Create one in your Dashboard, then reload this page. Dashboard →
/api/project/idealista/get-microsite-profile API Response (JSON)
{} curl -X GET 'https://api.opendata-api.com/api/project/idealista/get-microsite-profile?key=<API_KEY>&location=es%2Cpt%2CitµsiteShortName=jaime-valcarce-consulting-inmobiliario'
Query Result
Use Cases
- Enrich a CRM of Spanish agencies with commercialName, agencyWebUrl and contactInfo for outreach and deduplication.
- Shortlist agencies that serve expat clients by checking the languages array for English or Chinese-speaking service.
- Use hasChatEnabled to find agencies that answer online enquiries quickly before routing leads to them.
- Attach a verified agency identity to property listings pulled from the search endpoints of this API.
- Generate agency directory pages with names, slogans, addresses and branding images from the multimedias object.
Frequently asked questions
Where do I get the micrositeShortName?
It is the identifier in the agency's professional profile address, the part after /pro/. The documented example and default is jaime-valcarce-consulting-inmobiliario. The locations endpoint for microsites uses the same identifier.
What should I put in the location parameter?
Country codes from es, pt and it. The documented default is the comma-separated list es,pt,it, and the recorded probe used es alone.
Which fields does the profile response contain?
The recorded probe returned shortName, activeSinceYear, commercialName, agencyWebUrl, slogan, defaultTypology, defaultOperation, contactInfo, multimedias, total, languages, commercialDataId, hasChatEnabled, micrositeLeadAllowed and corporatePhrase. The meaning of the integer total field is not documented.
What is inside contactInfo?
In the probe it held phone, a contactPhone object (phoneNumber, formattedPhone, prefix, phoneNumberForMobileDialing, nationalNumber, formattedPhoneWithPrefix), showContactButton, proAgent and an address object with streetName, streetNumber, locationName, postalCode, latitude and longitude.
Can I see whether an agency offers chat support?
Yes. The hasChatEnabled boolean indicates whether chat is enabled for the microsite, and micrositeLeadAllowed shows whether lead enquiries are allowed.
Does this endpoint return the agency's properties?
No. It returns the profile only. Use the microsite locations endpoint to see where the agency lists properties, and the listing endpoints of this API to retrieve the properties.