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
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-locations 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>µsiteShortName=<micrositeShortName>&operation=<operation>'
Query Result
Use Cases
- Map an agency's coverage footprint before choosing it for a partnership, referral deal or sales outreach.
- Run competitor territory analysis to find which municipalities a rival agency actually lists in.
- Choose the right locationId to combine with micrositeShortName when you later query that agency's listings.
- Power a relocation concierge finder that matches a client's destination city with agencies active there.
- Snapshot an agency's location list every week and diff it to detect expansion into new areas.
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.