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

Office amenity flags Boolean switches for accessible, airConditioning, elevator, exterior, garage, heating, hotWater and security let you keep only offices that advertise the amenities a tenant requires.
Building type and layout filters buildingType separates buildings used exclusively for offices (exclusive) from mixed-use ones (mixed), and layout separates open-plan (openPlan) from wall-divided (withWalls) floors.
Floor-plan and bank-owned switches hasPlan keeps listings that include a floor plan, and bankOffer targets bank-owned offices, which helps shortlist well-documented or distressed-sale stock.
Sale and rent budget bounds minPrice, maxPrice, minSize and maxSize bound the search to the budget and floor area you need, applied to either the sale price or the rent depending on the operation.
Newly listed offices by day, week or month sinceDate narrows results to offices published in the last 24 hours (T, rent only), 48 hours (Y, sale only), week (W) or month (M), which suits tenant-rep alerting.
Per-square-metre and floor-count sorting The order parameter documents twelve values, including lowestpricem2, highestpricem2, biggest, smallest, highestfloors and lowestfloors, so benchmark and floor-level rankings need no client-side sorting.
Fast office stock counts Setting maxItems to 0 returns only the item count for a fast response, so you can size office supply across many locations before paging through full results.
Single-agency office portfolio The optional micrositeShortName parameter scopes the search to one agency microsite so you can audit the office stock a broker currently advertises.

Live API Demo

GET /api/project/idealista/list-offices

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-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'
📢
Need Help?
If you encounter API issues or need other API requirements, please contact us.
Contact Us

Use Cases

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.

Related operations

Guides

View Subscription Plans →