List Commercial Premises for Sale or Rent
View all Idealista Property Listings API for Spain, Portugal & Italy endpoints →Returns one page of Idealista commercial premises listings for a single location. Required inputs: locationId (an Idealista location ID such as 0-EU-ES-28-07-001-079, resolved with the suggestions and sublocations endpoints), location (country site: es, it or pt), locale (language code: es, it, pt, en, ca, de, fr, nl or nb), operation (sale or rent), order (one of twelve sort orders from relevance to lowestfloors), maxItems (listed values 30, 40 and 0) and numPage (page number, 1 in the example). Optional inputs narrow the search by minPrice, maxPrice, minSize and maxSize; by publication window through sinceDate (T last 24h for rent only, Y last 48h for sale only, W last week, M last month); by agency through micrositeShortName; by premises type (premises, industrialBuilding, storehouse and three saleWarehouse flags); by business activity (for example pharmacy, catering, retail, barsAndNightclub, accommodation); and by placement (street, mezzanine, ontopfloor, underground, shoppingcenter, otherLocations). No live response sample or response schema is attached to this endpoint, so the listing fields are not verified here: inspect a live response before mapping fields. How several boolean flags combine is not documented, so test the combinations you rely on.
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/list-commercial-properties API Response (JSON)
{} curl -X GET 'https://api.opendata-api.com/api/project/idealista/list-commercial-properties?key=<API_KEY>&locale=es%2Cit%2Cpt%2Cen%2Cca%2Cde%2Cfr%2Cnl%2Cnb&location=es%2Cit%2Cpt&locationId=<locationId>&maxItems=30%2C40%2C0&numPage=<numPage>&operation=sale%2Crent&order=relevance%2Clowestprice%2Chighestprice%2Cmostrecent%2Cleastrecent%2Chighestpricereduction%2Clowestpricem2%2Chighestpricem2%2Cbiggest%2Csmallest%2Chighestfloors%2Clowestfloors'
Query Result
Use Cases
- Franchise site selection: shortlist pharmacy, cafe, gym, beauty or education premises on a chosen street within a size band.
- Retail rent benchmarking: combine the street flag with minSize, maxSize and price bounds to compare shop-unit asking rents between streets or neighbourhoods.
- Hospitality venue scouting: list bar, nightclub and catering premises in a district for operators looking for a new location.
- Industrial supply tracking: watch warehouse and industrial-building stock with the industrialBuilding, storehouse and saleWarehouse flags for logistics buyers and investors.
- Shopping-centre expansion research: find units inside malls with the shoppingcenter flag for brands entering the Spanish, Italian or Portuguese market.
- New-listing alerts: poll with sinceDate set to W or M and order set to mostrecent to catch freshly published commercial premises.
Frequently asked questions
How do I get the locationId for a commercial properties search?
Use the suggestions endpoint to resolve a place name to a location ID and the sublocations endpoint to drill down from a city to its districts. The documented example ID is 0-EU-ES-28-07-001-079.
Which parameters are required?
Seven query parameters are required: locationId, location, locale, operation, order, maxItems and numPage. Every price, size, date, agency and premises-type filter is optional.
How do I search only for pharmacies, bars or other business types?
Set the matching boolean flag to true, for example pharmacy, catering, barsAndNightclub, retail, accommodation or tobaccoShop. The reference does not state whether several flags combine as AND or OR, so test the combination you need.
How does the sinceDate filter work?
Leave it blank for no date limit, or use T for the last 24 hours (rent operation only), Y for the last 48 hours (sale operation only), W for the last week or M for the last month.
How do I page through and sort results?
Increase numPage, which is 1 in the documented example, and choose one order value such as relevance, lowestprice, highestprice, mostrecent, biggest or lowestpricem2. maxItems lists 30, 40 and 0 as values, and the meaning of 0 is not documented.
Can I search sale and rent in one call?
The reference lists sale and rent as the two operation values. Send one of them per request so the results and the sinceDate options, where T is rent only and Y is sale only, stay unambiguous.
Which countries and languages are supported?
location selects the country site (es, it or pt) and locale accepts es, it, pt, en, ca, de, fr, nl or nb. Use a locationId from the same country as the selected site.
What fields does each listing contain?
No live probe or response example is attached to this endpoint yet, so the field names are not verified here. Call the endpoint once with your parameters and inspect the JSON before building a schema.