List offices for sale or rent on Idealista
View all Idealista Property Listings API for Spain, Portugal & Italy endpoints →Returns a paginated list of office properties advertised on Idealista under Buy/Rent > Offices for one location. Required inputs are the country site (location: es, it or pt), the response language (locale), a locationId taken from the suggestions or sublocations endpoints, the operation (sale or rent), a sort order, the page number (numPage) and the page size (maxItems, up to 40; 0 returns only the item count). Optional filters cover price and size bounds (minPrice, maxPrice, minSize, maxSize), a publication window (sinceDate: T last 24 hours for rent only, Y last 48 hours for sale only, W last week, M last month), an agency microsite short name, building type (exclusive for offices-only buildings or mixed for mixed use), layout (openPlan or withWalls), a bank-owned flag and boolean amenity flags for accessible, airConditioning, elevator, exterior, garage, hasPlan (floor plan), heating, hotWater and security. No live response was captured for this endpoint, so its response fields are unverified; it is expected to follow the paginated listing envelope seen on the new-homes listing of this API (an elementList array of properties plus total, totalPages and actualPage), which you should confirm with a first call.
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-offices API Response (JSON)
{} curl -X GET 'https://api.opendata-api.com/api/project/idealista/list-offices?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
- Office rent-per-square-metre benchmark by district for brokers and landlords, sorted with lowestpricem2 and bounded with minSize and maxSize.
- Startup headquarters finder that filters by size, price, elevator, air conditioning and accessibility before booking viewings.
- Amenity-driven office shortlist for facility managers that combines heating, hotWater, security and layout filters.
- Hybrid-work demand proxy that stores weekly count-only snapshots (maxItems=0) of office supply per district and charts the trend.
- Corporate relocation report comparing the available office stock and asking rents of Madrid, Barcelona and Valencia.
- Tenant-representation alert that polls rent listings with sinceDate=T and notifies when a matching office appears.
- Bank-owned office opportunity screen for investors that combines bankOffer with a maximum price and a minimum floor area.
Frequently asked questions
Which inputs are required?
Seven inputs are required: location (es, it or pt), locale, locationId, operation (sale or rent), order, numPage and maxItems. Everything else, including price and size bounds, amenity flags, buildingType, layout and sinceDate, is optional.
Which office-specific filters are available?
Boolean flags for accessible, airConditioning, elevator, exterior, garage, heating, hotWater, security and hasPlan (floor plan), plus buildingType, layout and bankOffer. All are optional, so you can combine only the ones you need.
What values do buildingType and layout accept?
buildingType accepts exclusive for buildings used exclusively for offices and mixed for mixed-use buildings; leave it blank for indifferent. layout accepts openPlan for open-plan offices and withWalls for offices divided by walls; leave it blank for indifferent.
What does the response look like?
No live response was captured for this endpoint, so its fields are not verified. The new-homes listing of this API returns an object with an elementList array and pagination fields (total, totalPages, actualPage, itemsPerPage); office results are expected to use the same envelope, but confirm that with a first call before relying on specific field names.
How do I get a valid locationId?
Use the suggestions endpoint of this API to resolve a place name to an ID and the sublocations endpoint to drill down into districts or neighbourhoods. The documented sample ID is 0-EU-ES-28-07-001-079, and the country of the ID should match the location parameter.
What do the sinceDate values mean?
Leave sinceDate empty for no recency filter. T means the last 24 hours and applies to rent operations only, Y means the last 48 hours and applies to sale operations only, W means the last week and M means the last month.
Why do some fields come prefilled with several values?
The documented defaults for locale, location, operation, order and maxItems list the accepted choices, for example sale,rent and 30,40,0. Replace them with a single value per request, such as operation=rent, order=relevance and maxItems=30.
How many offices can I request per page?
The maximum is 40 items per page and anything above is ignored. Setting maxItems to 0 returns only the item count for a fast response. Page through larger result sets by increasing numPage from 1.
How should I send the bankOffer filter?
The source describes bankOffer only as Bank-owned and types it as text rather than boolean, without listing accepted values. Try bankOffer=true on your target location and check that the result count drops before depending on it.