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

Agency identity fields Returns shortName, commercialName, slogan, activeSinceYear and commercialDataId, giving you a stable identity record for an agency in one call.
Contact and address block The contactInfo object carries the phone number in several formats, a showContactButton flag, a proAgent flag and an address with street, locality, postal code and coordinates.
Languages the agency serves A languages array lists the languages offered by the agency, which lets you filter agencies for English or other non-Spanish-speaking clients.
Branding images The multimedias object returns mainImage and brandingLogo, enough to render an agency card or directory page without scraping the profile.
Chat and lead flags hasChatEnabled and micrositeLeadAllowed are booleans that show whether the agency accepts online chat and lead enquiries through its microsite.
Default search hints defaultTypology and defaultOperation reveal what the agency primarily advertises, a useful signal for segmenting agencies by specialty.

Live API Demo

GET /api/project/idealista/get-microsite-profile

Request cost is temporarily unavailable. No price is assumed.

View pricing

API Response (JSON)

{}
curl -X GET 'https://api.opendata-api.com/api/project/idealista/get-microsite-profile?key=<API_KEY>&location=es%2Cpt%2Cit&micrositeShortName=jaime-valcarce-consulting-inmobiliario'
📢
Need Help?
If you encounter API issues or need other API requirements, please contact us.
Contact Us

Use Cases

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.

Related operations

Guides

View Subscription Plans →