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

Location-ID driven premises search Search any Idealista area by locationId, such as 0-EU-ES-28-07-001-079, taking IDs from the suggestions and sublocations endpoints to move from a city down to a district.
Business-activity premises flags Fourteen boolean activity flags, including pharmacy, catering, retail, barsAndNightclub, educationalCenter, laboratory, tobaccoShop and sportsFacilities, narrow results to the kind of business a unit suits.
Street, mezzanine and shopping-centre placement The street, mezzanine, ontopfloor, underground, shoppingcenter and otherLocations flags separate high-street shop fronts from top-floor, basement and mall units.
Warehouse sale structure filters saleWarehouseOnly, saleWarehouseThirdPartiesRented and saleWarehouseWithBusinessTransfer, together with industrialBuilding and storehouse, isolate industrial supply by how it is being sold.
Price, size and publication-window bounds minPrice, maxPrice, minSize and maxSize cap the search, while sinceDate limits it to listings published in the last 24h (rent), 48h (sale), week or month.
Twelve sort orders with page controls Rank premises by relevance, price, price per m2, size, floor count, recency or price reduction using order, and walk the result set with numPage and maxItems.
Three country sites, nine languages The location parameter selects the Spanish, Italian or Portuguese site, and locale accepts es, it, pt, en, ca, de, fr, nl or nb for the language of the request.

Live API Demo

GET /api/project/idealista/list-commercial-properties

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/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'
📢
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 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.

Related operations

Guides

View Subscription Plans →