List the locations where an Idealista agency microsite has properties

View all Idealista Property Listings API for Spain, Portugal & Italy endpoints →

Returns the places where a given agency microsite (professional profile) has properties, so you can see the agency's coverage area. Identify the agency with micrositeShortName (the slug that appears after /pro/ in its profile address, for example sumainmobiliaria), choose the country with location (es, pt or it), the response language with locale (es, it, pt, en, ca, de, fr, nl or nb), and supply a locationId (documented example 0-EU-ES-28) and an operation (documented example sale). All five inputs are required. No successful probe was recorded for this operation, so the exact response fields are not verified here; the endpoint is documented as returning the locations where the microsite has properties, and its structure should be checked on the first call before you build parsers around it.

API Features

Agency coverage footprint See every location where one agency microsite actually has properties, instead of guessing its territory from the agency's name or head office.
Lookup by microsite short name The agency is addressed by micrositeShortName, the slug found after /pro/ in its profile address, so any professional profile can be queried without a numeric agency ID.
Nine response languages The locale input accepts es, it, pt, en, ca, de, fr, nl and nb, so the same lookup can serve Spanish, Catalan, Dutch or English-speaking audiences.
Operation-scoped query A required operation input, documented with the example sale, ties the lookup to a listing operation so coverage is read for the kind of business you care about.
Companion to listing searches The locations an agency covers tell you which locationId values to pair with micrositeShortName on the listing endpoints that accept it, so follow-up searches are not wasted on empty areas.

Live API Demo

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

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-locations?key=<API_KEY>&locale=es&location=es&locationId=<locationId>&micrositeShortName=<micrositeShortName>&operation=<operation>'
📢
Need Help?
If you encounter API issues or need other API requirements, please contact us.
Contact Us

Use Cases

Frequently asked questions

How do I find the micrositeShortName of an agency?

It is the identifier in the agency's professional profile address, the part that follows /pro/. The documented example for this endpoint is sumainmobiliaria. The profile endpoint of this API uses the same identifier.

Which parameters are required?

All five: locale, location, locationId, micrositeShortName and operation. The documented examples are es, a country code (es, pt or it), 0-EU-ES-28, sumainmobiliaria and sale.

What does the locale parameter do?

It selects the language. The documented values are es, it, pt, en, ca, de, fr, nl and nb.

Which fields does the response contain?

The endpoint is documented as returning the locations where the microsite has properties. No successful probe was recorded for it, so field-level details are not verified; inspect the first response before fixing a schema.

Which operation values should I use?

The documented example is sale. The related sublocation endpoint of this API counts listings for sale and rent, so rent is the natural second value to try.

How is this different from the microsite profile endpoint?

This endpoint answers where the agency lists properties. The profile endpoint answers who the agency is: commercial name, website, contact information, languages and branding images.

Related operations

Guides

View Subscription Plans →